Java Doc for InterfaceTestCase.java in  » Test-Coverage » GroboUtils » net » sourceforge » groboutils » junit » v1 » iftc » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Subclasses that want to use the InterfaceTestSuite helper class will need to specify a constructor similar to:

 public MyClassTest( String name, ImplFactory f )
 {
 super( name, MyClass.class, f );
 }
 

As of October 30, 2002, the InterfaceTestCase has a slightly different behavior when the factory instance is an implementation of ICxFactory. In this scenario, it will store all the instantiated objects in the stack, and each instantiated object will be passed to the ICxFactory instance during the test's normal tearDown. If the ICxFactory throws an exception during any of the tearDown calls, they will be stored up and reported in a single exception. Therefore, if you want this functionality, then you will need to ensure that your tearDown() method calls the super tearDown().

Even though JUnit 3.8+ allows for a TestCase to have a default (no-arg) constructor, the InterfaceTestCase does not support this. The benefits simply aren't there for interface tests: they will still have to create a constructor which passes InterfaceTestCase which class is being tested. Since a constructor is required anyway, the little extra effort to add two arguments to the constructor and call to the super is trivial compared to not needing the constructor at all.

As of 08-Dec-2002, the returned name of the test can include the class's name, without the package, to improve traceability. This will allow the user to be able to see in which specific test class an error occured through the Ant JUnit report mechanism. This is enabled by default, but can be disabled by setting the Java system-wide property "net.sourceforge.groboutils.junit.v1.iftc.InterfaceTestCase.no-classname" to true, which is dynamically checked at runtime at each call.
author:
   Matt Albrecht groboclown@users.sourceforge.net
version:
   $Date: 2003/02/10 22:52:20 $
since:
   March 2, 2002
See Also:   ImplFactory
See Also:   ICxFactory
See Also:   InterfaceTestSuite

This method makes an assertion that the factory's created object is not null, so that the system state is ensured. Therefore, this method will never return null. Also, this method asserts that the created object is of the correct type (as passed in through the constructor), so that it can be correctly cast without errors. the object created by the factory.