com.bankframe.localization
Class BankFrameRuntimeException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              com.bankframe.localization.BankFrameRuntimeException

All Implemented Interfaces:

Serializable

public class BankFrameRuntimeException
extends RuntimeException

This class is the base class for all BankFrame exceptions. Instead of using java.lang.String for messages, it uses the com.bankframe.localization.BankFrameMessage class which represents a localizable string. This class can be instantiated by passing its constructor a BankFrameMessage or a sub-class of java.lang.Throwable. Using a sub-class of Throwable is termed exception chaining. See the JDK 1.4 documentation for more information on this topic. This class emulates the exception chaining functionality provided in JDK1.4 so that exception chaining can be used on earlier JDKs. Note that if the chained exception is not a sub-class of BankFrameException it may not be possible to provide a fully localised message since only BankFrameException sub-classes have support for per-user localisation.

See Also:

Serialized Form

Field Summary

static String	CHAINED_EXCEPTION_DIVIDER
static String	CHAINED_JAVA_EXCEPTION_MSG
static String	EXCEPTION_CLASS_NAME
static String	EXCEPTION_NAME

Constructor Summary

BankFrameRuntimeException(BankFrameMessage message)
Constructor.

BankFrameRuntimeException(BankFrameMessage message, Throwable cause)
Constructor.

BankFrameRuntimeException(Throwable cause)
Constructor.

Method Summary

BankFrameMessage	getBankFrameMessage() This method gets the BankFrameMessage object.
Throwable	getCause() This method gets the cause of this Exception, i.e the cause is the Throwable that caused this BankFrameRuntimeException to get thrown).
String	getMessage() This method gets the error message as a localized String.
String	getMessage(Locale locale) This method gets the error message as a localized String.
Throwable	initCause(Throwable cause) Initializes the cause of this Throwable to the specified value.
void	printStackTrace() This method prints this throwable and its backtrace to the standard error stream;
void	printStackTrace(PrintStream s) This method prints this throwable and its backtrace to the standard error stream.
void	printStackTrace(PrintWriter s) This method prints this throwable and its backtrace to the standard error stream.
DataPacket	toDataPacket() This method converts the exception to a DataPacket.
String	toString() This method converts the exception to a String.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Field Detail

EXCEPTION_CLASS_NAME

public static final String EXCEPTION_CLASS_NAME

See Also:

Constant Field Values

EXCEPTION_NAME

public static final String EXCEPTION_NAME

See Also:

Constant Field Values

CHAINED_JAVA_EXCEPTION_MSG

public static final String CHAINED_JAVA_EXCEPTION_MSG

See Also:

Constant Field Values

CHAINED_EXCEPTION_DIVIDER

public static final String CHAINED_EXCEPTION_DIVIDER

See Also:

Constant Field Values

Constructor Detail

BankFrameRuntimeException

public BankFrameRuntimeException(BankFrameMessage message)

Constructor.

Parameters:

message - the error message for the exception

BankFrameRuntimeException

public BankFrameRuntimeException(BankFrameMessage message,
                                 Throwable cause)

Constructor. Note that the detail message associated with cause is not automatically incorporated in this exception's detail message.

Parameters:

message - the error message for the exception

cause - the original cause of this BankFrameException. This parameter must not be null.

BankFrameRuntimeException

public BankFrameRuntimeException(Throwable cause)

Constructor.

Parameters:

cause - the original cause of this BankFrameException. This parameter must not be null.

Method Detail

getBankFrameMessage

public BankFrameMessage getBankFrameMessage()

This method gets the BankFrameMessage object.

Returns:

a BankFrameMessage instance

getCause

public Throwable getCause()

This method gets the cause of this Exception, i.e the cause is the Throwable that caused this BankFrameRuntimeException to get thrown).

Overrides:

getCause in class Throwable

Returns:

the cause of this Throwable or null if the cause is nonexistent or unknown.

getMessage

public String getMessage()

This method gets the error message as a localized String. This method uses the default Locale. Use this method with caution, or use getMessage(Locale locale) instead.

Overrides:

getMessage in class Throwable

Returns:

Localized error message

getMessage

public String getMessage(Locale locale)

This method gets the error message as a localized String. This method uses the specified Locale.

Parameters:

locale - the locale to use for localizing the error message

Returns:

the localized error message

initCause

public Throwable initCause(Throwable cause)

Initializes the cause of this Throwable to the specified value. (The cause is the Throwable that caused this BankFrameRuntimeException to get thrown). This method can be called at most once. It is generally called from within the constructor, or immediately after creating the BankFrameRuntimeException. If this throwable was created with BankFrameRuntimeException(Throwable) this method cannot be called even once. If this exception does not have an associated BankFrameMessage before this method is called then this method will use the BankFrameMessage from the cause.

Overrides:

initCause in class Throwable

Parameters:

cause - The original cause of the BankFrameRuntimeException

Returns:

an instance of this BankFrameRuntimeException

printStackTrace

public void printStackTrace()

This method prints this throwable and its backtrace to the standard error stream;

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)

This method prints this throwable and its backtrace to the standard error stream.

Overrides:

printStackTrace in class Throwable

Parameters:

s - the stream to print to

printStackTrace

public void printStackTrace(PrintWriter s)

This method prints this throwable and its backtrace to the standard error stream.

Overrides:

printStackTrace in class Throwable

Parameters:

s - The stream to print to

toDataPacket

public DataPacket toDataPacket()

This method converts the exception to a DataPacket.

Returns:

a DataPacket instance

toString

public String toString()

This method converts the exception to a String. Use this method for debugging purposes. Use getMessage(Locale locale) to convert the message to a localized String.

Overrides:

toString in class Throwable