|
BEA Systems, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +--java.lang.RuntimeException | +--javax.ejb.EJBException | +--com.beasys.commerce.foundation.exception.SystemException
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:
RuntimeException
or
error, it should simply propagate the error from the bean method to the Container.
SystemException
or
derivative that wraps the original exception.
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.
EJBException
,
MessageCatalog
,
MessageCatalogException
, Serialized FormField 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 SystemException s
by concatinating the screen and log messages of the two source SystemException s. |
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 |
protected java.util.Stack logMessages
protected java.util.Stack userMessages
Constructor Detail |
public SystemException()
SystemException
with no associated message.public SystemException(SystemException topException, SystemException bottomException)
SystemException
from two source SystemException
s
by concatinating the screen and log messages of the two source SystemException
s.
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.SystemException
- topExceptionSystemException
- bottomExceptionpublic SystemException(java.lang.String namespace, java.lang.String messageKey)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.public SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Exception exception)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.exception
- The embedded exception.public SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.argument
- The message parameter substitution argument.public SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument, java.lang.Exception exception)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.argument
- The message parameter substitution argument.exception
- The embedded exception.public SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.arguments
- The message parameter substitution arguments.public SystemException(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments, java.lang.Exception exception)
namespace
- The associated catalog message namespace.messageKey
- The associated catalog message key.arguments
- The message parameter substitution arguments.exception
- The embedded exception.Method Detail |
public java.lang.Exception getEmbeddedException()
public java.lang.String getLogMessage()
public java.util.Iterator getLogMessages()
public void addLogMessage(java.lang.String namespace, java.lang.String messageKey)
namespace
- Log catalog message namespace.messageKey
- Log catalog message key.public void addLogMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument)
namespace
- Log catalog message namespace.messageKey
- Log catalog message key.argument
- Message parameter substitution argument.public void addLogMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments)
namespace
- Log catalog message namespace.messageKey
- Log catalog message key.arguments
- Message parameter substitution arguments.public java.lang.String getUserMessage()
public java.util.Iterator getUserMessages()
public void addUserMessage(java.lang.String namespace, java.lang.String messageKey)
namespace
- User catalog message namespace.messageKey
- User catalog message key.public void addUserMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument)
namespace
- User catalog message namespace.messageKey
- User catalog message key.argument
- Message parameter substitution argument.public void addUserMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments)
namespace
- User catalog message namespace.messageKey
- User catalog message key.arguments
- Message parameter substitution arguments.public void addMessage(java.lang.String namespace, java.lang.String messageKey)
namespace
- User and log catalog message namespace.messageKey
- User and log catalog message key.public void addMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object argument)
namespace
- User and log catalog message namespace.messageKey
- User and log catalog message key.argument
- Message parameter substitution argument.public void addMessage(java.lang.String namespace, java.lang.String messageKey, java.lang.Object[] arguments)
namespace
- User and log catalog message namespace.messageKey
- User and log catalog message key.arguments
- Message parameter substitution arguments.public java.lang.String getMessage()
public java.lang.String getLocalizedMessage()
public java.lang.String toString()
public static void main(java.lang.String[] args)
SystemException
UT entry point.
|
BEA Systems, Inc. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |