Module org.junit.platform.engine

Package org.junit.platform.engine

Class ExecutionRequest

java.lang.Object

org.junit.platform.engine.ExecutionRequest

@API(status=STABLE,
     since="1.0")
public class ExecutionRequest
extends Object

Provides a single TestEngine access to the information necessary to execute its tests.

A request contains an engine's root TestDescriptor, the EngineExecutionListener to be notified of test execution events, and ConfigurationParameters that the engine may use to influence test execution.

Since:

1.0

See Also:

• TestEngine

Constructor Summary

Constructors

Constructor	Description
ExecutionRequest(TestDescriptor rootTestDescriptor, EngineExecutionListener engineExecutionListener, ConfigurationParameters configurationParameters)

Method Summary

Modifier and Type	Method	Description
static ExecutionRequest	create(TestDescriptor rootTestDescriptor, EngineExecutionListener engineExecutionListener, ConfigurationParameters configurationParameters)	Factory for creating an execution request.
ConfigurationParameters	getConfigurationParameters()	Get the ConfigurationParameters that the engine may use to influence test execution.
EngineExecutionListener	getEngineExecutionListener()	Get the EngineExecutionListener to be notified of test execution events.
TestDescriptor	getRootTestDescriptor()	Get the root TestDescriptor of the engine that processes this request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ExecutionRequest

@API(status=INTERNAL,
     since="1.0")
public ExecutionRequest(TestDescriptor rootTestDescriptor,
 EngineExecutionListener engineExecutionListener,
 ConfigurationParameters configurationParameters)

Method Details

create

@API(status=STABLE,
     since="1.9")
public static ExecutionRequest create(TestDescriptor rootTestDescriptor,
 EngineExecutionListener engineExecutionListener,
 ConfigurationParameters configurationParameters)

Factory for creating an execution request.

Parameters:

rootTestDescriptor - the engine's root TestDescriptor

engineExecutionListener - the EngineExecutionListener to be notified of test execution events

configurationParameters - ConfigurationParameters that the engine may use to influence test execution

Returns:

a new ExecutionRequest; never null

Since:

1.9

getRootTestDescriptor

public TestDescriptor getRootTestDescriptor()

Get the root TestDescriptor of the engine that processes this request.

Note: the root descriptor is the TestDescriptor returned by TestEngine.discover(EngineDiscoveryRequest, UniqueId).

getEngineExecutionListener

public EngineExecutionListener getEngineExecutionListener()

Get the EngineExecutionListener to be notified of test execution events.

getConfigurationParameters

public ConfigurationParameters getConfigurationParameters()

Get the ConfigurationParameters that the engine may use to influence test execution.