com.microsoft.appcenter.crashes

Class AbstractCrashesListener

java.lang.Object

com.microsoft.appcenter.crashes.AbstractCrashesListener

All Implemented Interfaces:

CrashesListener

public abstract class AbstractCrashesListener
extends java.lang.Object
implements CrashesListener

Abstract class with default behaviors for the crashes listener.

Constructor Summary

Constructors

Constructor and Description
AbstractCrashesListener()

Method Summary

Modifier and Type	Method and Description
java.lang.Iterable<ErrorAttachmentLog>	getErrorAttachments(ErrorReport report) Called from a worker thread to get additional information to be sent as separate ErrorAttachmentLog logs Attachments are optional so this method can also return null.
void	onBeforeSending(ErrorReport report) Called from UI thread right before sending a crash report.
void	onSendingFailed(ErrorReport report, java.lang.Exception e) Called from UI thread when sending a crash report failed.
void	onSendingSucceeded(ErrorReport report) Called from UI thread when a crash report is sent successfully.
boolean	shouldAwaitUserConfirmation() Called from UI thread to determine whether it should wait for user confirmation before sending crash reports.
boolean	shouldProcess(ErrorReport report) Called from a worker thread to determine whether a crash report should be processed or not.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCrashesListener

public AbstractCrashesListener()

Method Detail

shouldProcess

public boolean shouldProcess(ErrorReport report)

Description copied from interface: CrashesListener

Called from a worker thread to determine whether a crash report should be processed or not.

Specified by:

shouldProcess in interface CrashesListener

Parameters:

report - A crash report that will be sent.

Returns:

true if it should be processed and sent, otherwise false.

shouldAwaitUserConfirmation

public boolean shouldAwaitUserConfirmation()

Description copied from interface: CrashesListener

Called from UI thread to determine whether it should wait for user confirmation before sending crash reports.

Specified by:

shouldAwaitUserConfirmation in interface CrashesListener

Returns:

true if it requires to be confirmed by a user, otherwise false. If this method returns true, Crashes.notifyUserConfirmation(int) must be called by yourself.

getErrorAttachments

public java.lang.Iterable<ErrorAttachmentLog> getErrorAttachments(ErrorReport report)

Description copied from interface: CrashesListener

Called from a worker thread to get additional information to be sent as separate ErrorAttachmentLog logs Attachments are optional so this method can also return null.

Specified by:

getErrorAttachments in interface CrashesListener

Parameters:

report - The crash report for additional information.

Returns:

instances of ErrorAttachmentLog to be sent for the specified error report.

onBeforeSending

public void onBeforeSending(ErrorReport report)

Description copied from interface: CrashesListener

Called from UI thread right before sending a crash report. The callback can be invoked multiple times based on the number of crash reports.

Specified by:

onBeforeSending in interface CrashesListener

Parameters:

report - The crash report that will be sent.

onSendingFailed

public void onSendingFailed(ErrorReport report,
                            java.lang.Exception e)

Description copied from interface: CrashesListener

Called from UI thread when sending a crash report failed. The report failed to send after the maximum retries so it will be discarded and won't be retried.

Specified by:

onSendingFailed in interface CrashesListener

Parameters:

report - The crash report that failed to send.

e - An exception that caused failure.

onSendingSucceeded

public void onSendingSucceeded(ErrorReport report)

Description copied from interface: CrashesListener

Called from UI thread when a crash report is sent successfully.

Specified by:

onSendingSucceeded in interface CrashesListener

Parameters:

report - The crash report that was sent successfully.