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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
<h2>Summary of Changes in version 4.7</h2>
<h3>Rules</h3>
<ul>
<li><p>Rules allow very flexible addition or redefinition of the behavior
of each test method in a test class. Testers can reuse or extend one of the
provided Rules below, or write their own.</p>
<p>For more on this feature, see http://www.threeriversinstitute.org/blog/?p=155</p></li>
<li><p>The TemporaryFolder Rule allows creation of files and folders
that are guaranteed to be deleted when the test method finishes
(whether it passes or fails):</p>
<p>public static class HasTempFolder {
@Rule
public TemporaryFolder folder= new TemporaryFolder();</p>
<pre><code>@Test
public void testUsingTempFolder() throws IOException {
File createdFile= folder.newFile("myfile.txt");
File createdFolder= folder.newFolder("subfolder");
// ...
}
</code></pre>
<p>}</p></li>
<li><p>ExternalResource is a base class for Rules (like TemporaryFolder)
that set up an external resource before a test (a file, socket, server,
database connection, etc.), and guarantee to tear it down afterward:</p>
<p>public static class UsesExternalResource {
Server myServer = new Server();</p>
<pre><code>@Rule public ExternalResource resource = new ExternalResource() {
@Override
protected void before() throws Throwable {
myServer.connect();
};
<pre><code>@Override
protected void after() {
myServer.disconnect();
};
</code></pre>
};
@Test public void testFoo() {
new Client().run(myServer);
}
</code></pre>
<p>}</p></li>
<li><p>The ErrorCollector Rule allows execution of a test to continue
after the first problem is found (for example, to collect <em>all</em> the
incorrect rows in a table, and report them all at once):</p>
<p>public static class UsesErrorCollectorTwice {
@Rule
public ErrorCollector collector= new ErrorCollector();</p>
<pre><code>@Test public void example() {
collector.addError(new Throwable("first thing went wrong"));
collector.addError(new Throwable("second thing went wrong"));
}
</code></pre>
<p>}</p></li>
<li><p>Verifier is a base class for Rules like ErrorCollector, which
can turn otherwise passing test methods into failing tests if a verification
check is failed</p>
<p>public static class ErrorLogVerifier() {
private ErrorLog errorLog = new ErrorLog();</p>
<p>@Rule
public MethodRule verifier = new Verifier() {
@Override public void verify() {
assertTrue(errorLog.isEmpty());
}
}</p>
<p>@Test public void testThatMightWriteErrorLog() {
// ...
}
}</p></li>
<li><p>TestWatchman is a base class for Rules that take note
of the testing action, without modifying it.
For example, this class will keep a log of each passing and failing
test:</p>
<p>public static class WatchmanTest {
private static String watchedLog;</p>
<pre><code>@Rule
public MethodRule watchman= new TestWatchman() {
@Override
public void failed(Throwable e, FrameworkMethod method) {
watchedLog+= method.getName() + " "
+ e.getClass().getSimpleName() + "\n";
}
<pre><code>@Override
public void succeeded(FrameworkMethod method) {
watchedLog+= method.getName() + " " + "success!\n";
}
</code></pre>
};
@Test
public void fails() {
fail();
}
@Test
public void succeeds() {
}
</code></pre>
<p>}</p></li>
<li><p>The TestName Rule makes the current test name available inside test methods:</p>
<p>public class NameRuleTest {
@Rule public TestName name = new TestName();</p>
<pre><code>@Test public void testA() {
assertEquals("testA", name.getMethodName());
}
@Test public void testB() {
assertEquals("testB", name.getMethodName());
}
</code></pre>
<p>}</p></li>
<li><p>The Timeout Rule applies the same timeout to all test methods in a class:</p>
<p>public static class HasGlobalTimeout {
public static String log;</p>
<pre><code>@Rule public MethodRule globalTimeout = new Timeout(20);
@Test public void testInfiniteLoop1() {
log+= "ran1";
for(;;) {}
}
@Test public void testInfiniteLoop2() {
log+= "ran2";
for(;;) {}
}
</code></pre>
<p>}</p></li>
<li><p>The ExpectedException Rule allows in-test specification
of expected exception types and messages:</p>
<p>public static class HasExpectedException {
@Rule
public ExpectedException thrown= ExpectedException.none();</p>
<pre><code>@Test
public void throwsNothing() {
}
@Test
public void throwsNullPointerException() {
thrown.expect(NullPointerException.class);
throw new NullPointerException();
}
@Test
public void throwsNullPointerExceptionWithMessage() {
thrown.expect(NullPointerException.class);
thrown.expectMessage("happened?");
thrown.expectMessage(startsWith("What"));
throw new NullPointerException("What happened?");
}
</code></pre>
<p>}</p></li>
</ul>
<h3>Timeouts</h3>
<ul>
<li>Tests that time out now show the stack trace of the test thread.</li>
</ul>
<h3>Matchers</h3>
<ul>
<li>Due to typing incompatibilities, JUnit is still including the 1.1 release
of hamcrest. This is not a change from 4.6, but is a change from
pre-beta releases of 4.7. Due to this incompatibility, tests using
Hamcrest 1.2 must still use the MatcherAssert.assertThat method from
Hamcrest, not Assert.assertThat from JUnit.</li>
</ul>
<h3>Docs</h3>
<ul>
<li>Javadocs now link to online JDK javadocs (bug 2090230)</li>
<li>Parameterized runner javadocs improved (bug 2186792)</li>
<li>Fixed Javadoc code sample for AfterClass (2126279)</li>
<li>Fixed Javadoc for assertArraysEqual(float[], float[])</li>
</ul>
<h3>Bug fixes</h3>
<ul>
<li>Fixed: BaseTestRunner.getTest() requires class to extend TestCase (1812200)</li>
<li>Fixed: Suite does not allow for inheritance in annotations (2783118)</li>
<li>Fixed: ParallelComputer skipped tests that took longer than 2 seconds</li>
</ul>
|
