com.goldencode.p2j.testengine

Interface UnitTestEngine

public interface UnitTestEngine

Interface to support FWD unit testing engine remote operations. See UnitTestServer for the implementation.

Method Summary

Modifier and Type	Method and Description
void	after(org.junit.platform.engine.UniqueId testId) Execute the after behavior of this node.
void	before(org.junit.platform.engine.UniqueId testId) Execute the before behavior of this node.
void	cleanUp(org.junit.platform.engine.UniqueId testId) Clean up the supplied context after execution.
org.junit.platform.engine.TestDescriptor	discover(org.junit.platform.engine.UniqueId uniqueId, java.net.URI[] classroots, java.lang.String[] packages, java.lang.String[] classes, java.lang.String[] methods, java.net.URI[] uris, java.lang.String[] files, java.lang.String[] directories, java.lang.String[] modules, java.lang.String[] resources, java.lang.String[] iterations) Discover test sources provided as arguments.
void	execute(org.junit.platform.engine.UniqueId testId) Execute the behavior of this node.
void	initialize() Do server-side initialization
void	prepare(org.junit.platform.engine.UniqueId testId) Prepare test

Method Detail

after

void after(org.junit.platform.engine.UniqueId testId)
    throws ErrorConditionException,
           org.opentest4j.AssertionFailedError

Execute the after behavior of this node.

This method will be called once after execution of this node.

Parameters:

testId - test descriptor ID

Throws:

ErrorConditionException - remote code may throw this

org.opentest4j.AssertionFailedError - remote legacy errors are converted to this exception type

before

void before(org.junit.platform.engine.UniqueId testId)
     throws ErrorConditionException,
            org.opentest4j.AssertionFailedError

Execute the before behavior of this node.

This method will be called once before execution of this node.

Parameters:

testId - test descriptor ID

Throws:

ErrorConditionException - remote code may throw this

org.opentest4j.AssertionFailedError - remote legacy errors are converted to this exception type

cleanUp

void cleanUp(org.junit.platform.engine.UniqueId testId)

Clean up the supplied context after execution.

Reset the test class instance.

Parameters:

testId - test descriptor ID

See Also:

prepare(org.junit.platform.engine.UniqueId)

discover

org.junit.platform.engine.TestDescriptor discover(org.junit.platform.engine.UniqueId uniqueId,
                                                  java.net.URI[] classroots,
                                                  java.lang.String[] packages,
                                                  java.lang.String[] classes,
                                                  java.lang.String[] methods,
                                                  java.net.URI[] uris,
                                                  java.lang.String[] files,
                                                  java.lang.String[] directories,
                                                  java.lang.String[] modules,
                                                  java.lang.String[] resources,
                                                  java.lang.String[] iterations)
                                           throws ErrorConditionException,
                                                  org.opentest4j.AssertionFailedError

Discover test sources provided as arguments.

Parameters:

uniqueId - the engine unique ID

classroots - the list of class root URLs

packages - the list of packages

classes - the list of class names

methods - the list of method specifications

uris - the list of URIs

files - the list of files

directories - the list of directories

modules - the list of modules

resources - the list of resources

iterations - the list of iterations (currently not supported)

Returns:

the test descriptor discovered or null if no match was found.

Throws:

ErrorConditionException - remote code may throw this

org.opentest4j.AssertionFailedError - remote legacy errors are converted to this exception type

execute

void execute(org.junit.platform.engine.UniqueId testId)
      throws ErrorConditionException,
             org.opentest4j.AssertionFailedError

Execute the behavior of this node.

Containers typically do not implement this method since the HierarchicalTestEngine handles execution of their children.

Parameters:

testId - test descriptor ID

Throws:

ErrorConditionException - remote code may throw this

org.opentest4j.AssertionFailedError - remote legacy errors are converted to this exception type

initialize

void initialize()

Do server-side initialization

prepare

void prepare(org.junit.platform.engine.UniqueId testId)
      throws ErrorConditionException,
             org.opentest4j.AssertionFailedError

Prepare test

Parameters:

testId - test descriptor ID

Throws:

ErrorConditionException - remote code may throw this

org.opentest4j.AssertionFailedError - remote legacy errors are converted to this exception type