org.broadleafcommerce.common.exception

Class TranslatableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.broadleafcommerce.common.exception.TranslatableException

All Implemented Interfaces:

Serializable

public abstract class TranslatableException
extends Exception

An exception whose message can be translated into a message suitable for a user.

Author:

Jeff Fischer

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected int	code

Constructor Summary

Constructors

Constructor and Description
TranslatableException(int code, String message) Create a new exception instance

Method Summary

Methods

Modifier and Type	Method and Description
int	getCode() Retrieve the error code associated with this exception
String	getLocalizedMessage() Return the message to show to the user.
String	toString() Cause the message passed to the constructor to show up on stack trace logs

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

code

protected int code

Constructor Detail

TranslatableException

public TranslatableException(int code,
                     String message)

Create a new exception instance

Parameters:

code - an integer code that represents this exception state

message - the message that will be posted to stack traces on the console (not necessarily intended for the user)

Method Detail

getCode

public int getCode()

Retrieve the error code associated with this exception

Returns:

the error code

getLocalizedMessage

public String getLocalizedMessage()

Return the message to show to the user. The framework will first look in the localized property bundles for any messages that match the supplied error code and exception type. If not found, the regular message submitted to the constructor will be returned.

Message bundle properties have the following format:

[simple class name of exception]_[integer error code]=[localized message for this exception and code]

Overrides:

getLocalizedMessage in class Throwable

Returns:

The error message to display to the user

toString

public String toString()

Cause the message passed to the constructor to show up on stack trace logs

Overrides:

toString in class Throwable

Returns:

the non-localized version of the exception message