javax.media.jai.util
Class ImagingException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--javax.media.jai.util.ImagingException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
RemoteImagingException

public class ImagingException
extends RuntimeException

This class is designed to contain information of the (abnormal) situations that happen in JAI and the operations plugged into JAI. The behavior of this class imitates the Exception class in JavaTM 2 Platform version 1.4 to define a chained exception and is call-compatible with JavaTM 2 Platform version 1.4: The cause can be stored and retrieved from the instance of this class. Also, the root cause for an instance can be retrieved.

Since:
JAI 1.1.2
See Also:
Serialized Form

Constructor Summary
ImagingException()
          The default constructor.
ImagingException(String message)
          The constructor to accept the message that describes the situation.
ImagingException(String message, Throwable cause)
          The constructor to accept the cause of this ImagingException and the message that describes the situation.
ImagingException(Throwable cause)
          The constructor to accept the cause of this ImagingException.
 
Method Summary
 Throwable getCause()
          Returns the cause of this ImagingException.
 Throwable getRootCause()
          Recursively retrieves the root cause of this ImagingException.
 void printStackTrace()
          Prints the stack trace.
 void printStackTrace(PrintStream s)
          Prints the stack trace.
 void printStackTrace(PrintWriter s)
          Prints the stack trace.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ImagingException

public ImagingException()
The default constructor.

ImagingException

public ImagingException(String message)
The constructor to accept the message that describes the situation.
Parameters:
message - The message to describe the situation.

ImagingException

public ImagingException(Throwable cause)
The constructor to accept the cause of this ImagingException.
Parameters:
cause - The cause of this ImagingException.

ImagingException

public ImagingException(String message,
                        Throwable cause)
The constructor to accept the cause of this ImagingException and the message that describes the situation.
Parameters:
message - The message that describes the situation.
cause - The cause of this ImagingException
Method Detail

getCause

public Throwable getCause()
Returns the cause of this ImagingException.

getRootCause

public Throwable getRootCause()
Recursively retrieves the root cause of this ImagingException.

printStackTrace

public void printStackTrace()
Prints the stack trace. For JavaTM 2 Platform version 1.4 and up, calls the same method in the super class. For JavaTM 2 Platform version 1.3, prints the stack trace of this ImagingException and the trace of its cause.
Overrides:
printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)
Prints the stack trace. For JavaTM 2 Platform version 1.4 and up, calls the same method in the super class. For JavaTM 2 Platform version 1.4, prints the stack trace of this ImagingException and the trace of its cause.
Overrides:
printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter s)
Prints the stack trace. For JavaTM 2 Platform version 1.4 and up, calls the same method in the super class. For JavaTM 2 Platform version 1.43, prints the stack trace of this ImagingException and the trace of its cause.
Overrides:
printStackTrace in class Throwable