de.susebox.java.lang

Class ExtRuntimeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

de.susebox.java.lang.ExtRuntimeException

All Implemented Interfaces:

ThrowableList, java.io.Serializable

public class ExtRuntimeException
extends java.lang.RuntimeException
implements ThrowableList

Implementation of the ThrowableList interface for the well-known JDK RuntimeException.

Author:

Heiko Blau

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ExtRuntimeException(java.lang.String msg) This constructor takes a simple message string like ordinary Java Throwable classes.
ExtRuntimeException(java.lang.String fmt, java.lang.Object[] args) This constructor takes a format string and its arguments.
ExtRuntimeException(java.lang.Throwable throwable) This constructor should be used for wrapping another Throwable.
ExtRuntimeException(java.lang.Throwable throwable, java.lang.String msg) If one likes to add ones own information to an exception, this constructor is the easiest way to do so.
ExtRuntimeException(java.lang.Throwable throwable, java.lang.String fmt, java.lang.Object[] args) This is the most complex way to construct an ExceptionList- Throwable. An inner throwable is accompanied by a format string and its arguments.

Method Summary

Modifier and Type	Method and Description
java.lang.Object[]	getArguments() Retrieving the arguments for message formats.
java.lang.Throwable	getCause() Retrieving the cause of a Throwable.
java.lang.String	getFormat() Getting the format string of a exception message.
java.lang.String	getMessage() Implementation of the standard Throwable.getMessage() method.
boolean	isWrapper() Check if this is only a throwable that wraps the real one.
java.lang.Throwable	nextThrowable() Deprecated. use the JDK 1.4 call getCause() instead

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtRuntimeException

public ExtRuntimeException(java.lang.String msg)

This constructor takes a simple message string like ordinary Java Throwable classes. This is the most convenient form to construct an ThrowableList throwable.

Parameters:

msg - message for this Throwable instance

ExtRuntimeException

public ExtRuntimeException(java.lang.Throwable throwable)

This constructor should be used for wrapping another Throwable. While reading data an IOException may occur, but a certain interface requires a SQLException. Simply use:

 try {
   ...
 } catch (NullPointerException ex) {
   throw new ExtNoSuchMethodException(ex);
 }

Parameters:

throwable - the Throwable to wrap

ExtRuntimeException

public ExtRuntimeException(java.lang.Throwable throwable,
                           java.lang.String msg)

If one likes to add ones own information to an exception, this constructor is the easiest way to do so. By using such an approach a exception trace with useful additional informations (which file could be found, what username is unknown) can be realized:

 try {
   ...
 } catch (SQLException ex) {
   throw new IOException(ex, "while connecting to " + url);
 }

Parameters:

throwable - the inner throwable

msg - throwable message

ExtRuntimeException

public ExtRuntimeException(java.lang.String fmt,
                           java.lang.Object[] args)

This constructor takes a format string and its arguments. The format string must have a form that can be used by MessageFormat methods. That means:

    java.text.Message.format(fmt, args)

is similar to

    new MyException(fmt, args).getMessage();

Parameters:

fmt - throwable message

args - arguments for the given format string

ExtRuntimeException

public ExtRuntimeException(java.lang.Throwable throwable,
                           java.lang.String fmt,
                           java.lang.Object[] args)

This is the most complex way to construct an ExceptionList- Throwable.
An inner throwable is accompanied by a format string and its arguments. Use this constructor in language-sensitive contexts or for formalized messages. The meaning of the parameters is explained in the other constructors.

Parameters:

throwable - the inner throwable

fmt - throwable message

args - arguments for the given format string

Method Detail

getCause

public java.lang.Throwable getCause()

Retrieving the cause of a Throwable. This is the method introduced with JDK 1.4. It replaces the older nextThrowable().

Specified by:

getCause in interface ThrowableList

Overrides:

getCause in class java.lang.Throwable

Returns:

the cause of this Throwable

See Also:

Throwable.getCause()

nextThrowable

public java.lang.Throwable nextThrowable()

Deprecated. use the JDK 1.4 call getCause() instead

Method to traverse the list of Throwable. See ThrowableList.nextThrowable() for details.

Specified by:

nextThrowable in interface ThrowableList

Returns:

the "earlier" throwable

isWrapper

public boolean isWrapper()

Check if this is only a throwable that wraps the real one. See ThrowableList.isWrapper() for details.

Specified by:

isWrapper in interface ThrowableList

Returns:

true if this is a wrapper exception, false otherwise

getFormat

public java.lang.String getFormat()

Getting the format string of a exception message. This can also be the message itself if there are no arguments.

Specified by:

getFormat in interface ThrowableList

Returns:

the format string being used by MessageFormat

See Also:

getArguments()

getArguments

public java.lang.Object[] getArguments()

Retrieving the arguments for message formats. These arguments are used by the MessageFormat.format(java.lang.Object[], java.lang.StringBuffer, java.text.FieldPosition) call.

Specified by:

getArguments in interface ThrowableList

Returns:

the arguments for a message format

See Also:

getFormat()

getMessage

public java.lang.String getMessage()

Implementation of the standard Throwable.getMessage() method. It delegates the call to the central ThrowableMessageFormatter.getMessage(de.susebox.java.lang.ThrowableList) method.

Overrides:

getMessage in class java.lang.Throwable

Returns:

the formatted throwable message

See Also:

ThrowableMessageFormatter