org.spincast.testing.utils

Class SpincastJUnitRunner

java.lang.Object

org.junit.runner.Runner

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

org.junit.runners.BlockJUnit4ClassRunner

org.spincast.testing.utils.SpincastJUnitRunner

All Implemented Interfaces:

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

public class SpincastJUnitRunner
extends org.junit.runners.BlockJUnit4ClassRunner

Spincast JUnit Runner.

Only creates one instance of the test class for all the tests.

If the class is annotated with BeforeAfterClassMethodsProvider, then a beforeClass() and afterClass() methods will be called.

You can use the ExpectingBeforeClassException annotation on the test class to indicate that an exception is expected from the beforeClass() method.

If you try to debug a test that only fails sometimes (those are the worst!), you can use the Repeat annotation on the test or on its test class. This allows you to run the test or the whole test class multiple times.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger
static String	SPINCAST_TEST_NAME_AFTER_CLASS_ANNOTATIONS_VALIDATION
static String	SPINCAST_TEST_NAME_AFTER_CLASS_LOOPS_EXCEPTION
static String	SPINCAST_TEST_NAME_AFTER_CLASS_METHOD_VALIDATION
static String	SPINCAST_TEST_NAME_BEFORE_CLASS_ANNOTATIONS_VALIDATION
static String	SPINCAST_TEST_NAME_BEFORE_CLASS_METHOD_VALIDATION
static String	SPINCAST_TEST_NAME_NO_TESTS_AND_NO_EXPECTION_EXCEPTION_ANNOTATION

Constructor Summary

Constructors

Constructor and Description
SpincastJUnitRunner(Class<?> klass)

Method Summary

Modifier and Type	Method and Description
protected void	addTestFailureListener(org.junit.runner.notification.RunNotifier notifier)
protected List<org.junit.runners.model.FrameworkMethod>	computeTestMethods()
Object	createTest() JUnit calls that method to create an instance of the test class for each individual test.
protected int	getCurrentClassLoopPosition()
protected int	getLoopsNbr(Repeat repeatAnnotation)
protected int	getLoopsSleep(Repeat repeatAnnotation)
protected int	getMethodLoopsNbr(Method method)
protected int	getMethodLoopsSleep(Method method)
protected String	getName() Test class display name.
protected org.junit.runner.notification.RunNotifier	getRunNotifier()
protected String	getStackTrace(Throwable ex)
protected Object	getTestClassInstance()
protected int	getTestClassLoopsNbr()
protected int	getTestClassLoopsSleep()
protected boolean	isExceptionInBeforeClass()
boolean	isExpectingBeforeClassException()
protected boolean	isIgnoreRemainingTests()
void	run(org.junit.runner.notification.RunNotifier notifier) Runs the test class.
protected void	runChild(org.junit.runners.model.FrameworkMethod method, org.junit.runner.notification.RunNotifier notifier) Runs a specific test
protected void	runPreClassLoopsSpincastTests()
protected void	setCurrentClassLoopPosition(int currentClassLoopPosition)
protected void	setExceptionInBeforeClass()
protected void	setIgnoreRemainingTests()
protected void	spincastTestError(String testName, String errorMessage)
protected void	spincastTestError(String testName, Throwable exception)
protected void	validateNoAfterClassAnnotations()
protected void	validateNoBeforeClassAnnotations()
protected void	validateNoTestsAndNoExpectingBeforeClassExceptionAnnotation()

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, describeChild, getChildren, getTestRules, isIgnored, methodBlock, methodInvoker, possiblyExpectingExceptions, rules, 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, 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

SPINCAST_TEST_NAME_BEFORE_CLASS_ANNOTATIONS_VALIDATION

public static final String SPINCAST_TEST_NAME_BEFORE_CLASS_ANNOTATIONS_VALIDATION

See Also:

Constant Field Values

SPINCAST_TEST_NAME_AFTER_CLASS_ANNOTATIONS_VALIDATION

public static final String SPINCAST_TEST_NAME_AFTER_CLASS_ANNOTATIONS_VALIDATION

See Also:

Constant Field Values

SPINCAST_TEST_NAME_BEFORE_CLASS_METHOD_VALIDATION

public static final String SPINCAST_TEST_NAME_BEFORE_CLASS_METHOD_VALIDATION

See Also:

Constant Field Values

SPINCAST_TEST_NAME_AFTER_CLASS_METHOD_VALIDATION

public static final String SPINCAST_TEST_NAME_AFTER_CLASS_METHOD_VALIDATION

See Also:

Constant Field Values

SPINCAST_TEST_NAME_NO_TESTS_AND_NO_EXPECTION_EXCEPTION_ANNOTATION

public static final String SPINCAST_TEST_NAME_NO_TESTS_AND_NO_EXPECTION_EXCEPTION_ANNOTATION

SPINCAST_TEST_NAME_AFTER_CLASS_LOOPS_EXCEPTION

public static final String SPINCAST_TEST_NAME_AFTER_CLASS_LOOPS_EXCEPTION

See Also:

Constant Field Values

Constructor Detail

SpincastJUnitRunner

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

Throws:

org.junit.runners.model.InitializationError

Method Detail

getRunNotifier

protected org.junit.runner.notification.RunNotifier getRunNotifier()

setIgnoreRemainingTests

protected void setIgnoreRemainingTests()

isIgnoreRemainingTests

protected boolean isIgnoreRemainingTests()

setExceptionInBeforeClass

protected void setExceptionInBeforeClass()

isExceptionInBeforeClass

protected boolean isExceptionInBeforeClass()

getCurrentClassLoopPosition

protected int getCurrentClassLoopPosition()

setCurrentClassLoopPosition

protected void setCurrentClassLoopPosition(int currentClassLoopPosition)

createTest

public Object createTest()
                  throws Exception

JUnit calls that method to create an instance of the test class for each individual test. We change this behavior and always return the *same* instance of the test class: 'testClassInstance'.

Overrides:

createTest in class org.junit.runners.BlockJUnit4ClassRunner

Throws:

Exception

getTestClassInstance

protected Object getTestClassInstance()

getName

protected String getName()

Test class display name.

Overrides:

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

computeTestMethods

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

Overrides:

computeTestMethods in class org.junit.runners.BlockJUnit4ClassRunner

run

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

Runs the test class.

Overrides:

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

runChild

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

Runs a specific test

Overrides:

runChild in class org.junit.runners.BlockJUnit4ClassRunner

addTestFailureListener

protected void addTestFailureListener(org.junit.runner.notification.RunNotifier notifier)

runPreClassLoopsSpincastTests

protected void runPreClassLoopsSpincastTests()

validateNoBeforeClassAnnotations

protected void validateNoBeforeClassAnnotations()

validateNoAfterClassAnnotations

protected void validateNoAfterClassAnnotations()

validateNoTestsAndNoExpectingBeforeClassExceptionAnnotation

protected void validateNoTestsAndNoExpectingBeforeClassExceptionAnnotation()

spincastTestError

protected void spincastTestError(String testName,
                                 String errorMessage)

spincastTestError

protected void spincastTestError(String testName,
                                 Throwable exception)

getStackTrace

protected String getStackTrace(Throwable ex)

isExpectingBeforeClassException

public boolean isExpectingBeforeClassException()

getTestClassLoopsNbr

protected int getTestClassLoopsNbr()

getMethodLoopsNbr

protected int getMethodLoopsNbr(Method method)

getLoopsNbr

protected int getLoopsNbr(Repeat repeatAnnotation)

getMethodLoopsSleep

protected int getMethodLoopsSleep(Method method)

getTestClassLoopsSleep

protected int getTestClassLoopsSleep()

getLoopsSleep

protected int getLoopsSleep(Repeat repeatAnnotation)