com.preemptive.instrumentation

Class ExceptionHandler

java.lang.Object

com.preemptive.instrumentation.ExceptionHandler

public final class ExceptionHandler
extends java.lang.Object

Utility methods to added uncaught exception handlers to the application or the thread. These handlers can automatically displays a dialog and request the information be sent to PA or just sent the exception message without interaction.

Additional methods are provided for displaying the dialog box separately.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addDefaultUncaughtExceptionDialog(java.lang.Object contextObject) Add an exception handler to the application that displays a dialog that allows the user to send an exception report to PA.
static void	addDefaultUncaughtExceptionDialog(java.lang.Object contextObject, BinaryInfo binary) Add an exception handler to the application that displays a dialog that allows the user to send an exception report to PA.
static void	addDefaultUncaughtExceptionHandler() Add an exception handler to the application that sends an exception report to PA.
static void	addDefaultUncaughtExceptionHandler(BinaryInfo binary) Add an exception handler to the application that sends an exception report to PA.
static void	addThreadUncaughtExceptionDialog(java.lang.Object contextObject) Add an exception handler to the current thread that displays a dialog that allows the user to send an exception report to PA.
static void	addThreadUncaughtExceptionDialog(java.lang.Object contextObject, BinaryInfo binary) Add an exception handler to the current thread that displays a dialog that allows the user to send an exception report to PA.
static void	addThreadUncaughtExceptionHandler() Add an exception handler to the current thread that sends an exception report to PA.
static void	addThreadUncaughtExceptionHandler(BinaryInfo binary) Add an exception handler to the current thread that sends an exception report to PA.
static void	showDialog(java.lang.Throwable exception) Display an exception dialog that allows the user to send an uncaught exception report to PA.
static void	showDialog(java.lang.Throwable exception, int type, java.lang.Object contextObject) Display an exception dialog that allows the user to send an exception report to PA.
static void	showDialog(java.lang.Throwable exception, int type, java.lang.Object contextObject, BinaryInfo binary, java.util.Properties properties) Display an exception dialog that allows the user to send an exception report to PA.
static void	showDialog(java.lang.Throwable exception, int type, java.lang.Object contextObject, java.util.Properties properties) Display an exception dialog that allows the user to send an exception report to PA.

Methods inherited from class java.lang.Object

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

Method Detail

showDialog

public static void showDialog(java.lang.Throwable exception)

Display an exception dialog that allows the user to send an uncaught exception report to PA. The user can add context and contact information about the error. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped.

Parameters:

exception - the exception to be reported

showDialog

public static void showDialog(java.lang.Throwable exception,
              int type,
              java.lang.Object contextObject)

Display an exception dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an uncaught Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped.

Parameters:

exception - the exception to be reported

type - the context type of the exception:

• RuntimeIntelligence.EXCEPTION_THROWN - the exception that is being thrown
• RuntimeIntelligence.EXCEPTION_CAUGHT - the exception that was caught
• RuntimeIntelligence.EXCEPTION_UNCAUGHT - the exception caught at the top level

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

showDialog

public static void showDialog(java.lang.Throwable exception,
              int type,
              java.lang.Object contextObject,
              java.util.Properties properties)

Display an exception dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an uncaught Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

exception - the exception to be reported

type - the context type of the exception:

• RuntimeIntelligence.EXCEPTION_THROWN - the exception that is being thrown
• RuntimeIntelligence.EXCEPTION_CAUGHT - the exception that was caught
• RuntimeIntelligence.EXCEPTION_UNCAUGHT - the exception caught at the top level

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

properties - properties to be sent with the exception report. May be null.

showDialog

public static void showDialog(java.lang.Throwable exception,
              int type,
              java.lang.Object contextObject,
              BinaryInfo binary,
              java.util.Properties properties)

Display an exception dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an uncaught Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped.

Parameters:

exception - the exception to be reported

type - the context type of the exception:

• RuntimeIntelligence.EXCEPTION_THROWN - an exception that is being thrown
• RuntimeIntelligence.EXCEPTION_CAUGHT - an exception that was caught
• RuntimeIntelligence.EXCEPTION_UNCAUGHT - an exception caught at the top level

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

binary - information about the application. May be null

properties - properties to be sent with the exception report. May be null.

addThreadUncaughtExceptionDialog

public static void addThreadUncaughtExceptionDialog(java.lang.Object contextObject)

Add an exception handler to the current thread that displays a dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

addThreadUncaughtExceptionDialog

public static void addThreadUncaughtExceptionDialog(java.lang.Object contextObject,
                                    BinaryInfo binary)

Add an exception handler to the current thread that displays a dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

binary - information about the application. May be null

addThreadUncaughtExceptionHandler

public static void addThreadUncaughtExceptionHandler()

Add an exception handler to the current thread that sends an exception report to PA. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

addThreadUncaughtExceptionHandler

public static void addThreadUncaughtExceptionHandler(BinaryInfo binary)

Add an exception handler to the current thread that sends an exception report to PA. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

binary - information about the application. May be null

addDefaultUncaughtExceptionDialog

public static void addDefaultUncaughtExceptionDialog(java.lang.Object contextObject)

Add an exception handler to the application that displays a dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

addDefaultUncaughtExceptionDialog

public static void addDefaultUncaughtExceptionDialog(java.lang.Object contextObject,
                                     BinaryInfo binary)

Add an exception handler to the application that displays a dialog that allows the user to send an exception report to PA. The user can add context and contact information about the error. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

contextObject - a context object typically a UI component used to determine the location to display the dialog. May be null.

binary - information about the application. May be null

addDefaultUncaughtExceptionHandler

public static void addDefaultUncaughtExceptionHandler()

Add an exception handler to the application that sends an exception report to PA. If the exception is an Error then the application will be terminated. After processing, the exception will be passed on to the previously registered handler if it exists. If an application session is not running, a session will be started to send this exception message, and then stopped.

addDefaultUncaughtExceptionHandler

public static void addDefaultUncaughtExceptionHandler(BinaryInfo binary)

Add an exception handler to the application that sends an exception report to PA. If the exception is an Error then the application will be terminated. If an application session is not running, a session will be started to send this exception message, and then stopped. After processing, the exception will be passed on to the previously registered handler if it exists.

Parameters:

binary - information about the application. May be null