Package org.junit.jupiter.engine

Class JupiterTestEngine

java.lang.Object

org.junit.platform.engine.support.hierarchical.HierarchicalTestEngine<JupiterEngineExecutionContext>

org.junit.jupiter.engine.JupiterTestEngine

All Implemented Interfaces:

TestEngine

@API(status=INTERNAL,
     since="5.0")
public final class JupiterTestEngine
extends HierarchicalTestEngine<JupiterEngineExecutionContext>

The JUnit Jupiter TestEngine.

Since:

5.0

Field Summary

Fields

Modifier and Type	Field	Description
static String	ENGINE_ID

Constructor Summary

Constructors

Constructor	Description
JupiterTestEngine()

Method Summary

Modifier and Type	Method	Description
protected JupiterEngineExecutionContext	createExecutionContext(ExecutionRequest request)	Create the initial execution context for executing the supplied request.
protected HierarchicalTestExecutorService	createExecutorService(ExecutionRequest request)	Create the executor service to use for executing the supplied request.
TestDescriptor	discover(EngineDiscoveryRequest discoveryRequest, UniqueId uniqueId)	Discover tests according to the supplied EngineDiscoveryRequest.
Optional<String>	getArtifactId()	Returns junit-jupiter-engine as the artifact ID.
Optional<String>	getGroupId()	Returns org.junit.jupiter as the group ID.
String	getId()	Get the ID that uniquely identifies this test engine.

Methods inherited from class org.junit.platform.engine.support.hierarchical.HierarchicalTestEngine

createThrowableCollectorFactory, execute

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.junit.platform.engine.TestEngine

getVersion

Field Detail

ENGINE_ID

public static final String ENGINE_ID

See Also:

Constant Field Values

Constructor Detail

JupiterTestEngine

public JupiterTestEngine()

Method Detail

getId

public String getId()

Description copied from interface: TestEngine

Get the ID that uniquely identifies this test engine.

Each test engine must provide a unique ID. For example, JUnit Vintage and JUnit Jupiter use "junit-vintage" and "junit-jupiter", respectively. When in doubt, you may use the fully qualified name of your custom TestEngine implementation class.

getGroupId

public Optional<String> getGroupId()

Returns org.junit.jupiter as the group ID.

Returns:

an Optional containing the group ID; never null but potentially empty if the group ID is unknown

See Also:

TestEngine.getArtifactId(), TestEngine.getVersion()

getArtifactId

public Optional<String> getArtifactId()

Returns junit-jupiter-engine as the artifact ID.

Returns:

an Optional containing the artifact ID; never null but potentially empty if the artifact ID is unknown

See Also:

Class.getPackage(), Package.getImplementationTitle(), TestEngine.getGroupId(), TestEngine.getVersion()

discover

public TestDescriptor discover(EngineDiscoveryRequest discoveryRequest,
                               UniqueId uniqueId)

Description copied from interface: TestEngine

Discover tests according to the supplied EngineDiscoveryRequest.

The supplied UniqueId must be used as the unique ID of the returned root TestDescriptor. In addition, the UniqueId must be used to create unique IDs for children of the root's descriptor by calling UniqueId.append(java.lang.String, java.lang.String).

Parameters:

discoveryRequest - the discovery request; never null

uniqueId - the unique ID to be used for this test engine's TestDescriptor; never null

Returns:

the root TestDescriptor of this engine, typically an instance of EngineDescriptor

See Also:

EngineDescriptor

createExecutorService

protected HierarchicalTestExecutorService createExecutorService(ExecutionRequest request)

Description copied from class: HierarchicalTestEngine

Create the executor service to use for executing the supplied request.

An engine may use the information in the supplied request such as the contained configuration parameters to decide what kind of service to return or how to configure it.

By default, this method returns an instance of SameThreadHierarchicalTestExecutorService.

Overrides:

createExecutorService in class HierarchicalTestEngine<JupiterEngineExecutionContext>

Parameters:

request - the request about to be executed

See Also:

ForkJoinPoolHierarchicalTestExecutorService, SameThreadHierarchicalTestExecutorService

createExecutionContext

protected JupiterEngineExecutionContext createExecutionContext(ExecutionRequest request)

Description copied from class: HierarchicalTestEngine

Create the initial execution context for executing the supplied request.

Specified by:

createExecutionContext in class HierarchicalTestEngine<JupiterEngineExecutionContext>

Parameters:

request - the request about to be executed

Returns:

the initial context that will be passed to nodes in the hierarchy