junit.extensions.proxy

Class ProxyTestSuite

java.lang.Object

junit.framework.TestSuite

junit.extensions.proxy.ProxyTestSuite

All Implemented Interfaces:

junit.framework.Test

public class ProxyTestSuite
extends junit.framework.TestSuite

A simple wrapper around TestSuite that permits the caller to specify the delegate Test for either directly or recursively contained IProxyTests added to a ProxyTestSuite. There are three cases for junit:

1. An instantiated test. This is an instance of some class that extends TestCase. If the class implements IProxyTest then the delegate will be set on the test instance and will be available when that test runs.
2. A test case. This is a class named to TestSuite.addTestSuite(java.lang.Class). That method scans the test case class and generates an instantiated test for each conforming test method identified in the test case. The delegate is then set per above.
3. A test suite. The delegate declared in a ProxyTestSuite constructor will be flowed down to each test added either directly or indirectly to that ProxyTestSuite. The various constructors all invoke this method to flow down the delegate. In addition, the addTest(Test) and addTestSuite(Class) methods also invoke this method to flow down the delegate to instantiated tests that implement IProxyTest.

The only case when flow down does not occur is when you have created a standard test suite, addeded it to a proxy test suite, and then you add additional tests to the standard test suite. There is no event notification model in junit and this action is not noticed by the ProxyTestSuite.

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.apache.log4j.Logger	log The Logger is named for this class.

Constructor Summary

Constructors

Constructor and Description
ProxyTestSuite(junit.framework.Test delegate) Creates an empty unnamed test suite.
ProxyTestSuite(junit.framework.Test delegate, Class testClass) Creates an unnamed test suite and populates it with test instances identified by scanning the testClass .
ProxyTestSuite(junit.framework.Test delegate, Class testClass, String name) Creates a named test suite and populates it with test instances identified by scanning the testClass .
ProxyTestSuite(junit.framework.Test delegate, String name) Creates an empty named test suite.

Method Summary

Methods

Modifier and Type	Method and Description
void	addTest(junit.framework.Test test) If the suite is not a ProxyTestSuite, then the tests in the suite are recursively enumerated and a proxy test suite is created with the same name and tests.
void	addTestSuite(Class testClass) We override the implementation of TestSuite.addTestSuite( Class theClass ) to wrap the testClass in another instance of this ProxyTestSuite class using the same delegate that was provided to our constructor.
protected void	flowDown(junit.framework.Test t)
protected void	flowDown(junit.framework.TestSuite suite) Sets the delegate on each instantiated Test that implements IProxyTest.
junit.framework.Test	getDelegate() Returns the delegate supplied to the constructor.

Methods inherited from class junit.framework.TestSuite

countTestCases, createTest, getName, getTestConstructor, run, runTest, setName, testAt, testCount, tests, toString, warning

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

log

protected static final org.apache.log4j.Logger log

The Logger is named for this class.

Constructor Detail

ProxyTestSuite

public ProxyTestSuite(junit.framework.Test delegate)

Creates an empty unnamed test suite. The delegate will be assigned to tests added to this test suite that implement IProxyTest.

Parameters:

delegate - The delegate (non-null).

ProxyTestSuite

public ProxyTestSuite(junit.framework.Test delegate,
              Class testClass,
              String name)

Creates a named test suite and populates it with test instances identified by scanning the testClass . The delegate will be assigned to tests added to this test suite that implement IProxyTest, including those created from testClass .

Parameters:

delegate - The delegate (non-null).

testClass - A class containing one or more tests.

name - The name of the test suite (optional).

ProxyTestSuite

public ProxyTestSuite(junit.framework.Test delegate,
              Class testClass)

Creates an unnamed test suite and populates it with test instances identified by scanning the testClass . The delegate will be assigned to tests added to this test suite that implement IProxyTest, including those created from testClass .

Parameters:

delegate - The delegate (non-null).

testClass - A class containing one or more tests.

ProxyTestSuite

public ProxyTestSuite(junit.framework.Test delegate,
              String name)

Creates an empty named test suite. The declared will be assigned to tests added to this test suite that implement IProxyTest.

Parameters:

delegate - The delegate (non-null).

name - The test suite name (optional).

Method Detail

getDelegate

public junit.framework.Test getDelegate()

Returns the delegate supplied to the constructor.

addTestSuite

public void addTestSuite(Class testClass)

We override the implementation of TestSuite.addTestSuite( Class theClass ) to wrap the testClass in another instance of this ProxyTestSuite class using the same delegate that was provided to our constructor. This causes the delegation to be inherited by any recursively contained testClass which implements IProxyTest.

Overrides:

addTestSuite in class junit.framework.TestSuite

addTest

public void addTest(junit.framework.Test test)

If the suite is not a ProxyTestSuite, then the tests in the suite are recursively enumerated and a proxy test suite is created with the same name and tests. This ensures that the common delegate flows down through all tests even when using the traditional static Test suite() {...} construction.

Overrides:

addTest in class junit.framework.TestSuite

Parameters:

test - A test.

flowDown

protected void flowDown(junit.framework.Test t)

flowDown

protected void flowDown(junit.framework.TestSuite suite)

Sets the delegate on each instantiated Test that implements IProxyTest.