Thread.UncaughtExceptionHandler (Java Platform SE 8 ) (original) (raw)

• All Known Implementing Classes:
  ThreadGroup
  Enclosing class:
  Thread
  Functional Interface:
  This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
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 itsUncaughtExceptionHandler usingThread.getUncaughtExceptionHandler() and will invoke the handler'suncaughtException 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 itsUncaughtExceptionHandler. If the ThreadGroup object has no special requirements for dealing with the exception, it can forward the invocation to the default uncaught exception handler.
Since:
1.5
See Also:
Thread.setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler), Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler), ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable)

• • Method Summary

  All Methods Instance Methods Abstract Methods

  Modifier and Type	Method	Description
  void	uncaughtException(Thread t,Throwable e)	Method invoked when the given thread terminates due to the given uncaught exception.

• • Method Detail

     * #### uncaughtException  
     void uncaughtException([Thread](../../java/lang/Thread.html "class in java.lang") t,  
                            [Throwable](../../java/lang/Throwable.html "class in java.lang") 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

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.