    All Packages    This Package    Previous    Next

# Class java.lang.Exception

    java.lang.Object
       |
       +----java.lang.Exception

public class Exception
extends Object

An object signalling that an exceptional condition has occurred. All exceptions are a subclass of Exception. An exception contains a snapshot of the execution stack, this snapshot is used to print a stack backtrace. An exception also contains a message string. An example of catching an exception:

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

Version:
  1.12, 31 Jan 1995

##

Exception()
  Constructs an exception with no detail message.
Exception(String)
  Constructs an exception with the specified detail message.

##

fillInStackTrace()
  Fills in the excecution stack trace.
getMessage()
  Gets the message.
printStackTrace()
  Prints the exception and the exception's stack trace.
toString()
  Returns a short description of the exception.

##

Exception

      public Exception()

  Constructs an exception with no detail message. The stack trace is automatically filled in.

Exception

      public Exception(String message)

  Constructs an exception with the specified detail message. The stack trace is automatically filled in.
  Parameters:
    message - the detail message

##

getMessage

      public String getMessage()

  Gets the message.
  Returns:
    the detail message of the exception

toString

      public String toString()

  Returns a short description of the exception.
  Returns:
    a string describing the exception
  Overrides:
    toString in class Object

printStackTrace

      public void printStackTrace()

  Prints the exception and the exception's stack trace.

fillInStackTrace

      public Exception fillInStackTrace()

  Fills in the excecution stack trace. This is useful only when rethrowing an exception. For example:

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

  Returns:
    the exception itself
  See Also:
    printStackTrace

    All Packages    This Package    Previous    Next