Nested and Inner Type Summary

Modifier and Type	Class and Description
public static interface	ThrowableCollector.Executable Functional interface for an executable block of code that may throw a `Throwable`.
public static interface	ThrowableCollector.Factory Factory for `ThrowableCollector` instances.

Field Summary

Modifier and Type	Field and Description
private final Predicate<? super Throwable>	abortedExecutionPredicate
private Throwable	throwable

Constructor Summary

Access	Constructor and Description
public	ThrowableCollector(Predicate<? super Throwable> the predicate used to decide whether a `Throwable` aborted execution; never `null`. abortedExecutionPredicate) Create a new `ThrowableCollector` that uses the supplied `Predicate` to determine whether a `Throwable` aborted or failed execution.

Method Summary

Modifier and Type	Method and Description
private void	add(Throwable the `Throwable` to add t) Add the supplied `Throwable` to this `ThrowableCollector`.
public void	assertEmpty() Assert that this `ThrowableCollector` is empty (i.e., has not collected any `Throwables`).
public void	execute(ThrowableCollector.Executable the `Executable` to execute executable) Execute the supplied `Executable` and collect any `Throwable` thrown during the execution.
public Throwable	Returns: the first collected `Throwable` or `null` if this `ThrowableCollector` is empty getThrowable() Get the first `Throwable` collected by this `ThrowableCollector`.
private boolean	hasAbortedExecution(Throwable t)
public boolean	isEmpty() Determine if this `ThrowableCollector` is empty (i.e., has not collected any `Throwables`).
public boolean	isNotEmpty() Determine if this `ThrowableCollector` is not empty (i.e., has collected at least one `Throwable`).
public TestExecutionResult	Returns: aborted if the collected `Throwable` aborted execution; failed if it failed execution; and successful otherwise toTestExecutionResult() Convert the collected `Throwables` into a `TestExecutionResult`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

abortedExecutionPredicate	back to summary
private final Predicate<? super Throwable> abortedExecutionPredicate

throwable	back to summary
private Throwable throwable

Constructor Detail

ThrowableCollector back to summary

ThrowableCollector	back to summary
public ThrowableCollector(Predicate<? super Throwable> abortedExecutionPredicate) Create a new `ThrowableCollector` that uses the supplied `Predicate` to determine whether a `Throwable` aborted or failed execution. Parameters abortedExecutionPredicate:Predicate<? super Throwable> the predicate used to decide whether a `Throwable` aborted execution; never `null`.

public ThrowableCollector(Predicate<? super Throwable> abortedExecutionPredicate)

Create a new ThrowableCollector that uses the supplied Predicate to determine whether a Throwable aborted or failed execution.

Parameters

abortedExecutionPredicate:Predicate<? super Throwable>: the predicate used to decide whether a Throwable aborted execution; never null.

Method Detail

add back to summary

add	back to summary
private void add(Throwable t) Add the supplied `Throwable` to this `ThrowableCollector`. Parameters t:Throwable the `Throwable` to add See Also `execute(Executable)`, `assertEmpty()`

private void add(Throwable t)

Add the supplied Throwable to this ThrowableCollector.

Parameters

t:Throwable: the Throwable to add

See Also

execute(Executable), assertEmpty()

assertEmpty back to summary

assertEmpty	back to summary
public void assertEmpty() Assert that this `ThrowableCollector` is empty (i.e., has not collected any `Throwables`). If this collector is not empty, the first collected `Throwable` will be thrown with any additional `Throwables` suppressed in the first `Throwable`. Note, however, that the `Throwable` will not be wrapped. Rather, it will be masked as an unchecked exception. See Also `getThrowable()`, `ExceptionUtils#throwAsUncheckedException(Throwable)`

public void assertEmpty()

Assert that this ThrowableCollector is empty (i.e., has not collected any Throwables).

If this collector is not empty, the first collected Throwable will be thrown with any additional Throwables suppressed in the first Throwable. Note, however, that the Throwable will not be wrapped. Rather, it will be masked as an unchecked exception.

See Also: getThrowable(), ExceptionUtils#throwAsUncheckedException(Throwable)

execute back to summary

execute	back to summary
public void execute(ThrowableCollector.Executable executable) Execute the supplied `Executable` and collect any `Throwable` thrown during the execution. If the `Executable` throws an unrecoverable exception — for example, an `OutOfMemoryError` — this method will rethrow it. Parameters executable:ThrowableCollector.Executable the `Executable` to execute See Also `assertEmpty()`

public void execute(ThrowableCollector.Executable executable)

Execute the supplied Executable and collect any Throwable thrown during the execution.

If the Executable throws an unrecoverable exception — for example, an OutOfMemoryError — this method will rethrow it.

Parameters

executable:ThrowableCollector.Executable: the Executable to execute

See Also

assertEmpty()

getThrowable back to summary

getThrowable	back to summary
public Throwable getThrowable() Get the first `Throwable` collected by this `ThrowableCollector`. If this collector is not empty, the first collected `Throwable` will be returned with any additional `Throwables` suppressed in the first `Throwable`. If the first collected `Throwable` aborted execution and at least one later collected `Throwable` failed execution, the first failing `Throwable` will be returned with the previous aborting and any additional `Throwables` suppressed inside. Returns:Throwable the first collected `Throwable` or `null` if this `ThrowableCollector` is empty See Also `isEmpty()`, `assertEmpty()`

public Throwable getThrowable()

Get the first Throwable collected by this ThrowableCollector.

If this collector is not empty, the first collected Throwable will be returned with any additional Throwables suppressed in the first Throwable.

If the first collected Throwable aborted execution and at least one later collected Throwable failed execution, the first failing Throwable will be returned with the previous aborting and any additional Throwables suppressed inside.

Returns:Throwable: the first collected Throwable or null if this ThrowableCollector is empty
See Also: isEmpty(), assertEmpty()

hasAbortedExecution	back to summary
private boolean hasAbortedExecution(Throwable t)

isEmpty	back to summary
public boolean isEmpty() Determine if this `ThrowableCollector` is empty (i.e., has not collected any `Throwables`).

isNotEmpty	back to summary
public boolean isNotEmpty() Determine if this `ThrowableCollector` is not empty (i.e., has collected at least one `Throwable`).

toTestExecutionResult back to summary

toTestExecutionResult	back to summary
public TestExecutionResult toTestExecutionResult() Convert the collected `Throwables` into a `TestExecutionResult`. Returns:TestExecutionResult aborted if the collected `Throwable` aborted execution; failed if it failed execution; and successful otherwise Annotations @API status:MAINTAINED since:1.6 Since 1.6

public TestExecutionResult toTestExecutionResult()

Convert the collected Throwables into a TestExecutionResult.

Returns:TestExecutionResult

aborted if the collected Throwable aborted execution; failed if it failed execution; and successful otherwise

Annotations

@API
status:MAINTAINED
since:1.6

Since

1.6

org.junit.platform.engine.support.hierarchical back to summary

public Interface ThrowableCollector.Executable

Annotations

@FunctionalInterface

Functional interface for an executable block of code that may throw a Throwable.

Method Summary

Modifier and Type	Method and Description
public void	execute() Execute this executable, potentially throwing a `Throwable` that signals abortion or failure.

Method Detail

execute	back to summary
public void execute() throws Throwable Execute this executable, potentially throwing a `Throwable` that signals abortion or failure.

org.junit.platform.engine.support.hierarchical back to summary

public Interface ThrowableCollector.Factory

Factory for ThrowableCollector instances.

Method Summary

Modifier and Type	Method and Description
public ThrowableCollector	create() Create a new instance of a `ThrowableCollector`.

Method Detail

create	back to summary
public ThrowableCollector create() Create a new instance of a `ThrowableCollector`.

public Class ThrowableCollector

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface ThrowableCollector.Executable

Method Summary

Method Detail

public Interface ThrowableCollector.Factory

Method Summary

Method Detail