org.mockito.internal.exceptions.stacktrace

Class StackTraceFilter

java.lang.Object

org.mockito.internal.exceptions.stacktrace.StackTraceFilter

All Implemented Interfaces:

Serializable

public class StackTraceFilter
extends Object
implements Serializable

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StackTraceFilter()

Method Summary

Modifier and Type	Method and Description
StackTraceElement[]	filter(StackTraceElement[] target, boolean keepTop) Example how the filter works (+/- means good/bad): [a+, b+, c-, d+, e+, f-, g+] -> [a+, b+, d+, e+, g+] Basically removes all bad from the middle.
StackTraceElement	filterFirst(Throwable target, boolean isInline) This filtering strategy makes use of a fast-path computation to retrieve stackTraceElements from a Stacktrace of a Throwable.
String	findSourceFile(StackTraceElement[] target, String defaultValue) Finds the source file of the target stack trace.

Methods inherited from class java.lang.Object

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

Constructor Detail

StackTraceFilter

public StackTraceFilter()

Method Detail

filter

public StackTraceElement[] filter(StackTraceElement[] target,
                                  boolean keepTop)

Example how the filter works (+/- means good/bad): [a+, b+, c-, d+, e+, f-, g+] -> [a+, b+, d+, e+, g+] Basically removes all bad from the middle. If any good are in the middle of bad those are also removed.

filterFirst

public StackTraceElement filterFirst(Throwable target,
                                     boolean isInline)

This filtering strategy makes use of a fast-path computation to retrieve stackTraceElements from a Stacktrace of a Throwable. It does so, by taking advantage of SharedSecrets and JavaLangAccess.

The SharedSecrets provides a method to obtain an instance of an JavaLangAccess. The latter class has a method to fast-path into Throwable.getStackTrace() and retrieve a single StackTraceElement. This prevents the JVM from having to generate a full stacktrace, which could potentially be expensive if stacktraces become very large.

Parameters:

target - The throwable target to find the first StackTraceElement that should not be filtered out per CLEANER.

Returns:

The first StackTraceElement outside of the CLEANER

findSourceFile

public String findSourceFile(StackTraceElement[] target,
                             String defaultValue)

Finds the source file of the target stack trace. Returns the default value if source file cannot be found.