org.eclipse.scout.rt.testing.server.runner

Class ServerTestRunner

java.lang.Object

org.junit.runner.Runner

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

org.junit.runners.BlockJUnit4ClassRunner

org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

org.eclipse.scout.rt.testing.server.runner.ServerTestRunner

All Implemented Interfaces:

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

Direct Known Subclasses:

ParameterizedServerTestRunner

public class ServerTestRunner
extends org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

Use this Runner to run tests which require a session and transaction context.

Use the following mandatory annotations to configure the Runner:

• RunWithServerSession:
  to specify the server-session to be used; can be defined on class or method-level;
• RunWithSubject:
  to specify the user on behalf of which to run the test; can be defined on class or method-level;

Example:

 @RunWith(ServerTestRunner.class)
 @RunWithServerSession()
 @RunWithSubject("anna")
 public class YourTest {
    ...
 }
 

Execution:

• Each test-method is executed in a separate transaction - meaning that the transaction boundary starts before executing the first 'before-method', and ends after executing the last 'after-method'.
• By default, server sessions are shared among same users. This can be changed by setting the ServerSessionProvider or a custom provider to RunWithServerSession.provider().
• 'beforeClass' and 'afterClass' are executed in the same transaction.

Note: Usually, all Before, the Test-annotated method and all After methods are invoked in a single transaction. But if the Test-annotated method uses the timeout feature (i.e. Test.timeout()), the three parts are executed in different transactions.

Since:

5.1

See Also:

RunWithServerSession, RunWithSubject

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner.InterceptedAfterStatement, org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner.InterceptedBeforeStatement, org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner.RunAftersStatement

Constructor Summary

Constructors

Constructor and Description
ServerTestRunner(Class<?> clazz)

Method Summary

Modifier and Type	Method and Description
protected org.eclipse.scout.rt.platform.context.RunContext	createJUnitRunContext()
protected boolean	expectsException(org.junit.Test annotation)
protected org.junit.runners.model.Statement	interceptClassLevelStatement(org.junit.runners.model.Statement next, Class<?> testClass)
protected org.junit.runners.model.Statement	interceptMethodLevelStatement(org.junit.runners.model.Statement next, Class<?> testClass, Method testMethod)

Methods inherited from class org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

classBlock, getTimeoutMillis, hasNoTimeout, interceptAfterClassStatement, interceptAfterStatement, interceptBeforeClassStatement, interceptBeforeStatement, methodBlock, possiblyExpectingExceptions, withAfterClasses, withAfters, withBeforeClasses, withBefores, withPotentialTimeout

Methods inherited from class org.junit.runners.BlockJUnit4ClassRunner

collectInitializationErrors, computeTestMethods, createTest, describeChild, getChildren, getTestRules, isIgnored, methodInvoker, rules, runChild, testName, validateConstructor, validateFields, validateInstanceMethods, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateTestMethods, validateZeroArgConstructor

Methods inherited from class org.junit.runners.ParentRunner

childrenInvoker, classRules, createTestClass, filter, getDescription, getName, getRunnerAnnotations, getTestClass, run, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods

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

ServerTestRunner

public ServerTestRunner(Class<?> clazz)
                 throws org.junit.runners.model.InitializationError

Throws:

org.junit.runners.model.InitializationError

Method Detail

interceptClassLevelStatement

protected org.junit.runners.model.Statement interceptClassLevelStatement(org.junit.runners.model.Statement next,
                                                                         Class<?> testClass)

Overrides:

interceptClassLevelStatement in class org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

expectsException

protected boolean expectsException(org.junit.Test annotation)

interceptMethodLevelStatement

protected org.junit.runners.model.Statement interceptMethodLevelStatement(org.junit.runners.model.Statement next,
                                                                          Class<?> testClass,
                                                                          Method testMethod)

Overrides:

interceptMethodLevelStatement in class org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner

createJUnitRunContext

protected org.eclipse.scout.rt.platform.context.RunContext createJUnitRunContext()

Overrides:

createJUnitRunContext in class org.eclipse.scout.rt.testing.platform.runner.PlatformTestRunner