org.apache.brooklyn.util.javalang

Class StackTraceSimplifier

java.lang.Object

org.apache.brooklyn.util.javalang.StackTraceSimplifier

public class StackTraceSimplifier
extends java.lang.Object

Utility class for cleaning up stacktraces.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME comma-separated prefixes (not regexes)

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.StackTraceElement>	clean(java.lang.Iterable<java.lang.StackTraceElement> st)
java.lang.StackTraceElement[]	clean(java.lang.StackTraceElement[] st)
<T extends java.lang.Throwable> T	cleaned(T t) clean(StackTraceElement[]) the given throwable instance, returning the same instance for convenience
static <T extends java.lang.Throwable> T	cleanedStackTrace(T t) static convenience for cleaned(Throwable)
static java.util.List<java.lang.StackTraceElement>	cleanStackTrace(java.lang.Iterable<java.lang.StackTraceElement> st) static convenience for clean(Iterable)
static java.lang.StackTraceElement[]	cleanStackTrace(java.lang.StackTraceElement[] st) static convenience for clean(StackTraceElement[])
java.lang.StackTraceElement	firstUseful(java.lang.StackTraceElement[] st)
static int	getRecursiveCallCount() returns the number of times the calling method occurs elsewhere in the stack trace; 0 if no recursion, 1 if it has cycled three times, etc.
static boolean	isStackTraceElementUseful(java.lang.StackTraceElement el) static convenience for isUseful(StackTraceElement)
boolean	isUseful(java.lang.StackTraceElement el)
static StackTraceSimplifier	newInstance()
static StackTraceSimplifier	newInstance(java.lang.String... additionalBlacklistPackagePrefixes)
static StackTraceSimplifier	newInstanceExcludingOnly(java.lang.String... blacklistPackagePrefixes)
java.lang.StackTraceElement	nthUseful(int n, java.lang.StackTraceElement[] st)
static java.lang.String	toString(java.lang.Throwable t)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

public static final java.lang.String DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

comma-separated prefixes (not regexes)

See Also:

Constant Field Values

Method Detail

newInstance

public static StackTraceSimplifier newInstance()

newInstance

public static StackTraceSimplifier newInstance(java.lang.String... additionalBlacklistPackagePrefixes)

newInstanceExcludingOnly

public static StackTraceSimplifier newInstanceExcludingOnly(java.lang.String... blacklistPackagePrefixes)

isUseful

public boolean isUseful(java.lang.StackTraceElement el)

Returns:

whether the given element is useful, that is, not in the blacklist

clean

public java.util.List<java.lang.StackTraceElement> clean(java.lang.Iterable<java.lang.StackTraceElement> st)

Returns:

new list containing just the isUseful(StackTraceElement) stack trace elements

clean

public java.lang.StackTraceElement[] clean(java.lang.StackTraceElement[] st)

Returns:

new array containing just the isUseful(StackTraceElement) stack trace elements

firstUseful

public java.lang.StackTraceElement firstUseful(java.lang.StackTraceElement[] st)

Returns:

first isUseful(StackTraceElement) stack trace elements, or null

nthUseful

public java.lang.StackTraceElement nthUseful(int n,
                                             java.lang.StackTraceElement[] st)

Returns:

(n+1)th isUseful(StackTraceElement) stack trace elements (ie 0 is firstUseful(StackTraceElement[])), or null

cleaned

public <T extends java.lang.Throwable> T cleaned(T t)

clean(StackTraceElement[]) the given throwable instance, returning the same instance for convenience

isStackTraceElementUseful

public static boolean isStackTraceElementUseful(java.lang.StackTraceElement el)

static convenience for isUseful(StackTraceElement)

cleanStackTrace

public static java.util.List<java.lang.StackTraceElement> cleanStackTrace(java.lang.Iterable<java.lang.StackTraceElement> st)

static convenience for clean(Iterable)

cleanStackTrace

public static java.lang.StackTraceElement[] cleanStackTrace(java.lang.StackTraceElement[] st)

static convenience for clean(StackTraceElement[])

cleanedStackTrace

public static <T extends java.lang.Throwable> T cleanedStackTrace(T t)

static convenience for cleaned(Throwable)

toString

public static java.lang.String toString(java.lang.Throwable t)

getRecursiveCallCount

public static int getRecursiveCallCount()

returns the number of times the calling method occurs elsewhere in the stack trace; 0 if no recursion, 1 if it has cycled three times, etc.