jbpm中的excutionservice详解

晨曦之光 发布于 2012/04/11 18:10
阅读 343
收藏 0

最新的流程实例 -- 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(); 



原文链接:http://blog.csdn.net/wangxiaojing123/article/details/7053468
加载中
返回顶部
顶部