java.lang
Interface Thread.UncaughtExceptionHandler

All Known Implementing Classes:
ThreadGroup sample code for java.lang.ThreadGroup definition code for java.lang.ThreadGroup
Enclosing class:
Thread sample code for java.lang.Thread definition code for java.lang.Thread

public static interface Thread.UncaughtExceptionHandler

Interface for handlers invoked when a Thread abruptly terminates due to an uncaught exception.

When a thread is about to terminate due to an uncaught exception the Java Virtual Machine will query the thread for its UncaughtExceptionHandler using Thread.getUncaughtExceptionHandler() sample code for java.lang.Thread.getUncaughtExceptionHandler() definition code for java.lang.Thread.getUncaughtExceptionHandler() and will invoke the handler's uncaughtException method, passing the thread and the exception as arguments. If a thread has not had its UncaughtExceptionHandler explicitly set, then its ThreadGroup object acts as its UncaughtExceptionHandler. If the ThreadGroup object has no special requirements for dealing with the exception, it can forward the invocation to the default uncaught exception handler sample code for java.lang.Thread.getDefaultUncaughtExceptionHandler() definition code for java.lang.Thread.getDefaultUncaughtExceptionHandler() .

Since:
1.5
See Also:
Thread.setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) sample code for java.lang.Thread.setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) definition code for java.lang.Thread.setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) , Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) sample code for java.lang.Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) definition code for java.lang.Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) , ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable) sample code for java.lang.ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable) definition code for java.lang.ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable)

Method Summary
 void uncaughtException sample code for java.lang.Thread.UncaughtExceptionHandler.uncaughtException(java.lang.Thread, java.lang.Throwable) definition code for java.lang.Thread.UncaughtExceptionHandler.uncaughtException(java.lang.Thread, java.lang.Throwable) (Thread sample code for java.lang.Thread definition code for java.lang.Thread  t, Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  e)
          Method invoked when the given thread terminates due to the given uncaught exception.
 

Method Detail

uncaughtException sample code for java.lang.Thread.UncaughtExceptionHandler.uncaughtException(java.lang.Thread, java.lang.Throwable) definition code for java.lang.Thread.UncaughtExceptionHandler.uncaughtException(java.lang.Thread, java.lang.Throwable)

void uncaughtException(Thread sample code for java.lang.Thread definition code for java.lang.Thread  t,
                       Throwable sample code for java.lang.Throwable definition code for java.lang.Throwable  e)
Method invoked when the given thread terminates due to the given uncaught exception.

Any exception thrown by this method will be ignored by the Java Virtual Machine.

Parameters:
t - the thread
e - the exception