org.xenei.junit.contract

Annotation Type ContractImpl

@Target(value=TYPE)
 @Retention(value=RUNTIME)
public @interface ContractImpl

Annotation to declare the type the ContractSuite is testing.

For example

 
 @RunWith( ContractSuite.class )
 @ContractImpl( FooImpl.class ) public class Foo_Test {...}
 

Declares FooImpl as the implementation that the contract suite should be built for.

The value of the annotation (FooImpl.class) in the above example) defines the class that will be scanned for interfaces. The set of contract tests are then scanned looking for tests for those interfaces. Tests from all matching Contract tests are then added to the current test class.

NOTE: In some cases only the interface is known, not the implementation. In these cases a testing interface may be created and that class used in the ContractImpl annotation. For example assume that you want to test an interface A. create an interface: interface ATester extends A{}; and in the ContractImpl annotation use ATester.class

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.Class<?>	value The Implementation class that should be scanned for interfaces that have Contract tests defined.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.Class<?>[]	ignore The list of implementations to skip.
java.lang.Class<?>[]	skip The list of interface classes for which tests should be skipped.

Element Detail

value

public abstract java.lang.Class<?> value

The Implementation class that should be scanned for interfaces that have Contract tests defined.

Returns:

The class the implementation class.

skip

public abstract java.lang.Class<?>[] skip

The list of interface classes for which tests should be skipped. This list are interfaces that the class under tests implements but that should not be tested.

Returns:

The interfaces to skip testing.

Default:

{}

ignore

public abstract java.lang.Class<?>[] ignore

The list of implementations to skip. This list is a list of test implementations that apply to the class under test but that should not be executed. This is often because the tests are not applicable to this implementation.

Returns:

the list of interface test implementations to skip.

Default:

{}