【转】JBPM4 ExecutionService

最新的流程实例 -- ByKey
下面是为流程定义启动一个新的流程实例的最简单也是 最常用的方法：

ProcessInstance processInstance = executionService.startProcessInstanceByKey("ICL");

上面service的方法会去查找 key为ICL的最新版本的流程定义， 然后在最新的流程定义里启动流程实例。

当key为ICL的流程部署了一个新版本， startProcessInstanceByKey方法会自动切换到最新部署的版本。

原来已经启动的流程，还是按照启动时刻的版本执行。

指定流程版本 -- ById
换句话说，你如果想根据特定的版本启动流程实例， 便可以使用流程定义的id启动流程实例。如下所示：

ProcessInstance processInstance = executionService.startProcessInstanceById("ICL-1");

使用key

我们可以为新启动的流程实例分配一个key(注意： 这个key不是process的key，而是启动的instance的key )，这个key是用户执行的时候定义的，有时它会作为“业务key”引用。一个业务key必须在流程定义的所有版本范围内是唯一的。通常很容易在业务流程领域找到这种key。比如，一个订单id或者一个保险单号。
ProcessInstance processInstance = executionService.startProcessInstanceByKey("ICL", "CL92837");

// 2个参数：
//  第一个参数processkey，通过这个key启动process的一个实例
//  第二个参数为这里所说的实例key(instance key)

key可以用来创建流程实例的id，格式为{process-key}.{execution-id}。所以上面的代码会创建一个id为 ICL.CL92837的流向（execution）。

如果没有提供用户定义的key，数据库就会把主键作为key。 这样可以使用如下方式获得id：
ProcessInstance processInstance = executionService.startProcessInstanceByKey("ICL");
String pid = processInstance.getId();

最好使用一个用户定义的key。特别在你的应用代码中，找到这样的key并不困难。提供给一个用户定义的key，你可以组合流向的id，而不是执行一个基于流程变量的搜索 - 那种方式太消耗资源了。

使用变量

当一个新的流程实例启动时就会提供一组对象参数。 将这些参数放在variables变量里， 然后可以在流程实例创建和启动时使用。
Map<String,Object> variables = new HashMap<String,Object>();
variables.put("customer", "John Doe");
variables.put("type", "Accident");
variables.put("amount", new Float(763.74));

ProcessInstance processInstance = executionService.startProcessInstanceByKey("ICL", variables);

启动instance

启动instance，必须要知道processdefinition的信息：processdefinition可以通过2种方式获取：
ByKey：通过ProcessKey，启动该Process的最新版本
ById：  通过Process的ID，启动该Process的特定的版本

其他的参数，其余还可以在启动Instance的时候，给流程2个参数：
InstanceKey：这个instanceKey必须在整个流程定义的所有范围版本中唯一，如果用户不给于提供，系统也会自己生成；
一个Map<String, ?>表：启动流程时候给予的变量信息

执行等待的流向

当使用一个state 活动时，执行（或流程实例）会在到达state的时候进行等待，直到一个signal （也叫外部触发器）出现。 signalExecution方法可以被用作这种情况。执行通过一个执行id （字符串）来引用。

在一些情况下，到达state的执行会是流程实例本身。但是这不是一直会出现的情况。在定时器和同步的情况，流程是执行树形的根节点。所以我们必须确认你的signal作用在正确的流程路径上。

获得正确的执行的比较好的方法是给state活动分配一个事件监听器，像这样：
<state name="wait"> 
  <on event="start"> 
    <event-listener class="org.jbpm.examples.StartExternalWork" /> 
  </on> 
  ... 
</state> 

在事件监听器StartExternalWork 中，你可以执行那些需要额外完成的部分。在这个事件监听器里，你也可以通过execution.getId() 获得确切的流程id。那个流程id，在额外的工作完成后，你会需要它来提供给signal操作的：

executionService.signalExecutionById(executionId); 

这里有一个可选的（不是太推荐的）方式，来获得流程id，当流程到达state 活动的时候。只可能通过这种方式获得执行id，如果你知道哪个JBPM API调用了之后，流程会进入state 活动：

// assume that we know that after the next call 
// the process instance will arrive in state external work 
ProcessInstance processInstance = executionService.startProcessInstanceById(processDefinitionId); 

// or ProcessInstance processInstance = 
//  executionService.signalProcessInstanceById(executionId); 
Execution execution = processInstance.findActiveExecutionIn("external work"); 
String executionId = execution.getId();