Package org.eclipse.imagen.util

Class ImagingException

Object

Throwable

Exception

RuntimeException

ImagingException

All Implemented Interfaces:

Serializable

public class ImagingException
extends RuntimeException

This class is designed to contain information of the (abnormal) situations that happen in ImageN and the operations plugged into ImageN. The behavior of this class imitates the Exception class in Java^TM 2 Platform version 1.4 to define a chained exception and is call-compatible with Java^TM 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.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
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

Modifier and Type	Method	Description
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 Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

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 Details

getCause

public Throwable getCause()

Returns the cause of this ImagingException.

Overrides:

getCause in class Throwable

getRootCause

public Throwable getRootCause()

Recursively retrieves the root cause of this ImagingException.

printStackTrace

public void printStackTrace()

Prints the stack trace. For Java^TM 2 Platform version 1.4 and up, calls the same method in the super class. For Java^TM 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 Java^TM 2 Platform version 1.4 and up, calls the same method in the super class. For Java^TM 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 Java^TM 2 Platform version 1.4 and up, calls the same method in the super class. For Java^TM 2 Platform version 1.43, prints the stack trace of this ImagingException and the trace of its cause.

Overrides:

printStackTrace in class Throwable