at.favre.lib.planb.interfaces

Interface CrashRecoverBehaviour

All Known Implementing Classes:

BaseCrashBehaviour, DefaultBehavior, StartActivityBehaviour, SuppressCrashBehaviour

public interface CrashRecoverBehaviour

Interface for the recovery behaviour. Will define what exactly happens when an unhandled crash was encountered.

Basic process like persisting the crash data and killing the process will be done within the framework and configured with this interface.

Use the pre and post handler to easily modify ready to use implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	CrashRecoverBehaviour.CrashAction A crash action used with getPreCrashAction() and getPostCrashAction()

Method Summary

Modifier and Type	Method and Description
boolean	callDefaultExceptionHandler() If the default exception handler should be called.
CrashRecoverBehaviour.CrashAction	getPostCrashAction() Set an action before the handleCrash(Context, Thread, Throwable, CrashData, PlanBConfig)
CrashRecoverBehaviour.CrashAction	getPreCrashAction() Set an action before the handleCrash(Context, Thread, Throwable, CrashData, PlanBConfig)
void	handleCrash(android.content.Context context, java.lang.Thread thread, java.lang.Throwable throwable, CrashData crashData, PlanBConfig config) The main crash handle call.
boolean	killProcess() If the process should be killed after handling the crash.
boolean	persistCrashData() If the crash data should be persisted with the CrashDataHandler

Method Detail

killProcess

boolean killProcess()

If the process should be killed after handling the crash. This is activated in most cases.

Returns:

if the process should be killed after handling

callDefaultExceptionHandler

boolean callDefaultExceptionHandler()

If the default exception handler should be called. Android's default handler will just show a dialog. However if you use other crash frameworks you may want to call the default.

Returns:

if the default exception handler should be called

persistCrashData

boolean persistCrashData()

If the crash data should be persisted with the CrashDataHandler

Returns:

true if should be persisted

handleCrash

void handleCrash(android.content.Context context,
                 java.lang.Thread thread,
                 java.lang.Throwable throwable,
                 CrashData crashData,
                 PlanBConfig config)

The main crash handle call. Implement with your own custom behaviour.

Parameters:

context -

thread - of the crash

throwable - the crashes's throwable class

crashData - the crash data of this crash

config - current config of the lib

getPreCrashAction

CrashRecoverBehaviour.CrashAction getPreCrashAction()

Set an action before the handleCrash(Context, Thread, Throwable, CrashData, PlanBConfig)

Returns:

the action, must not be null

getPostCrashAction

CrashRecoverBehaviour.CrashAction getPostCrashAction()

Set an action before the handleCrash(Context, Thread, Throwable, CrashData, PlanBConfig)

Returns:

the action, must not be null