org.junit.platform.engine.support.hierarchical

Interface Node.DynamicTestExecutor

All Known Implementing Classes:

NodeTestTask.DefaultDynamicTestExecutor

Enclosing interface:

Node<C extends EngineExecutionContext>

public static interface Node.DynamicTestExecutor

Executor for additional, dynamic test descriptors discovered during execution of a Node.

The test descriptors will be executed by the same HierarchicalTestExecutor that executes the submitting node.

This interface is not intended to be implemented by clients.

See Also:

Node.execute(EngineExecutionContext, DynamicTestExecutor), HierarchicalTestExecutor

Method Summary

Modifier and Type	Method and Description
void	awaitFinished() Block until all dynamic test descriptors submitted to this executor are finished.
void	execute(TestDescriptor testDescriptor) Submit a dynamic test descriptor for immediate execution.
java.util.concurrent.Future<?>	execute(TestDescriptor testDescriptor, EngineExecutionListener executionListener) Submit a dynamic test descriptor for immediate execution with a custom, potentially no-op, execution listener.

Method Detail

execute

void execute(TestDescriptor testDescriptor)

Submit a dynamic test descriptor for immediate execution.

Parameters:

testDescriptor - the test descriptor to be executed; never null

execute

@API(status=STABLE,
     since="1.10")
java.util.concurrent.Future<?> execute(TestDescriptor testDescriptor,
                                                                              EngineExecutionListener executionListener)

Submit a dynamic test descriptor for immediate execution with a custom, potentially no-op, execution listener.

Parameters:

testDescriptor - the test descriptor to be executed; never null

executionListener - the executionListener to be notified; never null

Returns:

a future to cancel or wait for the execution

Since:

1.7

See Also:

EngineExecutionListener.NOOP

awaitFinished

void awaitFinished()
            throws java.lang.InterruptedException

Block until all dynamic test descriptors submitted to this executor are finished.

This method is useful if the node needs to perform actions in its Node.execute(EngineExecutionContext, DynamicTestExecutor) method after all its dynamic children have finished.

Throws:

java.lang.InterruptedException - if interrupted while waiting