All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.lang.Throwable

java.lang.Object
   |
   +----java.lang.Throwable

public class Throwable

extends Object

implements Serializable

A Throwable class contains a snapshot of the execution stack of its thread at the time it was created. It can also contain a message string that gives more information about the error.

Here is one example of catching an exception:

     try {
         int a[] = new int[2];
         a[4];
     } catch (ArrayIndexOutOfBoundsException e) {
         System.out.println("exception: " + e.getMessage());
         e.printStackTrace();
     }
 

Throwable()

Constructs a new Throwable with no detail message.

Throwable(String)

Constructs a new Throwable with the specified detail message.

fillInStackTrace()

Fills in the execution stack trace.

getLocalizedMessage()

Creates a localized description of this Throwable.

getMessage()

Returns the detail message of this throwable object.

printStackTrace()

Prints this Throwable and its backtrace to the standard error stream.

printStackTrace(PrintStream)

Prints this Throwable and its backtrace to the specified print stream.

printStackTrace(PrintWriter)

Prints this Throwable and its backtrace to the specified print writer.

toString()

Returns a short description of this throwable object.

 public Throwable()

Constructs a new Throwable with no detail message. The stack trace is automatically filled in.

 public Throwable(String message)

Constructs a new Throwable with the specified detail message. The stack trace is automatically filled in.

Parameters:

message - the detail message.

 public String getMessage()

Returns the detail message of this throwable object.

Returns:

the detail message of this Throwable, or null if this Throwable does not have a detail message.

 public String getLocalizedMessage()

Creates a localized description of this Throwable. Subclasses may override this method in order to produce a locale-specific message. For subclasses that do not override this method, the default implementation returns the same result as getMessage().

 public String toString()

Returns a short description of this throwable object.

Returns:

a string representation of this Throwable.

Overrides:

toString in class Object

 public void printStackTrace()

Prints this Throwable and its backtrace to the standard error stream.

See Also:

err

 public void printStackTrace(PrintStream s)

Prints this Throwable and its backtrace to the specified print stream.

 public void printStackTrace(PrintWriter s)

Prints this Throwable and its backtrace to the specified print writer.

 public native Throwable fillInStackTrace()

Fills in the execution stack trace. This method is useful when an application is re-throwing an error or exception. For example:

     try {
         a = b / c;
     } catch(ArithmeticThrowable e) {
         a = Number.MAX_VALUE;
         throw e.fillInStackTrace();
     }
 

Returns:

this Throwable object.

See Also:

printStackTrace

All Packages  Class Hierarchy  This Package  Previous  Next  Index