任务监听器

任务监听器可以在发生对应的任务相关事件时执行自定义java逻辑 或表达式。

任务监听器只能添加到流程定义中的用户任务中。 注意它必须定义在BPMN 2.0 extensionElements的子元素中， 并使用activiti命名空间，因为任务监听器是activiti独有的结构。

<userTask id="myTask" name="My Task" >
 <extensionElements>
  <activiti:taskListener event="create" class="org.activiti.MyTaskCreateListener" />
 </extensionElements>
</userTask>

任务监听器支持以下属性：

• event（必选）：任务监听器会被调用的任务类型。可能的类型为：

  • create：任务创建并设置所有属性后触发。

  • assignment：任务分配给一些人时触发。 当流程到达userTask， assignment事件 会在create事件之前发生。 这样的顺序似乎不自然，但是原因很简单：当获得create时间时， 我们想获得任务的所有属性，包括执行人。

  • complete：当任务完成，并尚未从运行数据中删除时触发。

• class：必须调用的代理类。这个类必须实现org.activiti.engine.impl.pvm.delegate.TaskListener接口。

  public class MyTaskCreateListener implements TaskListener {
  
   public void notify(DelegateTask delegateTask) {
    // Custom logic goes here
   }
  
  }

  可以使用属性注入把流程变量或执行传递给代理类。注意代理类的实例是在部署时创建的（和activiti中其他类代理的情况一样），这意味着所有流程实例都会共享同一个实例。

• expression：（无法同时与class属性一起使用）：指定事件发生时执行的表达式。可以把DelegateTask对象和事件名称（使用task.eventName）作为参数传递给调用的对象。

  <activiti:taskListener event="create" expression="${myObject.callMethod(task, task.eventName)}" />

• delegateExpression可以指定一个表达式，解析一个实现了TaskListener接口的对象，这与服务任务一致。

  <activiti:taskListener event="create" delegateExpression="${myTaskListenerBean}" />

• 在activiti 5.12中，我们也介绍了新的任务监听器，org.activiti.engine.impl.bpmn.listener.ScriptTaskListener。 脚本任务监听器可以为任务监听器事件执行脚本。

  <activiti:taskListener event="complete" class="org.activiti.engine.impl.bpmn.listener.ScriptTaskListener" >
   <activiti:field name="script">
    <activiti:string>
     def bar = "BAR"; // local variable
     foo = "FOO"; // pushes variable to execution context
     task.setOwner("kermit"); // test access to task instance
     bar // implicit return value
    </activiti:string>
   </activiti:field>
   <activiti:field name="language" stringValue="groovy" />
   <activiti:field name="resultVariable" stringValue="myVar" />
  <activiti:taskListener>