|
jBPM :: Distribution 6.2.0-SNAPSHOT | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jbpm.bpmn2.handler.AbstractExceptionHandlingTaskHandler
org.jbpm.bpmn2.handler.LoggingTaskHandlerDecorator
public class LoggingTaskHandlerDecorator
This class is a WorkItemHandler
implementation that is meant to wrap
other WorkItemHandler
implementations.
WorkItemHandler
instance, it's added to a list of LoggingTaskHandlerDecorator.WorkItemExceptionInfo
instances
that contain as much information as possible about the exception, the
WorkItem
that caused the exception and the ProcessInstance
id
of the process in which the exception was thrown.
LoggingTaskHandlerDecorator.WorkItemExceptionInfo
class for more information.LoggingTaskHandlerDecorator.WorkItemExceptionInfo
classes is available via the
getWorkItemExceptionInfoList()
method.Logger.warn(String)
. The message
logged is configurable: see
setLoggedMessageFormat(String)
for more
information.
This class is thread-safe, although it does not take any responsibility
for the WorkItemHandler
that it wraps. If you are using this with
multiple threads, please make sure the the WorkItemHandler
instance
wrapped is also thread-safe.
Nested Class Summary | |
---|---|
static class |
LoggingTaskHandlerDecorator.InputParameter
Type of input parameter that will be used in the MessageFormat string set in
setLoggedMessageFormat(String) . |
class |
LoggingTaskHandlerDecorator.WorkItemExceptionInfo
|
Constructor Summary | |
---|---|
LoggingTaskHandlerDecorator(Class<? extends WorkItemHandler> originalTaskHandlerClass)
Constructs an LoggingTaskHandlerDecorator instance that wraps a
created instance of the WorkItemHandler class given. |
|
LoggingTaskHandlerDecorator(Class<? extends WorkItemHandler> originalTaskHandlerClass,
int logLimit)
Constructs an LoggingTaskHandlerDecorator instance that wraps a
created instance of the WorkItemHandler class given. |
|
LoggingTaskHandlerDecorator(WorkItemHandler originalTaskHandler)
Constructs a LoggingTaskHandlerDecorator instance that wraps the
given WorkItemHandler instance. |
Method Summary | |
---|---|
List<LoggingTaskHandlerDecorator.WorkItemExceptionInfo> |
getWorkItemExceptionInfoList()
|
void |
handleAbortException(Throwable cause,
WorkItem workItem,
WorkItemManager manager)
|
void |
handleExecuteException(Throwable cause,
WorkItem workItem,
WorkItemManager manager)
|
void |
setLoggedExceptionInfoListSize(int loggedExceptionInfoListSize)
|
void |
setLoggedMessageFormat(String logMessageFormat)
Sets the MessageFormat string to be used to format the log
messages. |
void |
setLoggedMessageInput(List<LoggingTaskHandlerDecorator.InputParameter> inputParameterList)
Sets the list of parameter types used for the log message format that is set in setLoggedMessageFormat(String) . |
void |
setPrintStackTrace(boolean printStackTrace)
|
Methods inherited from class org.jbpm.bpmn2.handler.AbstractExceptionHandlingTaskHandler |
---|
abortWorkItem, executeWorkItem, getOriginalTaskHandler |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public LoggingTaskHandlerDecorator(Class<? extends WorkItemHandler> originalTaskHandlerClass, int logLimit)
LoggingTaskHandlerDecorator
instance that wraps a
created instance of the WorkItemHandler
class given. This
instance will only keep the given number of LoggingTaskHandlerDecorator.WorkItemExceptionInfo
instances instead of the default 100.
originalTaskHandlerClass
- logLimit
- public LoggingTaskHandlerDecorator(Class<? extends WorkItemHandler> originalTaskHandlerClass)
LoggingTaskHandlerDecorator
instance that wraps a
created instance of the WorkItemHandler
class given. Only
information about the last 100 exceptions will be held in the list
available from
getWorkItemExceptionInfoList()
;
originalTaskHandlerClass
- public LoggingTaskHandlerDecorator(WorkItemHandler originalTaskHandler)
LoggingTaskHandlerDecorator
instance that wraps the
given WorkItemHandler
instance. This instance will only keep a
refere
originalTaskHandler
- Method Detail |
---|
public void setLoggedMessageFormat(String logMessageFormat)
MessageFormat
string to be used to format the log
messages. If this method is used, it's a good idea to also use the
setLoggedMessageInput(List)
method.
The default MessageFormat
string used is one of the
following:
If the WorkItemHandler
is a ServiceTaskHandler
(that
is used with <serviceTask>
nodes), then the format is:
{0}.{1} threw {2} when {3}ing work item {4} in process instance {5}.
WorkItemHandler
implementations, the format is:
{0} thrown when work item {1} ({2}) was {3}ed in process instance {4}.
logMessageFormat
- The format to use for logged messages.public void setLoggedMessageInput(List<LoggingTaskHandlerDecorator.InputParameter> inputParameterList)
setLoggedMessageFormat(String)
.
The order of the LoggingTaskHandlerDecorator.InputParameter
value in the list corresponds to the MessageFormat
number
used in the String given to setLoggedMessageFormat(String)
.
See LoggingTaskHandlerDecorator.InputParameter
for more information.
inputParameterList
- public void setLoggedExceptionInfoListSize(int loggedExceptionInfoListSize)
public void setPrintStackTrace(boolean printStackTrace)
public List<LoggingTaskHandlerDecorator.WorkItemExceptionInfo> getWorkItemExceptionInfoList()
public void handleExecuteException(Throwable cause, WorkItem workItem, WorkItemManager manager)
handleExecuteException
in class AbstractExceptionHandlingTaskHandler
public void handleAbortException(Throwable cause, WorkItem workItem, WorkItemManager manager)
handleAbortException
in class AbstractExceptionHandlingTaskHandler
|
jBPM :: Distribution 6.2.0-SNAPSHOT | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |