org.apache.geode.test.concurrency

Class ConcurrentTestRunner

java.lang.Object

org.junit.runner.Runner

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

org.apache.geode.test.concurrency.ConcurrentTestRunner

All Implemented Interfaces:

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

public class ConcurrentTestRunner
extends org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>

Test runner for tests that involve multiple threads. All methods annotated with @Test must take a ParallelExecutor as a parameter, which the test can use to invoke code in parallel. This test run will try to exercise the test method to flush out any concurrent bugs in the parallel execution. All test logic and state *must* be encapsulated in the individual test methods. This is because the concurrency testing logic may need to invoke the test body multiple times, possibly in parallel. No guarantees are currently made about logic in methods annotated with @Before, @BeforeClass or about the behavior of Rule for concurrent tests. Example @RunWith(ConcurrentTestRunner.class) public void MyTest { @Test public void someTestMethod(ParallelExecutor executor) { AtomicInteger atomicInteger = new AtomicInteger(); executor.inParallel(() -> atomicInteger.incrementAndGet()); executor.inParallel(() -> atomicInteger.incrementAndGet()); executor.execute(); assertEquals(2, atomicInteger.get()); } } ConcurrentTestRunner currently executes tests using the LoopRunner which will run the test many times.

Constructor Summary

Constructors

Constructor and Description
ConcurrentTestRunner(java.lang.Class testClass)

Method Summary

Modifier and Type	Method and Description
protected void	collectInitializationErrors(java.util.List<java.lang.Throwable> errors)
protected org.junit.runner.Description	describeChild(org.junit.runners.model.FrameworkMethod child)
protected java.util.List<org.junit.runners.model.FrameworkMethod>	getChildren()
protected void	runChild(org.junit.runners.model.FrameworkMethod child, org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.ParentRunner

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

ConcurrentTestRunner

public ConcurrentTestRunner(java.lang.Class testClass)
                     throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

Method Detail

getChildren

protected java.util.List<org.junit.runners.model.FrameworkMethod> getChildren()

Specified by:

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

collectInitializationErrors

protected void collectInitializationErrors(java.util.List<java.lang.Throwable> errors)

Overrides:

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

describeChild

protected org.junit.runner.Description describeChild(org.junit.runners.model.FrameworkMethod child)

Specified by:

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

runChild

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

Specified by:

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