ch.inftec.ju.ee.test

Interface TestRunnerFacade

All Known Implementing Classes:

TestRunnerFacadeBean

public interface TestRunnerFacade

Helper facade to invoke (test) methods from local unit tests in a remote JVM server container context.

The facade is supposed to perform regular EJB transaction commit or rollback, depending on the exception that might arise when executing test methods.

Author:

Martin

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	TestRunnerFacade.ContextAware Interface for classes that are context aware, i.e.
static class	TestRunnerFacade.DataVerifierInfo Helper object that contains information to instantiate a DataVerifier.
static interface	TestRunnerFacade.Initializable Interfaces for classes that would like to be initialized before the test method is run (some functionality as a @Before method would provide).
static class	TestRunnerFacade.TestRunnerContext Helper class that contains information about the context the test runs within.
static interface	TestRunnerFacade.TransactionAware Interface for classes that are transaction aware, i.e.

Method Summary

Methods

Modifier and Type	Method and Description
void	cleanupTestRun(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler, ch.inftec.ju.util.SystemPropertyTempSetter tempSetter) Resets the system properties to their original state and ends the test context on the server.
String	getVersion() Gets the version of the TestRunnerFacade.
Object	runMethodInEjbContext(String className, String methodName, Class<?>[] parameterTypes, Object[] args) Runs an arbitrary method in an EJB context and returns the result of the method.
void	runPostTestActionsInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler) Runs post test actions (like data set exports and data verifies) in an EJB context.
ch.inftec.ju.util.SystemPropertyTempSetter	runPreTestActionsInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler) Runs pre test actions (like data set loading) in an EJB context.
void	runTestMethodInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler) Runs a (test) method in an EJB context, allowing it to use container functionality and beans.

Method Detail

getVersion

String getVersion()

Gets the version of the TestRunnerFacade.

This can be used for remote lookup testing purposes.

Returns:

The actual version of the TestRunnerFacade.

runPreTestActionsInEjbContext

ch.inftec.ju.util.SystemPropertyTempSetter runPreTestActionsInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler)
                                                                         throws Exception

Runs pre test actions (like data set loading) in an EJB context.

Parameters:

handler - TestRunner handler providing information about the test class and method

Returns:

SystemPropertyTempSetter instance that contains the original system property state. At the end of the test (be it successful of not) we need to call the

Throws:

Exception - If the actions fail

runTestMethodInEjbContext

void runTestMethodInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler)
                               throws Exception

Runs a (test) method in an EJB context, allowing it to use container functionality and beans.

Parameters:

handler - TestRunner handler that provides information about the test class and method

Throws:

Exception - If the method fails with an exception (including test assertion failures)

runPostTestActionsInEjbContext

void runPostTestActionsInEjbContext(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler)
                                    throws Exception

Runs post test actions (like data set exports and data verifies) in an EJB context.

Parameters:

handler - TestRunner handler providing information about the test class and method

Throws:

Exception - If the actions fail

cleanupTestRun

void cleanupTestRun(ch.inftec.ju.ee.test.TestRunnerAnnotationHandler handler,
                  ch.inftec.ju.util.SystemPropertyTempSetter tempSetter)

Resets the system properties to their original state and ends the test context on the server.

Must be called with the SystemPropertyTempSetter returned by the runPreTestActionInEjbContext method

Parameters:

handler - TestRunner handler providing information about the test class and method

tempSetter - SystemPropertyTempSetter that is used to restore the system property to their original (i.e. pre test) state

runMethodInEjbContext

Object runMethodInEjbContext(String className,
                           String methodName,
                           Class<?>[] parameterTypes,
                           Object[] args)
                             throws Exception

Runs an arbitrary method in an EJB context and returns the result of the method.

Parameters:

className - Class name that contains the method

methodName - Method name

parameterTypes - Array of argument types

args - Array of arguments

Returns:

Result value of the method

Throws:

Exception