Interface Thread.UncaughtExceptionHandler

Known Implementing Classes:

public static interface Thread.UncaughtExceptionHandler

This interface is used to handle uncaught exceptions which cause a Thread to terminate. When a thread, t, is about to terminate due to an uncaught exception, the virtual machine looks for a class which implements this interface, in order to supply it with the dying thread and its uncaught exception.

The virtual machine makes two attempts to find an appropriate handler for the uncaught exception, in the following order:

  1. t.getUncaughtExceptionHandler() -- the dying thread is queried first for a handler specific to that thread.
  2. t.getThreadGroup() -- the thread group of the dying thread is used to handle the exception. If the thread group has no special requirements for handling the exception, it may simply forward it on to Thread.getDefaultUncaughtExceptionHandler(), the default handler, which is used as a last resort.

The first handler found is the one used to handle the uncaught exception.

See Also:
Thread.getUncaughtExceptionHandler(), Thread.setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler), Thread.getDefaultUncaughtExceptionHandler(), Thread.setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler)

Method Summary

uncaughtException(Thread thr, Throwable exc)
Invoked by the virtual machine with the dying thread and the uncaught exception.

Method Details


public void uncaughtException(Thread thr,
                              Throwable exc)
Invoked by the virtual machine with the dying thread and the uncaught exception. Any exceptions thrown by this method are simply ignored by the virtual machine.
thr - the dying thread.
exc - the uncaught exception.

Thread -- an independent thread of executable code Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.