活动标签
-控制流程的活动
-原子活动
控制流程的活动
Start 开始节点,一个(主)流程只能有一个开始节点
End 结束节点,一个流程可以有多个结束节点
Decision 条件判断节点,当一个流程出现多个分支(情况),而分支排他时使用。
Fork 分支节点,当一个流程出现多个分支,而分支并列执行时使用。
Join 聚合/联合节点,通常与fork节点一起使用。
Sub-process 子流程(本人未曾使用过)
State 状态节点 一个暂停节点,当需要对流程的执行进行控制时使用。
Task 任务节点,通常与form表单关联,主要是在流程实例经过活动时为某一人或组指派任务
原子活动
Java、Script、Sql、Hql、Email
下面介绍三个最常用的活动
state
一个强制流程暂停的节点,当需要对流程的执行进行控制时使用。该节点可能什么都不需要做,也可能执行一些的操作。比如,路过银行,你拍怕裤兜,看看钱够还是不够。如果钱还可以花一段时间,你就不会去取钱。如果钱不多了,你就会去银行取些现金。或是钱本来就够花,但外面在下着雨,你想取避一避雨也不是不可以。State要做的相当于带你路过银行,至于你取不取钱,取多少,还是为了别的什么,不是它说了算,而是你自己的决定。
第一种方式:无分支的State
- <?xml version="1.0" encoding="UTF-8"?>
- <process name="simpleState" xmlns="http://jbpm.org/4.3/jpdl">
- <start name="start1" g="368,117,48,48">
- <transition name="to state" to="state" g="-59,-17"/>
- </start>
- <end name="end" g="372,396,48,48"/>
- <state name="state" g="348,250,92,52">
- <transition name="to end" to="end" g="-47,-17"/>
- </state>
- </process>
测试代码如下:
- ProcessInstance processInstance =
- executionService.startProcessInstanceByKey("simpleState");
- System.out.println("流程实例Id:"+
- processInstance.getId());
- System.out.println("流程定义Id:"+
- processInstance.getProcessDefinitionId());
- System.out.println("是否在 state节点:"+
- processInstance.isActive("state"));//true
- System.out.println("判断流程是否结束:"+
- processInstance.isEnded());//false
- processInstance =
- executionService.signalExecutionById(processInstance.getId());
- System.out.println("是否在 state节点:"+
- processInstance.isActive("state"));//true
- System.out.println("判断流程是否结束:"+
- processInstance.isEnded());//false
执行结果如下:
- 流程实例Id:simpleState.7
- 流程定义Id:simpleState-1
- 是否在 state节点:true
- 判断流程是否结束:false
- **************
- 是否在 state节点:false
- 判断流程是否结束:true
第二种方式:有分支的state
- <?xml version="1.0" encoding="UTF-8"?>
- <process name="compState" xmlns="http://jbpm.org/4.3/jpdl">
- <start name="start1" g="300,106,48,48">
- <transition name="to proot" to="proot" g="-59,-17"/>
- </start>
- <end name="end" g="315,448,48,48"/>
- <state name="proot" g="281,223,92,52">
- <transition name="to boy" to="boy" g="-59,-17"/>
- <transition name="to girl" to="girl" g="-59,-17"/>
- </state>
- <state name="boy" g="187,346,92,52">
- <transition name="to end" to="end" g="-47,-17"/>
- </state>
- <state name="girl" g="383,342,92,52">
- <transition name="to end" to="end" g="-47,-17"/>
- </state>
- </process>
测试代码如下:
- ProcessInstance processInstance =
- executionService.startProcessInstanceByKey("compState");
- System.out.println("是否在 proot节点:"+
- processInstance.isActive("proot"));//true
- System.out.println("是否在 boy节点:"+
- processInstance.isActive("boy"));//false
- System.out.println("是否在 girl节点:"+
- processInstance.isActive("girl"));//false
- System.out.println("判断流程是否结束:"+
- processInstance.isEnded());//false
- processInstance =
- executionService.signalExecutionById(processInstance.getId(),"to boy");//因为proot往下有多个分支,如果不指定流程转向,流程不会继续往下执行
- System.out.println("是否在 proot节点:"+
- processInstance.isActive("proot"));//false
- System.out.println("是否在 boy节点:"+
- processInstance.isActive("boy"));//true
- System.out.println("是否在 girl节点:"+
- processInstance.isActive("girl"));//false
- System.out.println("判断流程是否结束:"+
- processInstance.isEnded());//false
executionService.signalExecutionById(processInstance.getId(),"to boy");
这句如果改为:
executionService.signalExecutionById(processInstance.getId());
则流程不会往下执行,流程继续停留在proot节点。
decision
条件判断节点,当一个流程出现多个中情况而各种情况都排他时使用,相当于switch case.
第一种方式:decision内置condition
- <?xml version="1.0" encoding="UTF-8"?>
- <process key="deci" name="deci" xmlns="http://jbpm.org/4.3/jpdl">
- <start g="358,77,48,48" name="start1">
- <transition g="-83,-17" name="to exclusive1" to="exclusive1"/>
- </start>
- <end g="374,510,48,48" name="end"/>
- <decision g="358,219,48,48" name="exclusive1">
- <transition g="-59,-17" name="to 200" to="200">
- <condition expr="#{errorcode == 200}"/>
- </transition>
- <transition g="-59,-17" name="to 404" to="404">
- <condition expr="#{errorcode == 404}"/>
- </transition>
- <transition g="-59,-17" name="to 500" to="500">
- <condition expr="#{errorcode == 500}"/>
- </transition>
- </decision>
- <state g="194,351,92,52" name="200">
- <transition g="-47,-17" name="to end" to="end"/>
- </state>
- <state g="340,349,92,52" name="404">
- <transition g="-47,-17" name="to end" to="end"/>
- </state>
- <state g="476,349,92,52" name="500">
- <transition g="-47,-17" name="to end" to="end"/>
- </state>
- </process>
测试代码如下:
- Map<String, String> variables = new HashMap<String, String>();
- variables.put("errorcode", "200");
- ProcessInstance processInstance =
- executionService.startProcessInstanceByKey("deci", variables);
- System.out.println("200 isActive:"+
- processInstance.isActive("200"));//进入state 200,暂停
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程未结束,返回false
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
- //该方法返回processInstance如果不接收,processInstance还是原来的对象
- //如果不接收返回值,也不重新查询,则processInstance还是方法调前的状态
- processInstance=
- executionService.signalExecutionById(processInstance.getId());
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程结束,返回true
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
控制台输出结果如下:
- 200 isActive:true
- processInstance isEnd:false
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
- ********
- processInstance isEnd:true
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
第二种方式:为decision活动设置expr
- <?xml version="1.0" encoding="UTF-8"?>
- <process name="deciBaseExpr" xmlns="http://jbpm.org/4.3/jpdl">
- <start name="start1" g="407,65,48,48">
- <transition name="to exclusive1" to="exclusive1" g="-83,-17"/>
- </start>
- <end name="end1" g="418,497,48,48"/>
- <decision name="exclusive1" g="409,207,48,48" expr="#{whatcode}">
- <transition name="to 200" to="200" g="-59,-17"/>
- <transition name="to 404" to="404" g="-59,-17"/>
- <transition name="to 500" to="500" g="-59,-17"/>
- </decision>
- <state name="200" g="251,344,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- <state name="404" g="389,342,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- <state name="500" g="516,341,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- </process>
测试代码如下:
- Map<String, String> variables = new HashMap<String, String>();
- variables.put("whatcode", "to 404");
- ProcessInstance processInstance =
- executionService.startProcessInstanceByKey("deciBaseExpr", variables);
- System.out.println("200 isActive:"+
- processInstance.isActive("200"));//返回false
- System.out.println("404 isActive:"+
- processInstance.isActive("404"));//返回true
- System.out.println("500 isActive:"+
- processInstance.isActive("500"));//返回false
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程未结束,返回false
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
- //该方法返回processInstance如果不接收,processInstance还是原来的对象
- //如果不接收返回值,也不重新查询,则processInstance还是方法调前的状态
- processInstance=
- executionService.signalExecutionById(processInstance.getId());
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程结束,返回true
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
控制台输出结果如下:
- 200 isActive:false
- 404 isActive:true
- 500 isActive:false
- processInstance isEnd:false
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
- ***************
- processInstance isEnd:true
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
第三种方式:为decision配置handler
- <?xml version="1.0" encoding="UTF-8"?>
- <process name="deciByHandler" key="deciByHandler" xmlns="http://jbpm.org/4.3/jpdl">
- <start name="start1" g="341,55,48,48">
- <transition name="to exclusive1" to="exclusive1" g="-83,-17"/>
- </start>
- <end name="end1" g="346,435,48,48"/>
- <decision name="exclusive1" g="340,164,48,48">
- <handler class="com.lihua.HandlerDecision"></handler>
- <transition name="to 200" to="200" g="-59,-17"/>
- <transition name="to 404" to="404" g="-59,-17"/>
- <transition name="to 500" to="500" g="-59,-17"/>
- </decision>
- <state name="200" g="178,315,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- <state name="404" g="322,309,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- <state name="500" g="461,309,92,52">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </state>
- </process>
Handler类:
- package com.lihua;
- import org.jbpm.api.jpdl.DecisionHandler;
- import org.jbpm.api.model.OpenExecution;
- public class HandlerDecision implements DecisionHandler {
- private static final long serialVersionUID = -1639139174140348966L;
- @Override
- public String decide(OpenExecution execution) {
- return (String) execution.getVariable("towhere");
- }
- }
测试代码如下:
- Map<String, String> variables =
- new HashMap<String, String>();
- variables.put("towhere", "to 500");
- ProcessInstance processInstance =
- executionService.
- startProcessInstanceByKey("deciByHandler", variables);
- System.out.println("200 isActive:"+
- processInstance.isActive("200"));//返回 false
- System.out.println("404 isActive:"+
- processInstance.isActive("404"));//返回 false
- System.out.println("500 isActive:"+
- processInstance.isActive("500"));//返回 true
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程未结束,返回false
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
- //该方法返回processInstance如果不接收,processInstance还是原来的对象
- //如果不接收返回值,也不重新查询,则processInstance还是方法调前的状态
- processInstance=
- executionService.signalExecutionById(processInstance.getId());
- System.out.println("processInstance isEnd:"+
- processInstance.isEnded()); //流程结束,返回true
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
控制台输出结果如下:
- 200 isActive:false
- 404 isActive:false
- 500 isActive:true
- processInstance isEnd:false
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
- ************
- processInstance isEnd:true
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
以上三种方式差别都不是很大,第三中在程序中通过Handler进行复杂的处理。个人觉得,如果对于逻辑不是很复杂的操作,前两种方式是比较可取的。但如果逻辑过于复杂,或者还有其他的操作比如同步数据库中的其他信息等操作时,不妨选择第三种方式。
这些代码代码比较简单,这里就不做过多的解释。
Task
任务节点,通常与form表单关联,主要是在流程实例经过活动时为某一人或组指派任务.
Task的assignee属性
第一, assignee用来指示用户,负责完成任务的人。分配人是一个任务中的字符串属性,引用一个用户。(直接指定一个字符串)
第二,这个属性默认会当做表达式来执行。(指定一个表达式,然后在代码里为该表达式赋值) 如:在这里任务被分配给#{order.owner}。这意味着首先使用order这个名字查找一个对象。 其中一个查找对象的地方是这个任务对应的流程变量。 然后getOwner()方法会用来获得用户id, 引用的用户负责完成这个任务。
- <?xml version="1.0" encoding="UTF-8"?>
- <process name="task" xmlns="http://jbpm.org/4.3/jpdl">
- <start name="start1" g="390,97,48,48">
- <transition name="to task" to="task" g="-53,-17"/>
- </start>
- <end name="end1" g="391,362,48,48"/>
- <task name="task" g="368,239,92,52" assignee="${taskAssignee}">
- <transition name="to end1" to="end1" g="-47,-17"/>
- </task>
- </process>
测试代码如下:
- Map<String,String> map=
- new HashMap<String, String>();
- map.put("taskAssignee", "lihua");
- ProcessInstance processInstance=null;
- for (int i = 0; i < 2; i++) {
- processInstance=executionService.
- startProcessInstanceByKey("task",map);
- System.out.println("流程是否处于task节点:"+
- processInstance.isActive("task"));//true
- System.out.println("流程实例Id:"+
- processInstance.getId());
- }
- List<Task> list=taskService.findPersonalTasks("lihua");
- for (Task task : list) {
- System.out.println("任务活动名称:"+
- task.getActivityName());
- System.out.println("流程实例Id:"+
- task.getExecutionId());
- System.out.println("任务活动Id:"+
- task.getId());
- System.out.println("任务活动创建时间:"+
- task.getCreateTime());
- System.out.println("任务活动进度:"+
- task.getProgress());
- System.out.println("任务活动分配给:"+
- task.getAssignee());
- System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");
- }
控制台输出结果如下:
- 流程是否处于task节点:true
- 流程实例Id:task.7
- ************
- 流程是否处于task节点:true
- 流程实例Id:task.11
- *****************
- 任务活动名称:task
- 流程实例Id:task.11
- 任务活动Id:13
- 任务活动创建时间:2012-02-16 15:48:50.406
- 任务活动进度:null
- 任务活动分配给:lihua
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
- 任务活动名称:task
- 流程实例Id:task.7
- 任务活动Id:9
- 任务活动创建时间:2012-02-16 15:48:50.375
- 任务活动进度:null
- 任务活动分配给:lihua
- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>