Module org.junit.jupiter.engine

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

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.
protected ThrowableCollector.Factory	createThrowableCollectorFactory(ExecutionRequest request)	Create the factory for creating ThrowableCollector instances used to handle exceptions that occur during execution of this engine's tests.
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

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

Constructor Details

JupiterTestEngine

public JupiterTestEngine()

Method Details

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.

Returns:

the ID of this test engine; never null or blank

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

createThrowableCollectorFactory

protected ThrowableCollector.Factory createThrowableCollectorFactory(ExecutionRequest request)

Description copied from class: HierarchicalTestEngine

Create the factory for creating ThrowableCollector instances used to handle exceptions that occur during execution of this engine's tests.

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

By default, this method returns a factory that always creates instances of OpenTest4JAwareThrowableCollector.

Overrides:

createThrowableCollectorFactory in class HierarchicalTestEngine<JupiterEngineExecutionContext>

Parameters:

request - the request about to be executed

Since:

5.4

See Also:

• OpenTest4JAwareThrowableCollector
• ThrowableCollector