org.xenei.junit.contract

Class ContractSuite

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<org.junit.runner.Runner>

org.xenei.junit.contract.ContractSuite

All Implemented Interfaces:

org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Sortable

public class ContractSuite
extends org.junit.runners.ParentRunner<org.junit.runner.Runner>

Class that runs the Contract annotated tests. Used with @RunWith( ContractSuite.class ) this class scans the classes on the class path to find all the test implementations that should be run by this test suite.

Tests annotated with @RunWith( ContractSuite.class ) must:

1. Have a ContractImpl annotation specifying the implementation being tested
2. Include a @Contract.Inject annotated getter that returns an IProducer where "x" is the class specified in the ContractImpl

The ContractSuite will:

1. Instantiate the class annotated with @RunWith( ContractSuite.class )
2. Find all the Contract tests for the class specified by ContractImpl and add them to the test suite
3. execute all of the @ContractTest annotated tests

NOTE:If the class annotated with @RunWith( ContractSuite.class ) implements Dynamic the above requirements change. See Dynamic for more information.

Constructor Summary

Constructors

Constructor and Description
ContractSuite(Class<?> cls, org.junit.runners.model.RunnerBuilder builder) Called reflectively on classes annotated with @RunWith(Suite.class)

Method Summary

Methods

Modifier and Type	Method and Description
protected org.junit.runner.Description	describeChild(org.junit.runner.Runner child)
protected List<org.junit.runner.Runner>	getChildren()
protected void	runChild(org.junit.runner.Runner child, org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classBlock, classRules, collectInitializationErrors, filter, getDescription, getName, getRunnerAnnotations, getTestClass, run, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods, withAfterClasses, withBeforeClasses

Methods inherited from class org.junit.runner.Runner

testCount

Methods inherited from class java.lang.Object

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

Constructor Detail

ContractSuite

public ContractSuite(Class<?> cls,
             org.junit.runners.model.RunnerBuilder builder)
              throws Throwable

Called reflectively on classes annotated with @RunWith(Suite.class)

Parameters:

cls - the root class

builder - builds runners for classes in the suite

Throws:

Throwable

Method Detail

getChildren

protected List<org.junit.runner.Runner> getChildren()

Specified by:

getChildren in class org.junit.runners.ParentRunner<org.junit.runner.Runner>

describeChild

protected org.junit.runner.Description describeChild(org.junit.runner.Runner child)

Specified by:

describeChild in class org.junit.runners.ParentRunner<org.junit.runner.Runner>

runChild

protected void runChild(org.junit.runner.Runner child,
            org.junit.runner.notification.RunNotifier notifier)

Specified by:

runChild in class org.junit.runners.ParentRunner<org.junit.runner.Runner>