org.chiknrice.test

Class SpringifiedConcordionRunner

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

org.junit.runners.BlockJUnit4ClassRunner

org.concordion.integration.junit4.ConcordionRunner

org.chiknrice.test.SpringifiedConcordionRunner

All Implemented Interfaces:

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

public class SpringifiedConcordionRunner
extends org.concordion.integration.junit4.ConcordionRunner

An extension of ConcordionRunner which runs concordion tests in the context of a spring container. Most of the code were taken from SpringJUnit4ClassRunner which concerns initializing fixture instances using TestContextManager#prepareTestInstance and hooking the TestContextManager to JUnit's test phases.

Field Summary

Fields inherited from class org.concordion.integration.junit4.ConcordionRunner

concordionRunnerInterface

Constructor Summary

Constructors

Constructor and Description
SpringifiedConcordionRunner(java.lang.Class<?> clazz) Creates a BlockJUnit4ClassRunner to run klass

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	createTest() Delegate to the parent implementation for creating the test instance and then allow the TestContextManager to prepare the test instance before returning it.
protected org.springframework.test.context.TestContextManager	createTestContextManager(java.lang.Class<?> clazz) Create a new TestContextManager for the supplied test class.
org.junit.runner.Description	getDescription() Return a description suitable for an ignored test class if the test is disabled via @IfProfileValue at the class-level, and otherwise delegate to the parent implementation.
protected org.springframework.test.context.TestContextManager	getTestContextManager() Get the TestContextManager associated with this runner.
protected boolean	isTestMethodIgnored(org.junit.runners.model.FrameworkMethod frameworkMethod) Return true if @Ignore is present for the supplied test method or if the test method is disabled via @IfProfileValue.
protected org.junit.runners.model.Statement	methodBlock(org.junit.runners.model.FrameworkMethod frameworkMethod) Similar to how SpringJUnit4ClassRunner has augmented BlockJUnit4ClassRunner except the callbacks relating to timeout and repeat because FrameworkMethods in Concordion are not possible to be annotated.
void	run(org.junit.runner.notification.RunNotifier notifier) Check whether the test is enabled in the current execution environment.
protected void	runChild(org.junit.runners.model.FrameworkMethod frameworkMethod, org.junit.runner.notification.RunNotifier notifier) Perform the same logic as BlockJUnit4ClassRunner.runChild(FrameworkMethod, RunNotifier), except that tests are determined to be ignored by isTestMethodIgnored(FrameworkMethod).
protected org.junit.runners.model.Statement	withAfterClasses(org.junit.runners.model.Statement statement) Wrap the Statement returned by the parent implementation with a RunAfterTestClassCallbacks statement, thus preserving the default JUnit functionality while adding support for the Spring TestContext Framework.
protected org.junit.runners.model.Statement	withAfters(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement) Wrap the Statement returned by the parent implementation with a RunAfterTestMethodCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.
protected org.junit.runners.model.Statement	withAfterTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement) Wrap the supplied Statement with a RunAfterTestExecutionCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.
protected org.junit.runners.model.Statement	withBeforeClasses(org.junit.runners.model.Statement statement) Wrap the Statement returned by the parent implementation with a RunBeforeTestClassCallbacks statement, thus preserving the default JUnit functionality while adding support for the Spring TestContext Framework.
protected org.junit.runners.model.Statement	withBefores(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement) Wrap the Statement returned by the parent implementation with a RunBeforeTestMethodCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.
protected org.junit.runners.model.Statement	withBeforeTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement) Wrap the supplied Statement with a RunBeforeTestExecutionCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.

Methods inherited from class org.concordion.integration.junit4.ConcordionRunner

createFixture, describeChild, getChildren, getSpecificationLocator, validateInstanceMethods

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, computeTestMethods, getTestRules, isIgnored, methodInvoker, possiblyExpectingExceptions, rules, testName, validateConstructor, validateFields, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateTestMethods, validateZeroArgConstructor, withPotentialTimeout

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classBlock, classRules, createTestClass, filter, getName, getRunnerAnnotations, getTestClass, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods

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

SpringifiedConcordionRunner

public SpringifiedConcordionRunner(java.lang.Class<?> clazz)
                            throws org.junit.runners.model.InitializationError

Creates a BlockJUnit4ClassRunner to run klass

Parameters:

clazz - the fixture class

Throws:

org.junit.runners.model.InitializationError - if the test class is malformed.

Method Detail

createTestContextManager

protected org.springframework.test.context.TestContextManager createTestContextManager(java.lang.Class<?> clazz)

Create a new TestContextManager for the supplied test class.

Can be overridden by subclasses.

Parameters:

clazz - the test class to be managed

getTestContextManager

protected final org.springframework.test.context.TestContextManager getTestContextManager()

Get the TestContextManager associated with this runner.

getDescription

public org.junit.runner.Description getDescription()

Return a description suitable for an ignored test class if the test is disabled via @IfProfileValue at the class-level, and otherwise delegate to the parent implementation.

Specified by:

getDescription in interface org.junit.runner.Describable

Overrides:

getDescription in class org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

See Also:

ProfileValueUtils.isTestEnabledInThisEnvironment(Class)

run

public void run(org.junit.runner.notification.RunNotifier notifier)

Check 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 prepareTestInstance() methods in TestExecutionListeners.

Overrides:

run in class org.concordion.integration.junit4.ConcordionRunner

See Also:

ProfileValueUtils.isTestEnabledInThisEnvironment(Class), IfProfileValue, TestExecutionListener

withBeforeClasses

protected org.junit.runners.model.Statement withBeforeClasses(org.junit.runners.model.Statement statement)

Wrap the Statement returned by the parent implementation with a RunBeforeTestClassCallbacks statement, thus preserving the default JUnit functionality while adding support for the Spring TestContext Framework.

Overrides:

withBeforeClasses in class org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

See Also:

RunBeforeTestClassCallbacks

withAfterClasses

protected org.junit.runners.model.Statement withAfterClasses(org.junit.runners.model.Statement statement)

Wrap the Statement returned by the parent implementation with a RunAfterTestClassCallbacks statement, thus preserving the default JUnit functionality while adding support for the Spring TestContext Framework.

Overrides:

withAfterClasses in class org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

See Also:

RunAfterTestClassCallbacks

createTest

protected java.lang.Object createTest()
                               throws java.lang.Exception

Delegate to the parent implementation for creating the test instance and then allow the TestContextManager to prepare the test instance before returning it.

Overrides:

createTest in class org.concordion.integration.junit4.ConcordionRunner

Throws:

java.lang.Exception

See Also:

TestContextManager.prepareTestInstance(java.lang.Object)

runChild

protected void runChild(org.junit.runners.model.FrameworkMethod frameworkMethod,
                        org.junit.runner.notification.RunNotifier notifier)

Perform the same logic as BlockJUnit4ClassRunner.runChild(FrameworkMethod, RunNotifier), except that tests are determined to be ignored by isTestMethodIgnored(FrameworkMethod).

Overrides:

runChild in class org.concordion.integration.junit4.ConcordionRunner

methodBlock

protected org.junit.runners.model.Statement methodBlock(org.junit.runners.model.FrameworkMethod frameworkMethod)

Similar to how SpringJUnit4ClassRunner has augmented BlockJUnit4ClassRunner except the callbacks relating to timeout and repeat because FrameworkMethods in Concordion are not possible to be annotated.

Overrides:

methodBlock in class org.junit.runners.BlockJUnit4ClassRunner

See Also:

BlockJUnit4ClassRunner.methodInvoker(FrameworkMethod, Object), withBeforeTestExecutionCallbacks(FrameworkMethod, Object, Statement), withAfterTestExecutionCallbacks(FrameworkMethod, Object, Statement), BlockJUnit4ClassRunner.possiblyExpectingExceptions(FrameworkMethod, Object, Statement), withBefores(FrameworkMethod, Object, Statement), withAfters(FrameworkMethod, Object, Statement), withRulesReflectively(FrameworkMethod, Object, Statement)

isTestMethodIgnored

protected boolean isTestMethodIgnored(org.junit.runners.model.FrameworkMethod frameworkMethod)

Return true if @Ignore is present for the supplied test method or if the test method is disabled via @IfProfileValue.

See Also:

ProfileValueUtils.isTestEnabledInThisEnvironment(Method, Class)

withBeforeTestExecutionCallbacks

protected org.junit.runners.model.Statement withBeforeTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                             java.lang.Object testInstance,
                                                                             org.junit.runners.model.Statement statement)

Wrap the supplied Statement with a RunBeforeTestExecutionCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.

See Also:

RunBeforeTestExecutionCallbacks

withAfterTestExecutionCallbacks

protected org.junit.runners.model.Statement withAfterTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                            java.lang.Object testInstance,
                                                                            org.junit.runners.model.Statement statement)

Wrap the supplied Statement with a RunAfterTestExecutionCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.

See Also:

RunAfterTestExecutionCallbacks

withBefores

protected org.junit.runners.model.Statement withBefores(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                        java.lang.Object testInstance,
                                                        org.junit.runners.model.Statement statement)

Wrap the Statement returned by the parent implementation with a RunBeforeTestMethodCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.

Overrides:

withBefores in class org.junit.runners.BlockJUnit4ClassRunner

See Also:

RunBeforeTestMethodCallbacks

withAfters

protected org.junit.runners.model.Statement withAfters(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                       java.lang.Object testInstance,
                                                       org.junit.runners.model.Statement statement)

Wrap the Statement returned by the parent implementation with a RunAfterTestMethodCallbacks statement, thus preserving the default functionality while adding support for the Spring TestContext Framework.

Overrides:

withAfters in class org.junit.runners.BlockJUnit4ClassRunner

See Also:

RunAfterTestMethodCallbacks