Brooklyn

brooklyn.util.javalang
[Java] Class StackTraceSimplifier

java.lang.Object
  brooklyn.util.javalang.StackTraceSimplifier

public class StackTraceSimplifier

Utility class for cleaning up stacktraces.


Field Summary
static java.lang.String DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

comma-separated prefixes (not regexes)

static java.lang.String LEGACY_DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

@deprecated since 0.6.0 use DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

 
Constructor Summary
protected StackTraceSimplifier()

protected StackTraceSimplifier(boolean includeDefaultBlacklist, java.lang.String... packages)

 
Method Summary
java.util.List clean(java.lang.Iterable st)

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

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

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

static java.util.List cleanStackTrace(java.lang.Iterable st)

static convenience for clean(Iterable)

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

static convenience for clean(StackTraceElement[])

java.lang.Object cleaned(java.lang.Object t)

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

static java.lang.Object cleanedStackTrace(java.lang.Object t)

static convenience for cleaned(Throwable)

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

@return first isUseful(StackTraceElement) stack trace elements, or null

static boolean isStackTraceElementUseful(java.lang.StackTraceElement el)

static convenience for isUseful(StackTraceElement)

boolean isUseful(java.lang.StackTraceElement el)

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

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)

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

 
Methods inherited from class java.lang.Object
java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()
 

Field Detail

DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

public static final java.lang.String DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME
comma-separated prefixes (not regexes)


LEGACY_DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME

@Deprecated
public static final java.lang.String LEGACY_DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME
deprecated:
since 0.6.0 use DEFAULT_BLACKLIST_SYSTEM_PROPERTY_NAME


 
Constructor Detail

StackTraceSimplifier

protected StackTraceSimplifier()


StackTraceSimplifier

protected StackTraceSimplifier(boolean includeDefaultBlacklist, java.lang.String... packages)


 
Method Detail

clean

public java.util.List clean(java.lang.Iterable 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


cleanStackTrace

public static java.util.List cleanStackTrace(java.lang.Iterable st)
static convenience for clean(Iterable)


cleanStackTrace

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


cleaned

public java.lang.Object cleaned(java.lang.Object t)
clean(StackTraceElement[]) the given throwable instance, returning the same instance for convenience


cleanedStackTrace

public static java.lang.Object cleanedStackTrace(java.lang.Object t)
static convenience for cleaned(Throwable)


firstUseful

public java.lang.StackTraceElement firstUseful(java.lang.StackTraceElement[] st)
Returns:
first isUseful(StackTraceElement) stack trace elements, or null


isStackTraceElementUseful

public static boolean isStackTraceElementUseful(java.lang.StackTraceElement el)
static convenience for isUseful(StackTraceElement)


isUseful

public boolean isUseful(java.lang.StackTraceElement el)
Returns:
whether the given element is useful, that is, not in the blacklist


newInstance

public static StackTraceSimplifier newInstance()


newInstance

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


newInstanceExcludingOnly

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


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


 

Brooklyn Multi-Cloud Application Management Platform
brooklyncentral.github.com. Apache License. © 2012.