com.beasys.commerce.foundation.exception
Class SystemException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--javax.ejb.EJBException
                          |
                          +--com.beasys.commerce.foundation.exception.SystemException

Direct Known Subclasses:

CreateSystemException, DeploymentException, FatalWorkflowTransitionException, FinderSystemException, NamingSystemException, RemoteSystemException, UnimplementedException, WorkflowInstantiationException

public class SystemException

extends javax.ejb.EJBException

implements MessageCatalogException

The SystemException class is used to signal system-level exceptions to a caller. It is the base system exception class. A system-level exception is a severe exception that prevents a thread of execution from proceeding in a normal manner.

If an enterprise bean method encounters a system-level exception or error that does not allow the method to successfully complete, the method should throw a suitable system exception compatible with the method's throw clause:

• If the bean method encounters a RuntimeException or error, it should simply propagate the error from the bean method to the Container.
• If the bean method encounters a checked exception that the bean cannot recover from, the bean method should throw a SystemException or derivative that wraps the original exception.
• Any other fatal error should be reported using a SystemException or EJBException.

Since the practice of throwing a RemoteException has been deprecated in the EJB 1.1 specification, all such occurrences must be replaced with an instance of SystemException.

Finally, a bean provider is responsible for using the standard EJB system exceptions (EJBException and javax.ejb.NoSuchEntityException) where appropriate.

See Also:

EJBException, MessageCatalog, MessageCatalogException, Serialized Form

Field Summary

protected java.util.Stack	logMessages
protected java.util.Stack	userMessages

Constructor Summary

SystemException()
Constructs an SystemException with no associated message.

SystemException(java.lang.String namespace, java.lang.String messageKey)
Class constructor taking the namespace and key of the associated catalog message.

SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Exception exception)
Class constructor taking the namespace and key of the associated catalog message and an embedded exception.

SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument)
Class constructor taking the namespace and key of the associated catalog message and a message parameter substitution argument.

SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments)
Class constructor taking the namespace and key of the associated catalog message and message parameter substitution arguments.

SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments, java.lang.Exception exception)
Class constructor taking the namespace and key of the associated catalog message, message parameter substitution arguments, and an embedded exception.

SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument, java.lang.Exception exception)
Class constructor taking the namespace and key of the associated catalog message, message parameter substitution argument, and an embedded exception.

SystemException(SystemException topException, SystemException bottomException)
Constructs an SystemException from two source SystemExceptions by concatinating the screen and log messages of the two source SystemExceptions.

Method Summary

void	addLogMessage(java.lang.String namespace, java.lang.String messageKey) Adds a new log catalog message to the stack of associated messages.
void	addLogMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument) Adds a new log catalog message to the stack of associated messages.
void	addLogMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments) Adds a new log catalog message to the stack of associated messages.
void	addMessage(java.lang.String namespace, java.lang.String messageKey) Adds a new user and log catalog message to the stack of associated messages.
void	addMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument) Adds a new user catalog message to the stack of associated messages.
void	addMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments) Adds a new user catalog message to the stack of associated messages.
void	addUserMessage(java.lang.String namespace, java.lang.String messageKey) Adds a new user catalog message to the stack of associated messages.
void	addUserMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument) Adds a new user catalog message to the stack of associated messages.
void	addUserMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments) Adds a new user catalog message to the stack of associated messages.
java.lang.Exception	getEmbeddedException() Gets the embedded exception associated with this exception.
java.lang.String	getLocalizedMessage()
java.lang.String	getLogMessage() Returns the first log catalog message associated with this exception.
java.util.Iterator	getLogMessages() Returns an iterator over all the log catalog messages associated with this exception.
java.lang.String	getMessage()
java.lang.String	getUserMessage() Returns the first user catalog message associated with this exception.
java.util.Iterator	getUserMessages() Returns an iterator over all the user catalog messages associated with this exception.
static void	main(java.lang.String[] args) SystemException UT entry point.
java.lang.String	toString()

Methods inherited from class javax.ejb.EJBException

getCausedByException

Methods inherited from class java.lang.Throwable

fillInStackTrace, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Object

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

Field Detail

logMessages

protected java.util.Stack logMessages

userMessages

protected java.util.Stack userMessages

Constructor Detail

SystemException

public SystemException()

Constructs an SystemException with no associated message.

SystemException

public SystemException(SystemException topException,
                       SystemException bottomException)

Constructs an SystemException from two source SystemExceptions by concatinating the screen and log messages of the two source SystemExceptions. The messages of the first SystemException will preceed those of the second in the constructed SystemException. Furthermore, the new SystemException will have the embedded exception of the first SystemException associated with it.

Parameters:

SystemException - topException

SystemException - bottomException

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey)

Class constructor taking the namespace and key of the associated catalog message.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Exception exception)

Class constructor taking the namespace and key of the associated catalog message and an embedded exception.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

exception - The embedded exception.

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object argument)

Class constructor taking the namespace and key of the associated catalog message and a message parameter substitution argument.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

argument - The message parameter substitution argument.

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object argument,
                       java.lang.Exception exception)

Class constructor taking the namespace and key of the associated catalog message, message parameter substitution argument, and an embedded exception.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

argument - The message parameter substitution argument.

exception - The embedded exception.

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object[] arguments)

Class constructor taking the namespace and key of the associated catalog message and message parameter substitution arguments.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

arguments - The message parameter substitution arguments.

SystemException

public SystemException(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object[] arguments,
                       java.lang.Exception exception)

Class constructor taking the namespace and key of the associated catalog message, message parameter substitution arguments, and an embedded exception.

Parameters:

namespace - The associated catalog message namespace.

messageKey - The associated catalog message key.

arguments - The message parameter substitution arguments.

exception - The embedded exception.

Method Detail

getEmbeddedException

public java.lang.Exception getEmbeddedException()

Description copied from interface: MessageCatalogException

Gets the embedded exception associated with this exception.

Specified by:

getEmbeddedException in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Returns:

The embedded exception.

getLogMessage

public java.lang.String getLogMessage()

Description copied from interface: MessageCatalogException

Returns the first log catalog message associated with this exception.

Specified by:

getLogMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Returns:

The first log catalog message associated with this exception.

getLogMessages

public java.util.Iterator getLogMessages()

Description copied from interface: MessageCatalogException

Returns an iterator over all the log catalog messages associated with this exception.

Specified by:

getLogMessages in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Returns:

An iterator over all log catalog messages.

addLogMessage

public void addLogMessage(java.lang.String namespace,
                          java.lang.String messageKey)

Description copied from interface: MessageCatalogException

Adds a new log catalog message to the stack of associated messages.

Specified by:

addLogMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - Log catalog message namespace.

messageKey - Log catalog message key.

addLogMessage

public void addLogMessage(java.lang.String namespace,
                          java.lang.String messageKey,
                          java.lang.Object argument)

Description copied from interface: MessageCatalogException

Adds a new log catalog message to the stack of associated messages.

Specified by:

addLogMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - Log catalog message namespace.

messageKey - Log catalog message key.

argument - Message parameter substitution argument.

addLogMessage

public void addLogMessage(java.lang.String namespace,
                          java.lang.String messageKey,
                          java.lang.Object[] arguments)

Description copied from interface: MessageCatalogException

Adds a new log catalog message to the stack of associated messages.

Specified by:

addLogMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - Log catalog message namespace.

messageKey - Log catalog message key.

arguments - Message parameter substitution arguments.

getUserMessage

public java.lang.String getUserMessage()

Description copied from interface: MessageCatalogException

Returns the first user catalog message associated with this exception.

Specified by:

getUserMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Returns:

The user catalog message associated with this exception.

getUserMessages

public java.util.Iterator getUserMessages()

Description copied from interface: MessageCatalogException

Returns an iterator over all the user catalog messages associated with this exception.

Specified by:

getUserMessages in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Returns:

An iterator over all user catalog messages.

addUserMessage

public void addUserMessage(java.lang.String namespace,
                           java.lang.String messageKey)

Description copied from interface: MessageCatalogException

Adds a new user catalog message to the stack of associated messages.

Specified by:

addUserMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User catalog message namespace.

messageKey - User catalog message key.

addUserMessage

public void addUserMessage(java.lang.String namespace,
                           java.lang.String messageKey,
                           java.lang.Object argument)

Description copied from interface: MessageCatalogException

Adds a new user catalog message to the stack of associated messages.

Specified by:

addUserMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User catalog message namespace.

messageKey - User catalog message key.

argument - Message parameter substitution argument.

addUserMessage

public void addUserMessage(java.lang.String namespace,
                           java.lang.String messageKey,
                           java.lang.Object[] arguments)

Description copied from interface: MessageCatalogException

Adds a new user catalog message to the stack of associated messages.

Specified by:

addUserMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User catalog message namespace.

messageKey - User catalog message key.

arguments - Message parameter substitution arguments.

addMessage

public void addMessage(java.lang.String namespace,
                       java.lang.String messageKey)

Description copied from interface: MessageCatalogException

Adds a new user and log catalog message to the stack of associated messages.

Specified by:

addMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User and log catalog message namespace.

messageKey - User and log catalog message key.

addMessage

public void addMessage(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object argument)

Description copied from interface: MessageCatalogException

Adds a new user catalog message to the stack of associated messages.

Specified by:

addMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User and log catalog message namespace.

messageKey - User and log catalog message key.

argument - Message parameter substitution argument.

addMessage

public void addMessage(java.lang.String namespace,
                       java.lang.String messageKey,
                       java.lang.Object[] arguments)

Description copied from interface: MessageCatalogException

Adds a new user catalog message to the stack of associated messages.

Specified by:

addMessage in interface MessageCatalogException

Tags copied from interface: MessageCatalogException

Parameters:

namespace - User and log catalog message namespace.

messageKey - User and log catalog message key.

arguments - Message parameter substitution arguments.

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

getLocalizedMessage

public java.lang.String getLocalizedMessage()

Overrides:

getLocalizedMessage in class java.lang.Throwable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Throwable

main

public static void main(java.lang.String[] args)

SystemException UT entry point.