com.microsoft.appcenter.crashes

Class WrapperSdkExceptionManager

java.lang.Object

com.microsoft.appcenter.crashes.WrapperSdkExceptionManager

public class WrapperSdkExceptionManager
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static void	deleteWrapperExceptionData(java.util.UUID errorId) Delete wrapper exception data from disk and store it in memory
static com.microsoft.appcenter.utils.async.AppCenterFuture<java.util.Collection<ErrorReport>>	getUnprocessedErrorReports() Get unprocessed error reports when automatic processing is disabled.
static byte[]	loadWrapperExceptionData(java.util.UUID errorId) Load wrapper exception data into memory
static java.util.UUID	saveWrapperException(java.lang.Thread thread, java.lang.Throwable throwable, Exception modelException, byte[] rawSerializedException) Save a crash from wrapper SDK.
static com.microsoft.appcenter.utils.async.AppCenterFuture<java.lang.Boolean>	sendCrashReportsOrAwaitUserConfirmation(java.util.Collection<java.lang.String> filteredReportIds) Resume processing of crash reports with the filtered list from getUnprocessedErrorReports().
static void	sendErrorAttachments(java.lang.String errorReportId, java.lang.Iterable<ErrorAttachmentLog> attachments) Send error attachments when automatic processing is disabled.
static void	setAutomaticProcessing(boolean automaticProcessing) Set whether automatic processing is enabled or not.
static void	trackException(Exception modelException) Send an handled exception (used by wrapper SDKs).
static void	trackException(Exception modelException, java.util.Map<java.lang.String,java.lang.String> properties) Send an handled exception (used by wrapper SDKs).

Methods inherited from class java.lang.Object

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

Method Detail

saveWrapperException

public static java.util.UUID saveWrapperException(java.lang.Thread thread,
                                                  java.lang.Throwable throwable,
                                                  Exception modelException,
                                                  byte[] rawSerializedException)

Save a crash from wrapper SDK.

Parameters:

thread - thread where uncaught exception originated.

throwable - Java throwable for client side inspection if available, can be null.

modelException - model exception.

rawSerializedException - raw exception bytes if available, can be null.

Returns:

error log identifier if successful or null if failed to save to disk.

deleteWrapperExceptionData

public static void deleteWrapperExceptionData(java.util.UUID errorId)

Delete wrapper exception data from disk and store it in memory

Parameters:

errorId - The associated error UUID

loadWrapperExceptionData

public static byte[] loadWrapperExceptionData(java.util.UUID errorId)

Load wrapper exception data into memory

Parameters:

errorId - The associated error UUID

Returns:

The data loaded into memory

trackException

public static void trackException(Exception modelException)

Send an handled exception (used by wrapper SDKs).

Parameters:

modelException - An handled exception already in JSON model form.

trackException

public static void trackException(Exception modelException,
                                  java.util.Map<java.lang.String,java.lang.String> properties)

Send an handled exception (used by wrapper SDKs).

Parameters:

modelException - An handled exception already in JSON model form.

properties - optional properties.

setAutomaticProcessing

public static void setAutomaticProcessing(boolean automaticProcessing)

Set whether automatic processing is enabled or not. Default is enabled.

Parameters:

automaticProcessing - true to enable, false otherwise.

getUnprocessedErrorReports

public static com.microsoft.appcenter.utils.async.AppCenterFuture<java.util.Collection<ErrorReport>> getUnprocessedErrorReports()

Get unprocessed error reports when automatic processing is disabled.

Returns:

unprocessed error reports as an async future.

sendCrashReportsOrAwaitUserConfirmation

public static com.microsoft.appcenter.utils.async.AppCenterFuture<java.lang.Boolean> sendCrashReportsOrAwaitUserConfirmation(java.util.Collection<java.lang.String> filteredReportIds)

Resume processing of crash reports with the filtered list from getUnprocessedErrorReports(). To use when automatic processing is disabled.

Parameters:

filteredReportIds - report identifiers to process, every crash not part of the original list are discarded.

Returns:

asynchronous result: true if ALWAYS_SEND was previously set, false otherwise.

sendErrorAttachments

public static void sendErrorAttachments(java.lang.String errorReportId,
                                        java.lang.Iterable<ErrorAttachmentLog> attachments)

Send error attachments when automatic processing is disabled.

Parameters:

errorReportId - The crash report identifier for additional information.

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