ExceptionParser
Stay organized with collections
Save and categorize content based on your preferences.
Known Indirect Subclasses
This class will capture the root cause (last
in a chain of causes) Throwable
and report the exception type, class name, method name and thread
name.
This interface is responsible for parsing a Throwable
and
providing a short, meaningful description to report to Google Analytics.
This class can be used in conjugation with the ExceptionReporter
.
UncaughtExceptionHandler myHandler = new ExceptionReporter(
myTracker, // Currently used Tracker
.
Thread.getDefaultUncaughtExceptionHandler(), // Current default uncaught exception handler.
context); // Context of the application.
myHandler.setExceptionParser(new MyExceptionParser());
// Where MyExceptionParser provides a custom description for various exceptions.
Public Methods
public abstract String
getDescription
( String
threadName, Throwable
t)
Return a short description of a Throwable
suitable for reporting to Google Analytics.
Parameters
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-31 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eExceptionParser\u003c/code\u003e interface is used to parse \u003ccode\u003eThrowable\u003c/code\u003e objects and provide concise descriptions for Google Analytics reporting.\u003c/p\u003e\n"],["\u003cp\u003eIt can be used with \u003ccode\u003eExceptionReporter\u003c/code\u003e to customize exception descriptions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetDescription\u003c/code\u003e method takes the thread name and \u003ccode\u003eThrowable\u003c/code\u003e as input and returns a short description of the exception.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eStandardExceptionParser\u003c/code\u003e is a default implementation that captures the root cause, exception type, class, method, and thread name.\u003c/p\u003e\n"]]],["The `ExceptionParser` interface parses a `Throwable` to generate a concise description for Google Analytics reporting. It has a `getDescription` method that accepts a thread name and a `Throwable` object. The `StandardExceptionParser` subclass captures the root cause of exceptions, including type, class, method, and thread name. It is used in conjunction with `ExceptionReporter` to handle uncaught exceptions, providing a way to customize exception descriptions through a custom `MyExceptionParser`.\n"],null,["# ExceptionParser\n\npublic interface **ExceptionParser** \n\n|---|---|---|\n| Known Indirect Subclasses [StandardExceptionParser](/android/reference/com/google/android/gms/analytics/StandardExceptionParser) |--------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [StandardExceptionParser](/android/reference/com/google/android/gms/analytics/StandardExceptionParser) | This class will capture the root cause (last in a chain of causes) [Throwable](//developer.android.com/reference/java/lang/Throwable.html) and report the exception type, class name, method name and thread name. | |||\n\nThis interface is responsible for parsing a [Throwable](//developer.android.com/reference/java/lang/Throwable.html) and\nproviding a short, meaningful description to report to Google Analytics.\n\nThis class can be used in conjugation with the [ExceptionReporter](/android/reference/com/google/android/gms/analytics/ExceptionReporter). \n\n\n UncaughtExceptionHandler myHandler = new ExceptionReporter(\n myTracker, // Currently used /android/reference/com/google/android/gms/analytics/Tracker.\n Thread.getDefaultUncaughtExceptionHandler(), // Current default uncaught exception handler.\n context); // Context of the application.\n\n myHandler.setExceptionParser(new MyExceptionParser());\n // Where MyExceptionParser provides a custom description for various exceptions.\n \n### Public Method Summary\n\n|----------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| abstract [String](//developer.android.com/reference/java/lang/String.html) | [getDescription](/android/reference/com/google/android/gms/analytics/ExceptionParser#getDescription(java.lang.String,%20java.lang.Throwable))([String](//developer.android.com/reference/java/lang/String.html) threadName, [Throwable](//developer.android.com/reference/java/lang/Throwable.html) t) Return a short description of a [Throwable](//developer.android.com/reference/java/lang/Throwable.html) suitable for reporting to Google Analytics. |\n\nPublic Methods\n--------------\n\n#### public abstract [String](//developer.android.com/reference/java/lang/String.html) **getDescription** ([String](//developer.android.com/reference/java/lang/String.html) threadName, [Throwable](//developer.android.com/reference/java/lang/Throwable.html) t)\n\nReturn a short description of a [Throwable](//developer.android.com/reference/java/lang/Throwable.html)\nsuitable for reporting to Google Analytics. \n\n##### Parameters\n\n| threadName | the name of the [Thread](//developer.android.com/reference/java/lang/Thread.html) that got the exception, or null |\n| t | the [Throwable](//developer.android.com/reference/java/lang/Throwable.html) |\n|------------|-------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- the description"]]