net.sf.cuf.fw

Class EDTExceptionUtil

java.lang.Object

net.sf.cuf.fw.EDTExceptionUtil

All Implemented Interfaces:

Thread.UncaughtExceptionHandler

public class EDTExceptionUtil
extends Object
implements Thread.UncaughtExceptionHandler

Small helper to display unhandled exceptions and abort the application. Since CUF 2.0 (which requires Java 7) we use the UncaughtExceptionHandler mechanism, before that we used the sun.awt.exception.handler hack. We ignore all exceptions not coming out of the EDT.

To use, call install(), (optionally) provide your application with setApp(Application) and (optionally) configure your own error reporter with setFatalErrorReporter(FatalErrorReporter).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EDTExceptionUtil.DefaultFatalErrorReporter Default implementation of the error reporter, logs to System.err and tries to write the exception a file in the user directory.
static interface	EDTExceptionUtil.FatalErrorReporter Interface to provide error reporting

Constructor Summary

Constructors

Constructor and Description
EDTExceptionUtil() The EDT exception handling expects a public empty constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	handle(Throwable pThrowable) This method gets called when an Exception is caught in the EDT.
static void	install() installs the exception handler by registering the uncaught exception handler.
static void	setApp(Application pApp) Set back link to the application.
static void	setFatalErrorReporter(EDTExceptionUtil.FatalErrorReporter pFatalErrorReporter) Sets the fatal error reporter which is used to report an error.
static void	setVersion(String pDumpPrefix, String pVersion) Set application version string.
void	uncaughtException(Thread t, Throwable pThrowable)

Methods inherited from class java.lang.Object

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

Constructor Detail

EDTExceptionUtil

public EDTExceptionUtil()

The EDT exception handling expects a public empty constructor.

Method Detail

install

public static void install()

installs the exception handler by registering the uncaught exception handler.

setFatalErrorReporter

public static void setFatalErrorReporter(EDTExceptionUtil.FatalErrorReporter pFatalErrorReporter)

Sets the fatal error reporter which is used to report an error. You may provide your own fatal error handler to replace the default behavior of the DefaultFatalErrorReporter.

Parameters:

pFatalErrorReporter - the reporter, must not be null

setApp

public static void setApp(Application pApp)

Set back link to the application. If an error occurs, Application.doStop() will be called.

Parameters:

pApp - the application we are associated

setVersion

public static void setVersion(String pDumpPrefix,
              String pVersion)

Set application version string.

Parameters:

pDumpPrefix - for the dump file

pVersion - a version string for the application

uncaughtException

public void uncaughtException(Thread t,
                     Throwable pThrowable)

Specified by:

uncaughtException in interface Thread.UncaughtExceptionHandler

handle

public void handle(Throwable pThrowable)

This method gets called when an Exception is caught in the EDT.

Parameters:

pThrowable - caught Exception