jBPM4工作流开发实战 之 第三部分 jBPM4开发

定义

start活动的意义在于指定了一个流程实例应该从哪里开始，即流程定义的入口。

start活动的子元素

<transition>用来指定流出的转移，指向流程的下一个活动。

定义

end活动的意义在于结束了一个流程实例，即流程定义的结束点。

特殊的end-cancel和end-error

在一些特定的流程里，需要区分到底是为什么结束的，怎么结束的。比如，前面的差旅费报销申请流程，可以被批准进而正常的结束；也可以被某位领导不批准进而被取消。在一般的流程里，不需要区分end和end-cancel，但是如果再做的精细一点，可以让不同的结果，流向不同的结束。

定义

state活动作为一个等待状态活动。

流程处理的流向会在外部调用提供的触发器API之前一直等待。与task相同的是，流程引擎会停在这里等待外界的调用；但不同的是，它不会将任务分配给某个人。

相关api

如果是同时只有单个state的情况，可以简单的使用：

executionService.signalExecutionById(“这里默认使用流程实例的id");

如果是同时有多个state的话，应该要先查找到Execution的id，如下使用：

ExecutionService exe = engine.getExecutionService();

Execution e = exe.createProcessInstanceQuery()

.processInstanceId(piid).uniqueResult()

.findActiveExecutionIn(“state活动名称");

exe.signalExecutionById(e.getId());

定义

decision活动会运行并判断其中的每一个transition元素里的转移条件。当遇到一个transition的condition值为true的时候，那么流程就立即流向这个transition。

流程引擎并不会等待decision活动，它会马上执行完这个decision。

decision活动的expr属性

用一个三目运算符来判断到底要流向哪个transition。

decision活动的transition元素的condition子元素

用expr属性来判断是否流向这个transition。

decision活动的handler子元素

以上两种判断方式仍然没法完全满足我们的要求，还可以通过实现DecisionHandler接口来在java代码中决定到底到底流向哪个transition。

java代码：

 publicclassMyDecisionHandlerimplementsDecisionHandler{
 @Override
 publicStringdecide(OpenExecutionexecution){
 Integerage=(Integer)execution.getVariable("age");
 if(age>=20){
 return"yes";
 }else{
 return"no";
 }
 }
 }

定义

task活动一般用来处理涉及人机交互的活动，流程引擎会停在这里等待人工的操作。

task活动的assignee属性

assignee属性用来指定任务分配给谁，可以使用变量来定义。

任务的候选者

candidate-users属性可以使用逗号分割的用户ID列表。所有列表中的用户会成为任务的候选者。用户想要接受这个任务，需要人工的takeTask。

相关api—领取任务

java代码：

 ProcessEngineprocessEngine=Configuration.getProcessEngine();
 TaskServicetaskService=processEngine.getTaskService();
 taskService.takeTask(“task的id”,“领取task的人员");

任务的候选组

candidate-groups属性可以使用逗号分割的用户组ID列表。所有列表中的用户组中的用户会成为任务的候选者。用户想要接受这个任务，需要人工的takeTask。

相关api—建立用户和用户组

java代码：

 ProcessEngineprocessEngine=Configuration.getProcessEngine();
 IdentityServiceidentityService=processEngine.getIdentityService();

 identityService.createGroup("sales");
 identityService.createUser(“zhang",“zhang",“san");
 identityService.createUser(“li",“li",“si");

 identityService.createMembership(“zhang","sales");
 identityService.createMembership(“li","sales");

任务分配器

任务分配器AssignmentHandler的方式，可以说是最灵活的任务分配方式了，它支持使用java代码来指定任务的分配者。

相关api：

java代码：

 publicclassMyAssignmentHandlerimplementsAssignmentHandler{
 privateStringname;
 publicStringgetName(){
 returnname;
 }
 publicvoidsetName(Stringname){this.name=name;}

 publicvoidassign(Assignableassignable,OpenExecutionexecution)throwsException{
 assignable.setAssignee(name);
 }
 }

相应的配置示例：

java代码：

 <taskname="task1"g="339,146,92,52">
 <assignment-handlerclass="cn.javass.test.task.handler.MyAssignmentHandler">
 <fieldname="name">
 <stringvalue="ok"/>
 </field>
 </assignment-handler>
 <transitionto="end1"/>
 </task>

定义

当需要流程并发执行的时候，就需要使用到fork-join活动的组合，fork活动可以使流程在一条主干上出现并行的分支，join活动则可以使流程的并行分支聚合成一条主干。

定义

java活动可以指定一个Java类的方法，当流程执行到此活动时，马上自动执行此Java方法。

相关属性

class属性用来指定此Java类的全类名，要注意这个类要有public无参的默认构造方法。

method属性用来指定调用的方法。

var属性存储方法执行结果的流程变量名称。

java代码：

 publicclassMyJava{
 privateStringuser1;
 privateStringuser2;
 …user1和user2的setter
 publicStringsayHello(Stringarg1,Stringarg2){

 System.out.println("user1=="+user1);
 System.out.println("user2=="+user2);
 System.out.println("arg1=="+arg1);
 System.out.println("arg2=="+arg2);

 return“Hello";
 }
 }

为Java类设置属性和为方法传递参数

在注册的时候，可以注册一个固定的值，也可以引用pi级的变量。

java代码：

 <javag="246,135,92,52"name="java1"class="cn.javass.test.java.MyJava"method="sayHello"var="manager">
 <fieldname="user1"><objectexpr=“#{user1}”/></field>
 <fieldname="user2"><stringvalue="user2“/></field>
 <arg><stringvalue="xyz“/></arg>
 <arg><objectexpr="#{abc}“/></arg>
 <transitionto="task1"/>
 </java>

定义

script活动可以指定一个表达式，当流程执行到此活动时，马上自动执行此表达式，默认用的是juEL。

相关属性

使用script活动有两种方式，一种是通过脚本表达式的方式，另外一种是通过脚本文本的方式。

1：脚本表达式的方式：就是在script活动上，使用expr属性来指定脚本表达式，用var属性来表示存储执行结果的流程变量名称。

2：脚本文本的方式：就是在script活动下添加text子活动，在text子活动里面写脚本表达式，同样使用var来表示存储执行结果的流程变量名称。

定义

sql活动能够支持使用sql直接从数据库中查询数据，并将结果返回到流程变量中。

sql活动的属性

var属性存储sql执行结果的流程变量名称。

unique属性，此属性为true时，返回结果为一行，结果将作为一个单独的对象存储；此属性为false时，返回结果为多行，结果将作为一个Set存储。

sql活动的子元素

query子元素用来设置sql查询语句。

parameters子元素用来设置sql的外部参数。

Sql活动示例：

java代码：

 <sqlg="192,438,92,52"name="sql1"unique="true"var="sqlV">
 <query>
 select*fromtbl_userwhereuuid=:uuid
 </query>
 <parameters>
 <objectname="uuid"expr="#{uuid}"></object>
 </parameters>
 <transitionto="hql1"/>
 </sql>

定义

hql活动能够支持使用hql直接从数据库中查询数据，并将结果返回到流程变量中。

nhql活动的属性

var属性存储hql执行结果的流程变量名称。

unique属性，此属性为true时，返回结果为一行，结果将作为一个单独的对象存储；此属性为false时，返回结果为多行，结果将作为一个Set存储。

hql活动的子元素

query子元素用来设置hql查询语句。

parameters子元素用来设置hql的外部参数。

HQL活动示例：

java代码：

 <hqlname="hql1"g="404,457,92,52"unique="true"var="hqlV">
 <query>
 selectofromParentowhereo.id=:id
 </query>
 <parameters>
 <stringname="id"value="22"/>
 </parameters>
 <transitionto="task2"/>
 </hql>

定义

foreach活动使得通过一条单独的流程路径来执行多条流程分支的功能。

相关属性

in：将被迭代的集合。集合中的每个元素会生成一个新的同步分支。in执行任意类型的集合，数组和以逗号分隔的字符串。。

var：用来保存集合中当前元素的变量。这个变量会设置到同步流程分支中，并且只对这个流程分支可见。

与join活动连用

通常情况下，foreach活动后面是多次执行的活动，在这个活动后面应该跟一个join活动，并且把join活动的multiplicity设置成为foreach的数量，这样才会等到foreach的多个task执行完成，流程才继续向下，否则，只要有一个foreach的task完成了，流程就向下流转了。

配置示例，如果在jPDL里面配置如下：

java代码：

 <foreachname="foreach1"in="D1,D2,D3"var="nowDep">
 <transitionto="task5"/>
 </foreach>
 <taskname="task5">
 <transitionto="join1"/>
 </task>
 <joinname="join1"multiplicity="3">
 <transitionto="task6"/>
 </join>

那么当流程运行到foreach1的时候，会转移到task5活动3次，也就是会生成3个task5的实例。

获取变量示例，在task5的实例里面，如何获取自己的nowDep呢？

很简单，根据自己的task实例的id来获取变量就可以了，如下：

String nowDep = ts.getVariable(taskInstance.getId(),“nowDep”);

定义

ules是一个自动活动，它会创建一个有状态的知识会话，在它中间放入一系列事实，然后触发所有规则。这些规则可以更新或创建流程变量，以后可以在流程中使用。事实可以被指定为rules活动的子元素。

相关子元素

fact：事实，相当于规则引擎的一条规则。

fact的属性：

var：变量名，作为fact 插入的变量名称。

expr：表达式，表达式的结果会作为一个事实插入。

var 或 expr 必填一个。

注意：如果一个rules 活动只有一个外向转移，就会自动使用它。 而多个外向转移可以在rules活动后面显示的使用decision活动。

配置示例，如果在jPDL里面配置如下：

java代码：

 <rulesname="rule1">
 <factvar="um"></fact>
 <transitionto="exclusive2"/>
 </rules>
 <decisionname="exclusive2">
 <transitionname="toT7"to="task7">
 <conditionexpr="#{um.canDrink}"/>
 </transition>
 <transitionname="toT8"to="task8">
 <conditionexpr="#{!um.canDrink}"/>
 </transition>
 </decision>

配套的UserModel就是一个普通的VO

对应的规则文件示例如下：

rule "CheckCanDrink"

when

um : cn.javass.jbpm4.hello.UserModel( age > 18,uuid=="11")

then

um.setCanDrink( true );

end

启动流程的时候需要同步发布规则文件

rs.createDeployment().addResourceFromClasspath("cn/javass/jbpm4/hello/h2.jpdl.xml")

.addResourceFromClasspath("cn/javass/jbpm4/hello/rule1.drl")

.deploy();

在运行规则活动之前，需要设置好规则需要的变量，比如在启动流程的时候：

java代码：

 Mapmap=newHashMap();
 UserModelum=newUserModel();
 um.setUuid("11");
 um.setAge(50);
 map.put("um",um);
 exe.startProcessInstanceByKey("h2",map);

jBPM事件机制介绍

jBPM的事件机制使得我们可以很方便的在流程、活动、任务生命周期的各个阶段插入定制的代码逻辑，以便实现特定的业务逻辑操作。正是这种机制赋予了jBPM无限的可扩展性。

事件(event)用来定位在流程执行过程中的特定的时间点，例如“流程实例开始”、“状态活动结束”等，可以在这些时间点上注册一系列的监听器。当流程的执行通过这些时间点时，监听器的代码就会被执行。

on活动

监听器在jpdl中可以被定为on活动。

on活动的event属性{start|end}指明了监听器是在进入还是结束时触发。

on活动的作用范围

on活动作为谁的子活动，就是为谁定义开始或结束事件，常见的活动，都可以定义为on的父活动。

比如on活动作为<process>的子活动，就表示监听流程的开始或结束。

on活动作为一些活动活动的子活动，如<state>、<task>、<decision>，表示监听这个活动的开始或结束。

on活动的子活动

on活动的子活动用来表示：当监听事件发生的时候，都可以触发什么样的“自定义代码”。

典型的为<event-listener>，可以注册一个实现了EventListener接口的类。其他一些典型的自动活动(流程引擎不会停下来等的活动)，也可以作为on活动的子活动。如前面学过的<java>、<sql>和<hql>。

监听器还可以作为<transition>元素的子元素

<event-listener>、<java>、<sql>、<hql>等自动活动还可以作为<transition>元素的子元素，在流经这个<transition>的时候被执行。

事件监听器实现示例

只需要实现EventListener接口即可。

java代码：

 publicclassMyEventListenerimplementsEventListener{
 publicvoidnotify(EventListenerExecutionexection)throwsException{
 System.out.println("走出Decistion");
 }
 }
 <?xmlversion="1.0"encoding="UTF-8"?>

 <processname="test9"xmlns="http://jBPM.org/4.4/jpdl">
 <onevent="start">
 <event-listenerclass="cn.javass.test.event.MyEventListener1">
 <fieldname="haha">
 <objectexpr="#{uuid}"/>
 </field>
 </event-listener>
 </on>
 <startname="start1"g="84,115,48,48">
 <transitionto="task1"/>
 </start>
 <endname="end1"g="778,120,48,48"/>
 <taskname="task1"g="358,124,92,52"assignee="wang">
 <onevent="start">
 <event-listenerclass="cn.javass.test.event.MyEventListener3">
 </event-listener>
 </on>
 <transitionname="yes"to="end1"g="-47,-17">
 <event-listenerclass="cn.javass.test.event.MyEventListener5"/>
 </transition>
 <transitionname="no"to="task2"g="-53,-17"/>
 </task>
 <taskname="task2"g="536,218,92,52"assignee="zhang">
 <transitionto="end1"/>
 </task>
 </process>