Package com.microsoft.appcenter.crashes

Class AbstractCrashesListener

  • All Implemented Interfaces:
    CrashesListener
    public abstract class AbstractCrashesListener
extends java.lang.Object
implements CrashesListener
    Abstract class with default behaviors for the crashes listener.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method 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.