org.jukito

Class JukitoRunner

java.lang.Object

org.junit.runner.Runner

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

org.junit.runners.BlockJUnit4ClassRunner

org.jukito.JukitoRunner

All Implemented Interfaces:

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

public class JukitoRunner
extends org.junit.runners.BlockJUnit4ClassRunner

TODO: Rework this documentation

This class implements the mockito runner but allows Guice dependency injection. To setup the guice environment, the test class can have an inner static class deriving from TestModule. This last class will let you bind TestSingleton and TestEagerSingleton and the runner will make sure these singletons are reset at every invocation of a test case.

This code not very clean as it is cut & paste from JUnit45AndHigherRunnerImpl, but it's unclear how we could make otherwise.

Most of the code here is inspired from: http://cowwoc.blogspot.com/2008/10/integrating-google-guice-into-junit4. html

Depends on Mockito.

Author:

Philippe Beaudoin

Constructor Summary

Constructors

Constructor and Description
JukitoRunner(Class<?> klass)

Method Summary

Methods

Modifier and Type	Method and Description
protected List<org.junit.runners.model.FrameworkMethod>	computeTestMethods()
protected Object	createTest()
protected Injector	getInjector() Access the Guice injector.
protected org.junit.runners.model.Statement	methodInvoker(org.junit.runners.model.FrameworkMethod method, Object test)
void	run(org.junit.runner.notification.RunNotifier notifier)
protected void	validateInstanceMethods(List<Throwable> errors) Adds to errors for each method annotated with @Test, @Before, or @After that is not a public, void instance method with no arguments.
protected void	validatePublicVoidMethods(Class<? extends Annotation> annotation, boolean isStatic, List<Throwable> errors) Adds to errors if any method in this class is annotated with the provided annotation, but: is not public, or returns something other than void, or is static (given isStatic is false), or is not static (given isStatic is true).
protected void	validateTestMethods(List<Throwable> errors) Adds to errors for each method annotated with @Testthat is not a public, void instance method with no arguments.
protected org.junit.runners.model.Statement	withAfters(org.junit.runners.model.FrameworkMethod method, Object target, org.junit.runners.model.Statement statement)
protected org.junit.runners.model.Statement	withBefores(org.junit.runners.model.FrameworkMethod method, Object target, org.junit.runners.model.Statement statement)

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, describeChild, getChildren, getTestRules, methodBlock, possiblyExpectingExceptions, rules, runChild, testName, validateConstructor, validateFields, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateZeroArgConstructor, withPotentialTimeout

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classBlock, classRules, 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

Constructor Detail

JukitoRunner

public JukitoRunner(Class<?> klass)
             throws org.junit.runners.model.InitializationError,
                    InvocationTargetException,
                    InstantiationException,
                    IllegalAccessException

Throws:

org.junit.runners.model.InitializationError

InvocationTargetException

InstantiationException

IllegalAccessException

Method Detail

run

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

Overrides:

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

createTest

protected Object createTest()
                     throws Exception

Overrides:

createTest in class org.junit.runners.BlockJUnit4ClassRunner

Throws:

Exception

methodInvoker

protected org.junit.runners.model.Statement methodInvoker(org.junit.runners.model.FrameworkMethod method,
                                              Object test)

Overrides:

methodInvoker in class org.junit.runners.BlockJUnit4ClassRunner

withBefores

protected org.junit.runners.model.Statement withBefores(org.junit.runners.model.FrameworkMethod method,
                                            Object target,
                                            org.junit.runners.model.Statement statement)

Overrides:

withBefores in class org.junit.runners.BlockJUnit4ClassRunner

withAfters

protected org.junit.runners.model.Statement withAfters(org.junit.runners.model.FrameworkMethod method,
                                           Object target,
                                           org.junit.runners.model.Statement statement)

Overrides:

withAfters in class org.junit.runners.BlockJUnit4ClassRunner

computeTestMethods

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

Overrides:

computeTestMethods in class org.junit.runners.BlockJUnit4ClassRunner

validateInstanceMethods

protected void validateInstanceMethods(List<Throwable> errors)

Adds to errors for each method annotated with @Test, @Before, or @After that is not a public, void instance method with no arguments.

Overrides:

validateInstanceMethods in class org.junit.runners.BlockJUnit4ClassRunner

validateTestMethods

protected void validateTestMethods(List<Throwable> errors)

Adds to errors for each method annotated with @Testthat is not a public, void instance method with no arguments.

Overrides:

validateTestMethods in class org.junit.runners.BlockJUnit4ClassRunner

validatePublicVoidMethods

protected void validatePublicVoidMethods(Class<? extends Annotation> annotation,
                             boolean isStatic,
                             List<Throwable> errors)

Adds to errors if any method in this class is annotated with the provided annotation, but:

• is not public, or
• returns something other than void, or
• is static (given isStatic is false), or
• is not static (given isStatic is true).

getInjector

protected Injector getInjector()

Access the Guice injector.

Returns:

The Guice Injector.