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, the ConfigurationParameters that the engine may use to influence test execution, and an OutputDirectoryProvider for writing reports and other output files.

Since:

1.0

See Also:

• TestEngine

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
static ExecutionRequest	create(TestDescriptor rootTestDescriptor, EngineExecutionListener engineExecutionListener, ConfigurationParameters configurationParameters)	Deprecated. Use create(TestDescriptor, EngineExecutionListener, ConfigurationParameters, OutputDirectoryProvider)
static ExecutionRequest	create(TestDescriptor rootTestDescriptor, EngineExecutionListener engineExecutionListener, ConfigurationParameters configurationParameters, OutputDirectoryProvider outputDirectoryProvider)	Factory for creating an execution request.
ConfigurationParameters	getConfigurationParameters()	Returns the ConfigurationParameters that the engine may use to influence test execution.
EngineExecutionListener	getEngineExecutionListener()	Returns the EngineExecutionListener to be notified of test execution events.
OutputDirectoryProvider	getOutputDirectoryProvider()	Returns the OutputDirectoryProvider for this request for writing reports and other output files.
TestDescriptor	getRootTestDescriptor()	Returns 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

@Deprecated
@API(status=DEPRECATED,
     since="1.11")
public ExecutionRequest(TestDescriptor rootTestDescriptor,
 EngineExecutionListener engineExecutionListener,
 ConfigurationParameters configurationParameters)

Deprecated.

Method Details

create

@Deprecated
@API(status=DEPRECATED,
     since="1.11")
public static ExecutionRequest create(TestDescriptor rootTestDescriptor,
 EngineExecutionListener engineExecutionListener,
 ConfigurationParameters configurationParameters)

Deprecated.

Use create(TestDescriptor, EngineExecutionListener, ConfigurationParameters, OutputDirectoryProvider)

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

create

@API(status=INTERNAL,
     since="1.12")
public static ExecutionRequest create(TestDescriptor rootTestDescriptor,
 EngineExecutionListener engineExecutionListener,
 ConfigurationParameters configurationParameters,
 OutputDirectoryProvider outputDirectoryProvider)

Factory for creating an execution request.

Parameters:

rootTestDescriptor - the engine's root TestDescriptor; never null

engineExecutionListener - the EngineExecutionListener to be notified of test execution events; never null

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

outputDirectoryProvider - OutputDirectoryProvider for writing reports and other output files; never null

Returns:

a new ExecutionRequest; never null

Since:

1.12

getRootTestDescriptor

public TestDescriptor getRootTestDescriptor()

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

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

Returns:

the root TestDescriptor of the engine that processes this request

getEngineExecutionListener

public EngineExecutionListener getEngineExecutionListener()

Returns the EngineExecutionListener to be notified of test execution events.

Returns:

the EngineExecutionListener to be notified of test execution events

getConfigurationParameters

public ConfigurationParameters getConfigurationParameters()

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

Returns:

the ConfigurationParameters that the engine may use to influence test execution

getOutputDirectoryProvider

@API(status=EXPERIMENTAL,
     since="1.12")
public OutputDirectoryProvider getOutputDirectoryProvider()

Returns the OutputDirectoryProvider for this request for writing reports and other output files.

Returns:

the OutputDirectoryProvider for this request for writing reports and other output files

Throws:

PreconditionViolationException - if the output directory provider is not available

Since:

1.12