org.unitils

Class UnitilsJUnit4TestClassRunner

java.lang.Object

org.junit.runner.Runner

org.junit.internal.runners.JUnit4ClassRunner

org.unitils.UnitilsJUnit4TestClassRunner

All Implemented Interfaces:

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

Direct Known Subclasses:

UnitilsParameterized.TestClassRunnerForParameters

public class UnitilsJUnit4TestClassRunner
extends org.junit.internal.runners.JUnit4ClassRunner
implements TestRunnerAccessor

Custom test runner that will Unitils-enable your test. This will make sure that the core unitils test listener methods are invoked in the expected order. See TestListener for more information on the listener invocation order.

NOTE: if a test fails, the error is logged as debug logging. This is a temporary work-around for a problem with IntelliJ JUnit-4 runner that reports a 'Wrong test finished' error when something went wrong in the before. [IDEA-12498]

Author:

Tim Ducheyne, Filip Neven

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	UnitilsJUnit4TestClassRunner.TestListenerInvokingMethodRoadie Custom method roadie that invokes the unitils test listener methods at the apropriate moments.

Constructor Summary

Constructors

Constructor and Description
UnitilsJUnit4TestClassRunner(Class<?> testClass) Creates a test runner that runs all test methods in the given class.

Method Summary

Methods

Modifier and Type	Method and Description
protected org.junit.internal.runners.MethodRoadie	createMethodRoadie(Object testObject, Method testMethod, org.junit.internal.runners.TestMethod jUnitTestMethod, org.junit.runner.notification.RunNotifier notifier, org.junit.runner.Description description) Returns the JUnit 4 MethodRoadie object that is used to execute the test method
void	executeTestMethod(Object testObject, Method method) This method allows access to the test invocation, from within the modules (who get a reference to the runner via the context).
protected TestListener	getTestListener()
protected Unitils	getUnitils() Returns the default singleton instance of Unitils
protected void	invokeTestMethod(Method method, org.junit.runner.notification.RunNotifier notifier) Overridden JUnit4 method to be able to create a CustomMethodRoadie that will invoke the unitils test listener methods at the appropriate moments.
void	run(org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.internal.runners.JUnit4ClassRunner

classAnnotations, createTest, filter, getDescription, getName, getTestClass, getTestMethods, methodDescription, runMethods, sort, testAnnotations, testName, validate, wrapMethod

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

UnitilsJUnit4TestClassRunner

public UnitilsJUnit4TestClassRunner(Class<?> testClass)
                             throws org.junit.internal.runners.InitializationError

Creates a test runner that runs all test methods in the given class.

Parameters:

testClass - the class, not null

Throws:

org.junit.internal.runners.InitializationError

Method Detail

run

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

Overrides:

run in class org.junit.internal.runners.JUnit4ClassRunner

invokeTestMethod

protected void invokeTestMethod(Method method,
                    org.junit.runner.notification.RunNotifier notifier)

Overridden JUnit4 method to be able to create a CustomMethodRoadie that will invoke the unitils test listener methods at the appropriate moments.

Overrides:

invokeTestMethod in class org.junit.internal.runners.JUnit4ClassRunner

createMethodRoadie

protected org.junit.internal.runners.MethodRoadie createMethodRoadie(Object testObject,
                                                         Method testMethod,
                                                         org.junit.internal.runners.TestMethod jUnitTestMethod,
                                                         org.junit.runner.notification.RunNotifier notifier,
                                                         org.junit.runner.Description description)

Returns the JUnit 4 MethodRoadie object that is used to execute the test method

Parameters:

testObject - The test instance, not null

testMethod - The test method, not null

jUnitTestMethod - The JUnit test method

notifier - The run listener, not null

description - A test description

Returns:

An JUnit MethodRoadie

executeTestMethod

public void executeTestMethod(Object testObject,
                     Method method)

This method allows access to the test invocation, from within the modules (who get a reference to the runner via the context). We do not check for listeners veto's (typically, these modules will veto the execution of the test in normal execution mode, and call this method later on to do their logic).

Specified by:

executeTestMethod in interface TestRunnerAccessor

Parameters:

testObject -

method -

getTestListener

protected TestListener getTestListener()

Returns:

The unitils test listener

getUnitils

protected Unitils getUnitils()

Returns the default singleton instance of Unitils

Returns:

the Unitils instance, not null