|
WebLogic Integration | |||||||||
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 | +--com.bea.wlpi.common.WorkflowException
Encapsulates exceptions encountered when executing a remote EJB call. WorkflowException is thrown in 3 different situations:
1. On a system error (i.e., rethrown exception).
2. On a workflow error (i.e., illegal workflow situation such as an
inconsistent state).
3. On a non-fatal workflow error.
WorkflowException has constructors that take a nested exception and others that take a message code to support internationalization of server exception messages.
Messages
, Serialized FormField Summary | |
static int |
ERROR_CUSTOM
A custom error raised either by an application calling WorkflowProcessor.invokeWorkfowErrorHandler, or by a workflow executing the 'Invoke Error handler' action. |
static int |
ERROR_SYSTEM
A fatal exception occurred while processing a user request. |
static int |
ERROR_UNKNOWN
Unknown error type - internal use only. |
static int |
ERROR_WORKFLOW
A fatal, illegal condition such as inconsistent workflow state. |
static int |
WARNING_WORKFLOW
A non-fatal workflow condition that the user can rectify manually. |
Constructor Summary | |
WorkflowException(java.lang.Exception e)
Construct a new WorkflowException containing a nested exception. |
|
WorkflowException(java.lang.Exception e,
int severity)
Construct a new WorkflowException containing a nested exception. |
|
WorkflowException(java.lang.Exception e,
int msgNum,
int severity)
Construct a new WorkflowException containing a nested exception. |
|
WorkflowException(java.lang.Exception e,
int msgNum,
java.lang.Object[] args)
Construct a new WorkflowException containing a nested exception. |
|
WorkflowException(java.lang.Exception e,
int msgNum,
java.lang.Object[] args,
int severity)
Construct a new WorkflowException containing a nested exception. |
|
WorkflowException(int msgNum)
Construct a new WorkflowException with the specified error code. |
|
WorkflowException(int msgNum,
int severity)
Construct a new WorkflowException with the specified error code. |
|
WorkflowException(int msgNum,
java.lang.Object[] args)
Construct a new WorkflowException with the specified error code. |
|
WorkflowException(int msgNum,
java.lang.Object[] args,
int severity)
Construct a new WorkflowException with the specified error code. |
|
WorkflowException(int msgNum,
java.lang.Object[] args,
int severity,
java.lang.String origin)
Construct a new WorkflowException with the specified error code. |
Method Summary | |
java.lang.String |
getLocalizedMessage()
As for getMessage() but in the locale of the calling system. |
static java.lang.String |
getLocalizedMessage(int msgNum,
java.lang.Object[] args)
Create a localized message with parameter values substituted. |
java.lang.String |
getLocalizedSeverityDescription()
Return a string to indicate the severity of the exception. |
java.lang.String |
getMessage()
Return the error message string of this object. |
int |
getMessageNumber()
Return the exception message number. |
java.lang.Exception |
getNestedException()
Return the nested exception ( null if none). |
java.lang.String |
getOrigin()
Return the name of the workflow component from which this exception originated. |
java.lang.Exception |
getOriginalException()
Return the original exception. |
static java.lang.Exception |
getOriginalException(java.lang.Exception e)
Return the innermost nested exception. |
int |
getSeverity()
Return the exception severity code. |
java.lang.String |
getSeverityDescription()
Return a string to indicate the severity of the exception. |
boolean |
isDeadlock()
Whether this exception resulted from a database deadlock. |
static boolean |
isDeadlock(java.lang.Exception e)
Whether an exception resulted from a database deadlock. |
void |
printStackTrace()
Print this exception and its backtrace to the standard error stream. |
void |
printStackTrace(java.io.PrintStream stream)
Print this exception and its backtrace to the specified print stream. |
void |
printStackTrace(java.io.PrintWriter writer)
Print this exception and its backtrace to the specified print writer. |
Methods inherited from class java.lang.Throwable |
fillInStackTrace,
toString |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Field Detail |
public static final int ERROR_UNKNOWN
public static final int ERROR_SYSTEM
public static final int ERROR_WORKFLOW
public static final int WARNING_WORKFLOW
public static final int ERROR_CUSTOM
Constructor Detail |
public WorkflowException(java.lang.Exception e)
ERROR_SYSTEM
, unless the nested
exception is of class WorkflowException
, in which case the
new exception inherits its severity setting from the nested exception.
e
- The nested exception (assumed to have been previously caught).WorkflowException(Exception, int)
public WorkflowException(java.lang.Exception e, int severity)
e
- The nested exception (assumed to have been previously caught).severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.WorkflowException(Exception)
public WorkflowException(java.lang.Exception e, int msgNum, int severity)
e
- The nested exception (assumed to have been previously caught).msgNum
- Message number from Messages
.severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.WorkflowException(Exception)
public WorkflowException(java.lang.Exception e, int msgNum, java.lang.Object[] args)
e
- The nested exception (assumed to have been previously caught).msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.WorkflowException(Exception)
public WorkflowException(java.lang.Exception e, int msgNum, java.lang.Object[] args, int severity)
e
- The nested exception (assumed to have been previously caught).msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.WorkflowException(Exception)
public WorkflowException(int msgNum)
ERROR_WORKFLOW
.
msgNum
- Message number from Messages
.public WorkflowException(int msgNum, java.lang.Object[] args)
ERROR_WORKFLOW
.
msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.public WorkflowException(int msgNum, int severity)
msgNum
- Message number from Messages
.severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.public WorkflowException(int msgNum, java.lang.Object[] args, int severity)
msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.public WorkflowException(int msgNum, java.lang.Object[] args, int severity, java.lang.String origin)
msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.severity
- Error type: ERROR_SYSTEM
,
ERROR_WORKFLOW
or WARNING_WORKFLOW
.origin
- Name or label of workflow node in which error originated.Method Detail |
public java.lang.String getMessage()
null
if it was
created with no error message.public java.lang.String getOrigin()
public int getMessageNumber()
public java.lang.String getLocalizedMessage()
getMessage()
but in the locale of the calling system.
public java.lang.Exception getNestedException()
null
if none).
public java.lang.Exception getOriginalException()
getOriginalException(Exception)
public int getSeverity()
ERROR_SYSTEM
,
ERROR_WORKFLOW
, WARNING_WORKFLOW
,
ERROR_UNKNOWN
or ERROR_CUSTOM
.public java.lang.String getSeverityDescription()
"System error", "Workflow error",
"Workflow warning" or "Unknown error"
.
getLocalizedSeverityDescription()
public java.lang.String getLocalizedSeverityDescription()
"System error", "Workflow error",
"Workflow warning" or "Unknown error"
,
expressed in the language of the system locale on which the method is
called.
getSeverityDescription()
public boolean isDeadlock()
true
if the original problem was a database
deadlock.isDeadlock(Exception)
public void printStackTrace()
System.err
. The first
line of output contains the result of the toString() method for this
object. The remaining lines represent data previously recorded by the
method fillInStackTrace(). If this exception contains a nested
exception, the stack trace for this exception is printed as well.
public void printStackTrace(java.io.PrintStream stream)
stream
- PrintStream to use for output.public void printStackTrace(java.io.PrintWriter writer)
stream
- PrintWriter to use for output.public static java.lang.String getLocalizedMessage(int msgNum, java.lang.Object[] args)
msgNum
- Message number from Messages
.args
- Arguments for substitution into localized message string.public static java.lang.Exception getOriginalException(java.lang.Exception e)
com.bea.wlpi.common.WorkflowException, java.rmi.RemoteException,
javax.ejb.EJBException, weblogic.utils.NestedThrowable
.
e
- The outermost exception.public static boolean isDeadlock(java.lang.Exception e)
getOriginalException()
to retrieve the original exception (it may
have been wrapped and re-thrown multiple times before being caught by
the client). If the original exception is an instance of
java.sql.SQLException
, the implementation calls the
getSQLState()
method to determine whether the original
problem was a database deadlock (i.e., SQLSTATE="40001").
true
if the original problem was a database
deadlock.
|
WebLogic Integration | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |