com.rollbar.jvmti

Class ThrowableCache

java.lang.Object

com.rollbar.jvmti.ThrowableCache

public final class ThrowableCache
extends java.lang.Object

ThrowableCache is a mechanism for storing information from the native interface at the time of an exception which can be queried later by the notifier for enhancing payloads.

Method Summary

Modifier and Type	Method and Description
static void	add(java.lang.Throwable throwable, CacheFrame[] frames) Add a list of frames with extra information to the cache associated to this particular throwable.
static void	addAppPackage(java.lang.String newAppPackage) Add a string representing a package prefix to check against class names in stack traces to determine whether to cache throwables or not.
static CacheFrame[]	get(java.lang.Throwable throwable) Get the cached frames associated with the given throwable.
static boolean	shouldCacheThrowable(java.lang.Throwable throwable, int numFrames) Whether or not we should cache this throwable which has a particular number of frames in its stacktrace.

Methods inherited from class java.lang.Object

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

Method Detail

add

public static void add(java.lang.Throwable throwable,
                       CacheFrame[] frames)

Add a list of frames with extra information to the cache associated to this particular throwable.

Parameters:

throwable - a throwable to use as a cache key.

frames - frames associated with this throwable.

get

public static CacheFrame[] get(java.lang.Throwable throwable)

Get the cached frames associated with the given throwable.

Parameters:

throwable - a throwable to use as a cache key.

Returns:

the list of frames previously cached or null.

shouldCacheThrowable

public static boolean shouldCacheThrowable(java.lang.Throwable throwable,
                                           int numFrames)

Whether or not we should cache this throwable which has a particular number of frames in its stacktrace.

Parameters:

throwable - the throwable we might want to cache.

numFrames - the number of frames in the stacktrace.

Returns:

true if we should gather info about this throwable and cache it.

addAppPackage

public static void addAppPackage(java.lang.String newAppPackage)

Add a string representing a package prefix to check against class names in stack traces to determine whether to cache throwables or not.

Parameters:

newAppPackage - a string to add to the set of packages in your app.