Class BulkTest

A TestCase that can define both simple and bulk test methods.

A simple test method is the type of test traditionally supplied by by TestCase. To define a simple test, create a public no-argument method whose name starts with "test". You can specify the the name of simple test in the constructor of BulkTest; a subsequent call to TestCase.run will run that simple test.

A bulk test method, on the other hand, returns a new instance of BulkTest, which can itself define new simple and bulk test methods. By using the makeSuite(Class) method, you can automatically create a hierarchal suite of tests and child bulk tests.

For instance, consider the following two classes:

  public class TestSet extends BulkTest {

      private Set set;

      public TestSet(Set set) {
          this.set = set;
      }

      public void testContains() {
          boolean r = set.contains(set.iterator().next()));
          assertTrue("Set should contain first element, r);
      }

      public void testClear() {
          set.clear();
          assertTrue("Set should be empty after clear", set.isEmpty());
      }
  }


  public class TestHashMap extends BulkTest {

      private Map makeFullMap() {
          HashMap result = new HashMap();
          result.put("1", "One");
          result.put("2", "Two");
          return result;
      }

      public void testClear() {
          Map map = makeFullMap();
          map.clear();
          assertTrue("Map empty after clear", map.isEmpty());
      }

      public BulkTest bulkTestKeySet() {
          return new TestSet(makeFullMap().keySet());
      }

      public BulkTest bulkTestEntrySet() {
          return new TestSet(makeFullMap().entrySet());
      }
  }
  

In the above examples, TestSet defines two simple test methods and no bulk test methods; TestHashMap defines one simple test method and two bulk test methods. When makeSuite(TestHashMap.class).run is executed, five simple test methods will be run, in this order:

1. TestHashMap.testClear()
2. TestHashMap.bulkTestKeySet().testContains();
3. TestHashMap.bulkTestKeySet().testClear();
4. TestHashMap.bulkTestEntrySet().testContains();
5. TestHashMap.bulkTestEntrySet().testClear();

In the graphical junit test runners, the tests would be displayed in the following tree:

• TestHashMap

• testClear
• bulkTestKeySet
• testContains
• testClear

bulkTestEntrySet

• testContains
• testClear

A subclass can override a superclass's bulk test by returning null from the bulk test method. If you only want to override specific simple tests within a bulk test, use the ignoredTests() method.

Note that if you want to use the bulk test methods, you must define your suite() method to use makeSuite(Class). The ordinary TestSuite constructor doesn't know how to interpret bulk test methods.

public BulkTest(String name)

public Object clone()

public String[] ignoredTests()

public static TestSuite makeSuite(Class c)

public String toString()