com.percolate.foam

Class CustomExceptionHandler

java.lang.Object

com.percolate.foam.CustomExceptionHandler

All Implemented Interfaces:

java.lang.Thread.UncaughtExceptionHandler

class CustomExceptionHandler
extends java.lang.Object
implements java.lang.Thread.UncaughtExceptionHandler

Foam's custom exception handler. Sets the application exception handler via Thread.setDefaultUncaughtExceptionHandler(). If an uncaught exception is triggered, we store the exception in application specific storage. No app permissions are required since it uses internal storage. When the application is restarted, the stored exceptions will be processed (sent to any of the available services that are configured to receive crash data). We can't send crash reports immediately, because that would mean doing network requests when the app is trying to close from the crash. This object will not override other custom exception handlers. It will chain with them. Eg: if another crash reporting tool is configured, both custom exception handlers will run in the reverse order they are initiated.

Field Summary

Fields

Modifier and Type	Field and Description
private android.content.Context	context
(package private) java.lang.Thread.UncaughtExceptionHandler	defaultHandler
(package private) ExceptionPersister	exceptionPersister
private java.util.List<CrashReportingService>	services
(package private) Utils	utils
private boolean	wifiOnly

Constructor Summary

Constructors

Constructor and Description
CustomExceptionHandler(android.content.Context context, java.util.List<CrashReportingService> crashReportingServices, boolean wifiOnly)

Method Summary

Modifier and Type	Method and Description
(package private) java.lang.String	getStackTraceString(java.lang.Throwable ex) Return String version of the stacktrace for a Throwable.
(package private) java.util.Map<java.lang.String,StoredException>	getStoredExceptions() Get all stored exceptions.
(package private) boolean	isRunning() Used to check if this class is already running.
(package private) void	sendStoredExceptions() Iterate through any stored exception files that have not been successfully sent.
(package private) void	start() Change application exception handler to our own (this class).
(package private) void	stop() Unregister this class as the default uncaught exception handler.
(package private) void	storeException(java.lang.Thread thread, java.lang.Throwable ex) Create a StoredException object for the passed in Thread and Throwable.
void	uncaughtException(java.lang.Thread thread, java.lang.Throwable ex) Handle uncaught exceptions.

Methods inherited from class java.lang.Object

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

Field Detail

context

private android.content.Context context

utils

Utils utils

services

private java.util.List<CrashReportingService> services

wifiOnly

private boolean wifiOnly

exceptionPersister

ExceptionPersister exceptionPersister

defaultHandler

java.lang.Thread.UncaughtExceptionHandler defaultHandler

Constructor Detail

CustomExceptionHandler

CustomExceptionHandler(android.content.Context context,
                       java.util.List<CrashReportingService> crashReportingServices,
                       boolean wifiOnly)

Method Detail

start

void start()

Change application exception handler to our own (this class). Send any stored exceptions that were caught last time.

stop

void stop()

Unregister this class as the default uncaught exception handler.

uncaughtException

public void uncaughtException(java.lang.Thread thread,
                              java.lang.Throwable ex)

Handle uncaught exceptions. Thread.UncaughtExceptionHandler interface method. Here, for each service that the user has enabled, we will store a local copy of the crash data.

Specified by:

uncaughtException in interface java.lang.Thread.UncaughtExceptionHandler

storeException

void storeException(java.lang.Thread thread,
                    java.lang.Throwable ex)

Create a StoredException object for the passed in Thread and Throwable. Use our ExceptionPersister class to store this data on the device.

Parameters:

thread - Thread that generated the exception

ex - Exception data.

getStackTraceString

java.lang.String getStackTraceString(java.lang.Throwable ex)

Return String version of the stacktrace for a Throwable.

Parameters:

ex - Throwable to convert to a String.

Returns:

String version of the stacktrace.

sendStoredExceptions

void sendStoredExceptions()

Iterate through any stored exception files that have not been successfully sent. Send them to their corresponding service.

getStoredExceptions

java.util.Map<java.lang.String,StoredException> getStoredExceptions()

Get all stored exceptions.

Returns:

Map containing <file name, exception data>.

isRunning

boolean isRunning()

Used to check if this class is already running.

Returns:

true if this class is registered as the default uncaught exception handler.