JUnit 6.0.1 · org.junit.platform.commons.util.ExceptionUtils

Modifier and Type	Field and Description
private static final String	JUNIT_PLATFORM_LAUNCHER_PACKAGE_PREFIX
private static final Predicate<String>	STACK_TRACE_ELEMENT_FILTER

Access	Constructor and Description
private	ExceptionUtils()

Method Summary

Modifier and Type	Method and Description
public static List<Throwable>	Returns: an immutable list of all throwables found, including the supplied one; never `null` findNestedThrowables(Throwable the `Throwable` to explore; never `null` rootThrowable) Find all causes and suppressed exceptions in the stack trace of the supplied `Throwable`.
public static void	pruneStackTrace(Throwable the `Throwable` whose stack trace should be pruned; never `null` throwable, List<String> the class names that should stop the pruning if encountered; never `null` classNames) Prune the stack trace of the supplied `Throwable`.
public static String	readStackTrace(Throwable throwable) Read the stacktrace of the supplied `Throwable` into a String.
private static <T extends Throwable> T	throwAs(Throwable t)
public static RuntimeException	Returns: this method always throws an exception and therefore never returns anything; the return type is merely present to allow this method to be supplied as the operand in a `throw` statement throwAsUncheckedException(Throwable the `Throwable` to throw as an unchecked exception; never `null` t) Throw the supplied `Throwable`, masked as an unchecked exception.

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

JUNIT_PLATFORM_LAUNCHER_PACKAGE_PREFIX	back to summary
private static final String JUNIT_PLATFORM_LAUNCHER_PACKAGE_PREFIX

STACK_TRACE_ELEMENT_FILTER	back to summary
private static final Predicate<String> STACK_TRACE_ELEMENT_FILTER

ExceptionUtils	back to summary
private ExceptionUtils()

Method Detail

findNestedThrowables back to summary

findNestedThrowables	back to summary
public static List<Throwable> findNestedThrowables(Throwable rootThrowable) Find all causes and suppressed exceptions in the stack trace of the supplied `Throwable`. Parameters rootThrowable:Throwable the `Throwable` to explore; never `null` Returns:List<Throwable> an immutable list of all throwables found, including the supplied one; never `null` Annotations @API status:INTERNAL since:1.10 Since 1.10

public static List<Throwable> findNestedThrowables(Throwable rootThrowable)

Find all causes and suppressed exceptions in the stack trace of the supplied Throwable.

Parameters

rootThrowable:Throwable: the Throwable to explore; never null

Returns:List<Throwable>

an immutable list of all throwables found, including the supplied one; never null

Annotations

@API
status:INTERNAL
since:1.10

Since

1.10

pruneStackTrace back to summary

pruneStackTrace	back to summary
public static void pruneStackTrace(Throwable throwable, List<String> classNames) Prune the stack trace of the supplied `Throwable`. Prune all stack trace elements up one of the supplied `classNames` are pruned. All subsequent elements in the stack trace will be retained. If the `classNames` do not match any of the stacktrace elements then the `org.junit`, `jdk.internal.reflect`, and `sun.reflect` packages are pruned. Additionally, all elements prior to and including the first JUnit Platform Launcher call will be removed. Parameters throwable:Throwable the `Throwable` whose stack trace should be pruned; never `null` classNames:List<String> the class names that should stop the pruning if encountered; never `null` Annotations @API status:INTERNAL since:1.10 Since 1.10

public static void pruneStackTrace(Throwable throwable, List<String> classNames)

Prune the stack trace of the supplied Throwable.

Prune all stack trace elements up one of the supplied classNames are pruned. All subsequent elements in the stack trace will be retained.

If the classNames do not match any of the stacktrace elements then the org.junit, jdk.internal.reflect, and sun.reflect packages are pruned.

Additionally, all elements prior to and including the first JUnit Platform Launcher call will be removed.

Parameters

throwable:Throwable: the Throwable whose stack trace should be pruned; never null
classNames:List<String>: the class names that should stop the pruning if encountered; never null

Annotations

@API
status:INTERNAL
since:1.10

Since

1.10

readStackTrace	back to summary
public static String readStackTrace(Throwable throwable) Read the stacktrace of the supplied `Throwable` into a String.

throwAs	back to summary
private static <T extends Throwable> T throwAs(Throwable t) throws Throwable-:T Annotations @Contract:_ -> fail @SuppressWarnings:unchecked, TypeParameterUnusedInFormals

throwAsUncheckedException back to summary

throwAsUncheckedException	back to summary
public static RuntimeException throwAsUncheckedException(Throwable t) Throw the supplied `Throwable`, masked as an unchecked exception. The supplied `Throwable` will not be wrapped. Rather, it will be thrown as is using an exploit of the Java language that relies on a combination of generics and type erasure to trick the Java compiler into believing that the thrown exception is an unchecked exception even if it is a checked exception. Warning This method should be used sparingly. Parameters t:Throwable the `Throwable` to throw as an unchecked exception; never `null` Returns:RuntimeException this method always throws an exception and therefore never returns anything; the return type is merely present to allow this method to be supplied as the operand in a `throw` statement Annotations @Contract:_ -> fail

public static RuntimeException throwAsUncheckedException(Throwable t)

Throw the supplied Throwable, masked as an unchecked exception.

The supplied Throwable will not be wrapped. Rather, it will be thrown as is using an exploit of the Java language that relies on a combination of generics and type erasure to trick the Java compiler into believing that the thrown exception is an unchecked exception even if it is a checked exception.

Warning

This method should be used sparingly.

Parameters

t:Throwable: the Throwable to throw as an unchecked exception; never null

Returns:RuntimeException

this method always throws an exception and therefore never returns anything; the return type is merely present to allow this method to be supplied as the operand in a throw statement

Annotations

@Contract:_ -> fail

public final Class ExceptionUtils

DISCLAIMER

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

Warning