org.spincast.testing.utils

Class OneInstancePerClassJUnitRunner

java.lang.Object

org.junit.runner.Runner

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

org.junit.runners.BlockJUnit4ClassRunner

org.spincast.testing.utils.OneInstancePerClassJUnitRunner

All Implemented Interfaces:

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

public class OneInstancePerClassJUnitRunner
extends org.junit.runners.BlockJUnit4ClassRunner

A JUnit Runner that will create a single instance *per class*. By default, JUnit creates a new instance of the Test class for every @Test.

If the test class implements IBeforeAfterClassMethodsProvider, "beforeClass()" and "afterClass()" will be called on it.

You can also annotate the test class with ExpectingInstanciationException: then the instantiation of the class will be expected to fail. If such an exception is expected and does occure, the tests won't be run. Note that Junit requires at least one test method to be present, so if @ExpectingInstanciationException is used, we dynamically add the "hashcode()" method, always available on each object, as a dummy "test" method.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor and Description
OneInstancePerClassJUnitRunner(Class<?> klass)

Method Summary

Modifier and Type	Method and Description
protected List<org.junit.runners.model.FrameworkMethod>	computeTestMethods() If the class is annotated with @ExpectingInstanciationException no @Test method are required.
Object	createTest()
boolean	isExpectingInstanciationException()
protected org.junit.runners.model.Statement	methodBlock(org.junit.runners.model.FrameworkMethod method) If an instanciation exception occured, we don't run the actual tests!
void	run(org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, describeChild, getChildren, getTestRules, isIgnored, methodInvoker, possiblyExpectingExceptions, rules, runChild, testName, validateConstructor, validateFields, validateInstanceMethods, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateTestMethods, validateZeroArgConstructor, withAfters, withBefores, withPotentialTimeout

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classBlock, classRules, createTestClass, filter, getDescription, getName, getRunnerAnnotations, getTestClass, 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

Field Detail

logger

protected final org.slf4j.Logger logger

Constructor Detail

OneInstancePerClassJUnitRunner

public OneInstancePerClassJUnitRunner(Class<?> klass)
                               throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

Method Detail

isExpectingInstanciationException

public boolean isExpectingInstanciationException()

createTest

public Object createTest()
                  throws Exception

Overrides:

createTest in class org.junit.runners.BlockJUnit4ClassRunner

Throws:

Exception

computeTestMethods

protected List<org.junit.runners.model.FrameworkMethod> computeTestMethods()

If the class is annotated with @ExpectingInstanciationException no @Test method are required. But Junit wants at least one method, so we add the always present "hashCode" as a test method.

Overrides:

computeTestMethods in class org.junit.runners.BlockJUnit4ClassRunner

methodBlock

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

If an instanciation exception occured, we don't run the actual tests!

Overrides:

methodBlock in class org.junit.runners.BlockJUnit4ClassRunner

run

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

Overrides:

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