de.oschoen.junit.runner

Class BatchTestRunner

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<org.junit.runner.Runner>

de.oschoen.junit.runner.BatchTestRunner

All Implemented Interfaces:

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

Direct Known Subclasses:

ProgressBatchSuite

public class BatchTestRunner
extends org.junit.runners.ParentRunner<org.junit.runner.Runner>

Define a junit 4 test suite based on pattern matching.

Examples

Find all classes in package com.example and sub packages, whose name ends with Test.

 package com.example;

 import org.junit.runner.RunWith;

 @RunWith(de.oschoen.junit.runner.BatchTestRunner.class)
 public class AllTests { }
 

Find all classes in package com.example and sub packages, whose name ends with Suite.

 package com.example;

 import org.junit.runner.RunWith;

 @RunWith(de.oschoen.junit.runner.BatchTestRunner.class)
 @BatchTestRunner.BatchTestInclude("**.*Suite")
 public class AllTests {}
 

Exclude a package:

 package com.example;

 import org.junit.runner.RunWith;

 @RunWith(de.oschoen.junit.runner.BatchTestRunner.class)
 @BatchTestRunner.BatchTestExclude("**.shouldBeIgnored.**")
 public class AllTests {}
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BatchTestRunner.BatchTestExclude
static interface	BatchTestRunner.BatchTestInclude

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BatchTestRunner(Class<?> klass, List<org.junit.runner.Runner> runners) Called by this class and subclasses once the runners making up the suite have been determined
	BatchTestRunner(Class<?> klass, org.junit.runners.model.RunnerBuilder builder) Called reflectively on classes annotated with @RunWith(BatchTestRunner.class)
	BatchTestRunner(org.junit.runners.model.RunnerBuilder builder, Class<?>[] classes) Call this when there is no single root class (for example, multiple class names passed on the command line to JUnitCore
protected	BatchTestRunner(org.junit.runners.model.RunnerBuilder builder, Class<?> klass, Class<?>[] suiteClasses) Called by this class and subclasses once the classes making up the suite have been determined

Method Summary

Methods

Modifier and Type	Method and Description
protected org.junit.runner.Description	describeChild(org.junit.runner.Runner child)
protected List<org.junit.runner.Runner>	getChildren()
protected void	runChild(org.junit.runner.Runner runner, org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.ParentRunner

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

BatchTestRunner

public BatchTestRunner(Class<?> klass,
               org.junit.runners.model.RunnerBuilder builder)
                throws org.junit.runners.model.InitializationError

Called reflectively on classes annotated with @RunWith(BatchTestRunner.class)

Parameters:

klass - the root class

builder - builds runners for classes in the suite

Throws:

org.junit.runners.model.InitializationError

BatchTestRunner

public BatchTestRunner(org.junit.runners.model.RunnerBuilder builder,
               Class<?>[] classes)
                throws org.junit.runners.model.InitializationError

Call this when there is no single root class (for example, multiple class names passed on the command line to JUnitCore

Parameters:

builder - builds runners for classes in the suite

classes - the classes in the suite

Throws:

org.junit.runners.model.InitializationError

BatchTestRunner

protected BatchTestRunner(org.junit.runners.model.RunnerBuilder builder,
               Class<?> klass,
               Class<?>[] suiteClasses)
                   throws org.junit.runners.model.InitializationError

Called by this class and subclasses once the classes making up the suite have been determined

Parameters:

builder - builds runners for classes in the suite

klass - the root of the suite

suiteClasses - the classes in the suite

Throws:

org.junit.runners.model.InitializationError

BatchTestRunner

protected BatchTestRunner(Class<?> klass,
               List<org.junit.runner.Runner> runners)
                   throws org.junit.runners.model.InitializationError

Called by this class and subclasses once the runners making up the suite have been determined

Parameters:

klass - root of the suite

runners - for each class in the suite, a Runner

Throws:

org.junit.runners.model.InitializationError

Method Detail

getChildren

protected List<org.junit.runner.Runner> getChildren()

Specified by:

getChildren in class org.junit.runners.ParentRunner<org.junit.runner.Runner>

describeChild

protected org.junit.runner.Description describeChild(org.junit.runner.Runner child)

Specified by:

describeChild in class org.junit.runners.ParentRunner<org.junit.runner.Runner>

runChild

protected void runChild(org.junit.runner.Runner runner,
            org.junit.runner.notification.RunNotifier notifier)

Specified by:

runChild in class org.junit.runners.ParentRunner<org.junit.runner.Runner>