org.drools.runtime.process
Interface WorkItemHandler


public interface WorkItemHandler

A work item handler is responsible for executing work items of a specific type. They represent the glue code between an abstract, high-level work item that is used inside the process and the implementation of this work item. Work item handlers should be registered with the WorkItemManager for each type of work that can be executed in the engine. A work item handler is responsible for executing a work item whenever the work item manager delegates one to it. It should also notify the work item manager when the work item has been completed. It is also possible that a work item handler is requested to abort an existing work item (that is still executing) because it is no longer necessary. This might for example be because the process instance (or a part of the process instance) that is was executing in is being aborted. The work item handler should then try to abort this work item (if possible) and if necessary clean up runtime state related to its execution. For example, a work item handler that is responsible for executing email work items will retrieve the necessary information from the work item (from, to, body, etc.) and invoke the mail server. Afterwards, it will notify the WorkItemManager that the work item was completed.


Method Summary
 void abortWorkItem(WorkItem workItem, WorkItemManager manager)
          The given work item should be aborted.
 void executeWorkItem(WorkItem workItem, WorkItemManager manager)
          The given work item should be executed.
 

Method Detail

executeWorkItem

void executeWorkItem(WorkItem workItem,
                     WorkItemManager manager)
The given work item should be executed.

Parameters:
workItem - the work item that should be executed
manager - the manager that requested the work item to be executed

abortWorkItem

void abortWorkItem(WorkItem workItem,
                   WorkItemManager manager)
The given work item should be aborted.

Parameters:
workItem - the work item that should be aborted
manager - the manager that requested the work item to be aborted


Copyright © 2001-2011 JBoss by Red Hat. All Rights Reserved.