JarCasting
Nested tests for JUnit
Add the following dependencies to your pom.xml:
<dependency>
<groupId>net.avh4.test</groupId>
<artifactId>junit-nested</artifactId>
<version>1.0.1</version>
<scope>test</scope>
</dependency>
Now write nested tests as shown below. Your test class can have non-static inner classes, each of which may contain @Test methods. The inner classes themselves can also have inner classes, nested to any depth (though you may want to restructure your tests if you find yourself needing more than two levels). @Before and @After blocks at all levels will be executed as you would expect (for example, Outer-Before, Inner-Before, Test, Inner-After, Outer-After). @Rules at all levels will also be applied in the appropriate order.
import net.avh4.test.junit.Nested;
@RunWith(Nested.class)
public class QueueTest {
private Queue<String> subject;
@Before
public void setUp() {
subject = new Queue<String>();
}
@Test
public void push_shouldIncreaseCount() {
subject.push("Item");
assertThat(subject.count(), is(1));
}
public class WhenEmpty {
@Test(expected = NoSuchElementException.class)
public void pop_shouldThrow() {
subject.pop();
}
}
public class WithOneItem {
@Before
public void setUp() {
subject.push("First");
}
@Test
public void pop_shouldReturnTheItem() {
assertThat(subject.pop(), is("First"));
}
}
}
What works
@Beforemethods at all levels@Aftermethods at all levels@Rulefields at all levels@Test(expected)for expected exceptions@Test(timeout)for test timeouts@Ignorefor pending tests
What doesn't work (yet)
@BeforeClassmethods for outer classes@AfterClassmethods for outer classes@Rulemethods (however, @Rule fields do work) for outer classes@RunWithon inner classes
License
junit-nested is licensed under the Eclipse Public License version 1.0. If you have need of a different license, please contact me.
References
Below are some resources I investigated before writing junit-nested, which offer some different approaches to behavioral testing in Java (and other languages).
- http://jdave.org/ - too different from JUnit
- http://www.malethan.com/article/rspec_for_java_jspec.html - blue sky
- http://igorpolevoy.blogspot.com/2011/04/what-good-for-ruby-is-good-for-java.html - nothing special
- http://www.easyb.org/specexmpls.html - requires groovy, plus external runner
- http://www.videosurf.com/video/beyond-test-driven-development-behaviour-driven-development-103819366?vlt - to watch
- https://github.com/thoughtbot/shoulda-context - ruby
- http://rspec.info/ - ruby