1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.tools.ant.taskdefs.optional.junit;
import java.io.IOException;
import java.io.OutputStream;
import org.apache.tools.ant.AntClassLoader;
import org.apache.tools.ant.types.Permissions;
/**
* Handles the portions of {@link JUnitTask} which need to directly access
* actual JUnit classes, so that junit.jar need not be on Ant's startup classpath.
* Neither JUnitTask.java nor JUnitTaskMirror.java nor their transitive static
* deps may import any junit.** classes!
* Specifically, need to not refer to
* - JUnitResultFormatter or its subclasses
* - JUnitVersionHelper
* - JUnitTestRunner
* Cf. JUnitTask.SplitLoader#isSplit(String)
* Public only to permit access from classes in this package; do not use directly.
*
* @since 1.7
* @see "bug #38799"
*/
public interface JUnitTaskMirror {
/**
* Add the formatter to be called when the jvm exits before
* the test suite finishes.
* @param test the test.
* @param formatter the formatter to use.
* @param out the output stream to use.
* @param message the message to write out.
* @param testCase the name of the test.
*/
void addVmExit(JUnitTest test, JUnitResultFormatterMirror formatter,
OutputStream out, String message, String testCase);
/**
* Create a new test runner for a test.
* @param test the test to run.
* @param methods names of the test methods to be run.
* @param haltOnError if true halt the tests if an error occurs.
* @param filterTrace if true filter the stack traces.
* @param haltOnFailure if true halt the test if a failure occurs.
* @param showOutput if true show output.
* @param logTestListenerEvents if true log test listener events.
* @param classLoader the classloader to use to create the runner.
* @return the test runner.
*/
JUnitTestRunnerMirror newJUnitTestRunner(JUnitTest test, String[] methods, boolean haltOnError,
boolean filterTrace, boolean haltOnFailure, boolean showOutput,
boolean logTestListenerEvents, AntClassLoader classLoader);
/**
* Create a summary result formatter.
* @return the created formatter.
*/
SummaryJUnitResultFormatterMirror newSummaryJUnitResultFormatter();
/** The interface that JUnitResultFormatter extends. */
public interface JUnitResultFormatterMirror {
/**
* Set the output stream.
* @param outputStream the stream to use.
*/
void setOutput(OutputStream outputStream);
}
/** The interface that SummaryJUnitResultFormatter extends. */
public interface SummaryJUnitResultFormatterMirror
extends JUnitResultFormatterMirror {
/**
* Set where standard out and standard error should be included.
* @param value if true include the outputs in the summary.
*/
void setWithOutAndErr(boolean value);
}
/** Interface that test runners implement. */
public interface JUnitTestRunnerMirror {
/**
* Used in formatter arguments as a placeholder for the basename
* of the output file (which gets replaced by a test specific
* output file name later).
*
* @since Ant 1.6.3
*/
String IGNORED_FILE_NAME = "IGNORETHIS";
/**
* No problems with this test.
*/
int SUCCESS = 0;
/**
* Some tests failed.
*/
int FAILURES = 1;
/**
* An error occurred.
*/
int ERRORS = 2;
/**
* Permissions for the test run.
* @param perm the permissions to use.
*/
void setPermissions(Permissions perm);
/** Run the test. */
void run();
/**
* Add a formatter to the test.
* @param formatter the formatter to use.
*/
void addFormatter(JUnitResultFormatterMirror formatter);
/**
* Returns what System.exit() would return in the standalone version.
*
* @return 2 if errors occurred, 1 if tests failed else 0.
*/
int getRetCode();
/**
* Handle output sent to System.err.
*
* @param output coming from System.err
*/
void handleErrorFlush(String output);
/**
* Handle output sent to System.err.
*
* @param output output for System.err
*/
void handleErrorOutput(String output);
/**
* Handle output sent to System.out.
*
* @param output output for System.out.
*/
void handleOutput(String output);
/**
* Handle an input request.
*
* @param buffer the buffer into which data is to be read.
* @param offset the offset into the buffer at which data is stored.
* @param length the amount of data to read.
*
* @return the number of bytes read.
*
* @exception IOException if the data cannot be read.
*/
int handleInput(byte[] buffer, int offset, int length) throws IOException;
/**
* Handle output sent to System.out.
*
* @param output output for System.out.
*/
void handleFlush(String output);
}
}
|
