StandardExceptionParser

public class StandardExceptionParser extendsObject
implements ExceptionParser

This class will capture the root cause (last in a chain of causes)Throwableand report the exception type, class name, method name and thread name.

This class will attempt to report a class and method name that is relevant to the application if at all possible. It does this by finding the root causeThrowable,then checking each StackTraceElementfor a class that is in a package list created bysetIncludedPackages(Context, Collection),starting with the firstStackTraceElement.

TheStringreturned bygetDescription(String, Throwable)will take the form Exception class(@classname:methodname){threadname}.

SeegetBestStackTraceElement(Throwable)andsetIncludedPackages(Context, Collection)for details.

Public Constructor Summary

StandardExceptionParser(Contextcontext,Collection<String> additionalPackages)

Public Method Summary

String	getDescription(StringthreadName,Throwablet) Return a short description of a`Throwable`suitable for reporting to Google Analytics.
void	setIncludedPackages(Contextcontext,Collection<String> additionalPackages) Sets the list of packages considered relevant to the list of packages in the`Context` and the list of packages provided in the input parameter`additionalPackages`.

Protected Method Summary

StackTraceElement	getBestStackTraceElement(Throwablet) Return the first`StackTraceElement`found that has a className in any packageName found in`includedPackages`.
Throwable	getCause(Throwablet) Get the root cause of the input`Throwable`.
String	getDescription(Throwablecause,StackTraceElementelement,StringthreadName) Given input of a`Throwable`,a`StackTraceElement`and the name of the`Thread`,return a`String`describing the`Throwable`and the name of the`Class`and method where the`Throwable`happened.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Objectarg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface com.google.android.gms.analytics.ExceptionParser

abstract String

getDescription(StringthreadName,Throwablet)

Return a short description of aThrowablesuitable for reporting to Google Analytics.

Public Constructors

public StandardExceptionParser (Contextcontext,Collection<String> additionalPackages)

Public Methods

public String getDescription (StringthreadName,Throwablet)

Return a short description of aThrowablesuitable for reporting to Google Analytics.

Parameters

threadName	the name of the`Thread`that got the exception, or null
t	the`Throwable`

Returns

the description

public void setIncludedPackages (Contextcontext,Collection<String> additionalPackages)

Sets the list of packages considered relevant to the list of packages in theContext and the list of packages provided in the input parameteradditionalPackages.Either parameter can be null.

Any package names stored from a previous call to this method will be cleared.

Parameters

context	any`Context`for the application
additionalPackages	a collection of additional package names to add

Protected Methods

protected StackTraceElement getBestStackTraceElement (Throwablet)

Return the firstStackTraceElementfound that has a className in any packageName found inincludedPackages.If none have a className in any packageName found inincludedPackages,return the firstStackTraceElementfound. If theThrowable does not contain anyStackTraceElements, return null.

protected Throwable getCause (Throwablet)

Get the root cause of the inputThrowable.This method chains through each cause of the original input and returns the last cause in the chain.

Parameters

t	the initial`Throwable`

Returns

the root cause

protected String getDescription (Throwablecause,StackTraceElementelement,StringthreadName)

Given input of aThrowable,aStackTraceElementand the name of theThread,return aStringdescribing theThrowableand the name of theClassand method where theThrowablehappened. TheStringreturned will also have the name of the thread appended (as provided in the input parameter threadName).