org.springframework.test.context.junit4.rules

Class SpringClassRule

java.lang.Object

org.springframework.test.context.junit4.rules.SpringClassRule

public class SpringClassRule
extends java.lang.Object

SpringClassRule is a custom JUnit TestRule that supports class-level features of the Spring TestContext Framework in standard JUnit tests by means of the TestContextManager and associated support classes and annotations.

In contrast to the SpringJUnit4ClassRunner, Spring's rule-based JUnit support has the advantage that it is independent of any Runner and can therefore be combined with existing alternative runners like JUnit's Parameterized or third-party runners such as the MockitoJUnitRunner.

In order to achieve the same functionality as the SpringJUnit4ClassRunner, however, a SpringClassRule must be combined with a SpringMethodRule, since SpringClassRule only supports the class-level features of the SpringJUnit4ClassRunner.

Example Usage

 public class ExampleSpringIntegrationTest {

    @ClassRule
    public static final SpringClassRule SPRING_CLASS_RULE = new SpringClassRule();

    @Rule
    public final SpringMethodRule springMethodRule = new SpringMethodRule();

    // ...
 }

The following list constitutes all annotations currently supported directly or indirectly by SpringClassRule. (Note that additional annotations may be supported by various TestExecutionListener or TestContextBootstrapper implementations.)

• @ProfileValueSourceConfiguration
• @IfProfileValue

NOTE: This class requires JUnit 4.9 or higher.

Since:

4.2

Author:

Sam Brannen, Philippe Marschall

See Also:

apply(Statement, Description), SpringMethodRule, TestContextManager, SpringJUnit4ClassRunner

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	SpringClassRule.TestContextManagerCacheEvictor

Field Summary

Fields

Modifier and Type	Field and Description
private static Log	logger
private static java.lang.String	MULTIPLE_FAILURE_EXCEPTION_CLASS_NAME
private static java.util.Map<java.lang.Class<?>,TestContextManager>	testContextManagerCache Cache of TestContextManagers keyed by test class.

Constructor Summary

Constructors

Constructor and Description
SpringClassRule()

Method Summary

Modifier and Type	Method and Description
Statement	apply(Statement base, Description description) Apply class-level features of the Spring TestContext Framework to the supplied base statement.
(package private) static TestContextManager	getTestContextManager(java.lang.Class<?> testClass) Get the TestContextManager associated with the supplied test class.
private static void	validateSpringMethodRuleConfiguration(java.lang.Class<?> testClass) Throw an IllegalStateException if the supplied testClass does not declare a public SpringMethodRule field that is annotated with @Rule.
private Statement	withAfterTestClassCallbacks(Statement statement, TestContextManager testContextManager) Wrap the supplied statement with a RunAfterTestClassCallbacks statement.
private Statement	withBeforeTestClassCallbacks(Statement statement, TestContextManager testContextManager) Wrap the supplied statement with a RunBeforeTestClassCallbacks statement.
private Statement	withProfileValueCheck(Statement statement, java.lang.Class<?> testClass) Wrap the supplied statement with a ProfileValueChecker statement.
private Statement	withTestContextManagerCacheEviction(Statement statement, java.lang.Class<?> testClass) Wrap the supplied statement with a TestContextManagerCacheEvictor statement.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

testContextManagerCache

private static final java.util.Map<java.lang.Class<?>,TestContextManager> testContextManagerCache

Cache of TestContextManagers keyed by test class.

MULTIPLE_FAILURE_EXCEPTION_CLASS_NAME

private static final java.lang.String MULTIPLE_FAILURE_EXCEPTION_CLASS_NAME

See Also:

Constant Field Values

Constructor Detail

SpringClassRule

public SpringClassRule()

Method Detail

apply

public Statement apply(Statement base,
                       Description description)

Apply class-level features of the Spring TestContext Framework to the supplied base statement.

Specifically, this method retrieves the TestContextManager used by this rule and its associated SpringMethodRule and invokes the beforeTestClass() and afterTestClass() methods on the TestContextManager.

In addition, this method checks whether the test is enabled in the current execution environment. This prevents classes with a non-matching @IfProfileValue annotation from running altogether, even skipping the execution of beforeTestClass() methods in TestExecutionListeners.

Parameters:

base - the base Statement that this rule should be applied to

description - a Description of the current test execution

Returns:

a statement that wraps the supplied base with class-level features of the Spring TestContext Framework

See Also:

getTestContextManager(java.lang.Class<?>), withBeforeTestClassCallbacks(Statement, org.springframework.test.context.TestContextManager), withAfterTestClassCallbacks(Statement, org.springframework.test.context.TestContextManager), withProfileValueCheck(Statement, java.lang.Class<?>), withTestContextManagerCacheEviction(Statement, java.lang.Class<?>)

withBeforeTestClassCallbacks

private Statement withBeforeTestClassCallbacks(Statement statement,
                                               TestContextManager testContextManager)

Wrap the supplied statement with a RunBeforeTestClassCallbacks statement.

See Also:

RunBeforeTestClassCallbacks

withAfterTestClassCallbacks

private Statement withAfterTestClassCallbacks(Statement statement,
                                              TestContextManager testContextManager)

Wrap the supplied statement with a RunAfterTestClassCallbacks statement.

See Also:

RunAfterTestClassCallbacks

withProfileValueCheck

private Statement withProfileValueCheck(Statement statement,
                                        java.lang.Class<?> testClass)

Wrap the supplied statement with a ProfileValueChecker statement.

See Also:

ProfileValueChecker

withTestContextManagerCacheEviction

private Statement withTestContextManagerCacheEviction(Statement statement,
                                                      java.lang.Class<?> testClass)

Wrap the supplied statement with a TestContextManagerCacheEvictor statement.

See Also:

SpringClassRule.TestContextManagerCacheEvictor

validateSpringMethodRuleConfiguration

private static void validateSpringMethodRuleConfiguration(java.lang.Class<?> testClass)

Throw an IllegalStateException if the supplied testClass does not declare a public SpringMethodRule field that is annotated with @Rule.

getTestContextManager

static TestContextManager getTestContextManager(java.lang.Class<?> testClass)

Get the TestContextManager associated with the supplied test class.

Parameters:

testClass - the test class to be managed; never null