com.groiss.wfxml

Interface WfXMLExceptionHandler

public interface WfXMLExceptionHandler

Instances of this interface can be used for handling errors and exceptions in cases where automatic handling is not possible. If you implement this interface, you can activate your WfXMLExceptionHandler by adding the following line to the avw.conf file of @enterprise:

avw.wfxml.exceptionhandlers=com.yourpackage.YourHandler

If you want to use more than one exception handler class, you can add them to the before mentioned parameter by using a comma-separated list. In this case you should ensure that one error/exception is not handled by two exception handlers, because this could lead to unpredictable behaviour.

Method Summary

Modifier and Type	Method and Description
void	handleObservedPIException(ProcessInstance pi, Throwable t) This method is called if an error or exception occurs while the WfXMLTask tries to send a PIStateChangedMessage because the state of an observed process instance has changed.

Method Detail

handleObservedPIException

void handleObservedPIException(ProcessInstance pi,
                               Throwable t)

This method is called if an error or exception occurs while the WfXMLTask tries to send a PIStateChangedMessage because the state of an observed process instance has changed. This means that sending the message was not possible, so you must handle the problem in this method. Whatever you do, the ProcessInstanceObserver still exists, so if the state of the process instance stays finished or aborted, the ProcessInstanceObserver will be called again at the next run of the WfXMLTask timer.

Parameters:

pi - The process instance that caused the error or exception. You should change the process instance or the state of the process instance so that it will not cause problems again.

t - The Throwable that was thrown while the WfXMLTask tried to collect data from the process instance and send the information back to the server which started the process instance. This might give you a hint of what went wrong.