JBPM4工作流应用（三）
8、JBPM自动活动
2）script脚本活动
jpdl定义：
<!-- script 脚本活动会解析一个script 脚本。
任何一种符合JSR-223 规范 的脚本引擎语言都可以在这里运行。
expr:执行表达式的文本
var:返回值存储的 变量名
-->
<script name="invoke script"
expr="Send packet to #{order.address}"
var="text"
g="96,16,104,52">
<transition to="wait" />
</script>
测试代码如下：
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("order", new Order("Berlin"));
Execution execution = executionService
.startProcessInstanceByKey("ScriptExpression", variables);
String executionId = execution.getId();
String text = (String) executionService.getVariable(executionId, "text");
assertTextPresent("Send packet to Berlin", text);
3）hql查询
jpdl定义：
<!-- 使用hql 活动，我们可以在database 中执行HQL query var:存储结果的变量名 unique:值为true 是指从uniqueResult()方法中 获得hibernate query 的结果。 默认值是false。 值为false 的话会使用list()方法得到结果。 --> <hql name="get task names" var="tasknames with i" g="96,16,115,52"> <!-- query:HQL query parameter:query 的参数 --> <query> select task.name from org.jbpm.pvm.internal.task.TaskImpl as task where task.name like :taskName </query> <parameters> <string name="taskName" value="%i%" /> </parameters> <transition to="count tasks" /> </hql> <hql name="count tasks" var="tasks" unique="true" g="243,16,95,52"> <query> select count(*) from org.jbpm.pvm.internal.task.TaskImpl </query> <transition to="wait" /> </hql>
测试事例代码如下：
ProcessInstance processInstance = executionService.startProcessInstanceByKey("Hql");
String processInstanceId = processInstance.getId();
// 设定预期结果
Set<String> expectedTaskNames = new HashSet<String>();
expectedTaskNames.add("dishes");
expectedTaskNames.add("iron");
// 获取第一个hql活动的执行结果，流程变量"tasknames with i"
Collection<String> taskNames = (Collection<String>) executionService
.getVariable(processInstanceId, "tasknames with i");
taskNames = new HashSet<String>(taskNames);
assertEquals(expectedTaskNames, taskNames);
// 获取第二个hql活动的执行结果，流程数据库中共有3条记录
Object activities = executionService.getVariable(processInstanceId, "tasks");
assertEquals("3", activities.toString());
4）sql查询
jpdl定义：
<!--sql 活动和hql 活动十分相似， 唯一不同的地方就是 使用session.createSQLQuery(...) --> <sql name="get task names" var="tasknames with i" g="96,16,126,52"> <query> select NAME_ from JBPM4_TASK where NAME_ like :name </query> <parameters> <string name="name" value="%i%" /> </parameters> <transition to="count tasks" /> </sql> <sql name="count tasks" var="tasks" unique="true" g="254,16,92,52"> <query> select count(*) from JBPM4_TASK </query> <transition to="wait" /> </sql>
测试事例代码同Hql事例代码。
5） mail（邮件活动）
jpdl定义：
<!-- from:发件者列表
to: 主要收件人列表
cc:抄送收件人列表
bcc: 密送收件人列表
subject:这个元素的文字内容会成为消息的主题
text:这个元素的文字内容会成为消息的文字内容
html:这个元素的文字内容会成为消息的HTML 内容
attachments:每个附件都会配置在单独的子元素中
-->
<mail g="99,25,115,45" language="juel" name="send rectify note">
<to addresses=" winston@minitrue"/>
<cc groups="innerparty" users="bb"/>
<bcc groups="thinkpol"/>
<subject>rectify ${newspaper}</subject>
<text>${newspaper} ${date} reporting bb dayorder doubleplusungood
refs unpersons rewrite fullwise upsub antefiling</text>
<!--
<html><table><tr><td>${newspaper}</td><td>${date}</td>
<td>reporting bb dayorder doubleplusungood
refs unpersons rewrite fullwise upsub antefiling</td>
</tr></table></html>
<attachments>
<attachment url='http://www.george-orwell.org/1984/3.html' />
<attachment resource='org/example/pic.jpg' />
<attachment file='${user.home}/.face' />
</attachments>
-->
<transition to="wait"/>
</mail>
9、事件
Jpdl定义：
<state name="wait" g="96,16,104,52">
<!-- event:事件名称(start或end)
event-listener:一个事件监听器实现对象。
start:活动开始时捕获
end:活动结束时捕获
-->
<on event="start">
<event-listener class="org.jbpm.examples.eventlistener.LogListener">
<field name="msg"><string value="start on activity wait"/></field>
</event-listener>
</on>
<on event="end">
<event-listener class="org.jbpm.examples.eventlistener.LogListener">
<field name="msg"><string value="end on activity wait"/></field>
</event-listener>
</on>
<transition to="park">
<event-listener class="org.jbpm.examples.eventlistener.LogListener">
<field name="msg"><string value="take transition"/></field>
</event-listener>
</transition>
</state>
监听器LogListener代码：
public class LogListener implements EventListener {
String msg;
public void notify(EventListenerExecution execution) {
List<String> logs = (List<String>) execution.getVariable("logs");
if (logs==null) {
logs = new ArrayList<String>();
execution.setVariable("logs", logs);
}
logs.add(msg);
execution.setVariable("logs", logs);
}
}
测试事例代码如下：
ProcessInstance processInstance = executionService
.startProcessInstanceByKey("EventListener");
Execution execution = processInstance.findActiveExecutionIn("wait");
executionService.signalExecutionById(execution.getId());
List<String> expectedLogs = new ArrayList<String>();
expectedLogs.add("start on process definition");
expectedLogs.add("start on activity wait");
expectedLogs.add("end on activity wait");
expectedLogs.add("take transition");
List<String> logs = (List<String>) executionService
.getVariable(processInstance.getId(), "logs");
assertEquals(expectedLogs, logs);
默认情况下，事件监听器只对当前订阅的元素所触发的事件起作用，即propagation=”false”,
但通过指定事件监听器的传播属性propagation=”enabled”或(propagation=”true”),
则该事件监听器可以对其监听元素的所有子元素起作用。
10. 异步执行
1）几乎所有的活动都支持异步属性，流程一旦进入异步执行方式，一个异步消息会被作为当前事务的一部门发送出去，
然后当前事务会立即自动提交。
Jpdl定义：
<!-- continue属性： sync (默认值) 作为当前事务的一部分，继续执行元素。 async 使用一个异步调用（又名安全点）。当前事务被提交，元素在一个新事务中执行。 事务性的异步消息被jBPM 用来 实现这个功能。 --> <java name="generate pdf" continue="async" class="org.jbpm.examples.async.activity.Application" method="generatePdf" g="86,26,87,50"> <transition to="calculate primes"/> </java> <java name="calculate primes" continue="async" class="org.jbpm.examples.async.activity.Application" method="calculatePrimes" g="203,26,98,50"> <transition to="end"/> </java>
Application事例代码如下：
public class Application implements Serializable {
private static final long serialVersionUID = 1L;
public void generatePdf() {
// 此方法执行需要消耗较长时间
}
public void calculatePrimes() {
// 此方法执行需要消耗较长时间
}
}
测试事例代码如下：
ProcessInstance processInstance = executionService
.startProcessInstanceByKey("AsyncActivity");
String processInstanceId = processInstance.getId();
// 流程实例处于异步执行状态
assertEquals(Execution.STATE_ASYNC, processInstance.getState());
// 获取流程实例异步消息队列中的第1条消息
Job job = managementService.createJobQuery()
.processInstanceId(processInstanceId).uniqueResult();
// 手工执行异步消息
managementService.executeJob(job.getId());
processInstance = executionService.findProcessInstanceById(processInstanceId);
// 流程实例处于异步执行状态
assertEquals(Execution.STATE_ASYNC, processInstance.getState());
// 获取第2条消息(job)并执行之
job = managementService.createJobQuery()
.processInstanceId(processInstanceId)
.uniqueResult();
managementService.executeJob(job.getId());
assertNull(executionService.findProcessInstanceById(processInstanceId));
2）异步分支/聚合
Jpdl定义：
<!-- exclusive 这个值被用来 将两个来自分支的异步调用的job 结果进行持久化。 各自的事务会分别执行ship goods 和send bill， 然后这两个执行都会达到join 节点。 在join 节点中，两个事务会同步到一个相同的执行上（在数据库总更新同一个执行）， 这可能导致一个潜在的乐观锁失败。--> <fork g="99,68,80,40" name="fork"> <!-- 并行的流程分支以独占方式异步执行 --> <on event="end" continue="exclusive" /> <transition g="122,41:" to="ship goods"/> <transition g="123,142:" to="send bill"/> </fork> <java class="org.jbpm.examples.async.fork.Application" g="159,17,98,50" method="shipGoods" name="ship goods"> <transition g="297,42:" to="join"/> </java> <java class="org.jbpm.examples.async.fork.Application" g="159,117,98,50" method="sendBill" name="send bill"> <transition g="297,141:" to="join"/> </java> <join g="274,66,80,40" name="join"> <transition to="end"/> </join>
测试事例代码如下：
ProcessInstance processInstance = executionService.startProcessInstanceByKey("AsyncFork");
String processInstanceId = processInstance.getId();
// 获取异步消息列表
List<Job> jobs = managementService.createJobQuery()
.processInstanceId(processInstanceId).list();
//有两个分支，有2条异步消息
assertEquals(2, jobs.size());
Job job = jobs.get(0);
//手工执行第1条
managementService.executeJob(job.getId());
job = jobs.get(1);
//手工执行第2条
managementService.executeJob(job.getId());
Date endTime = historyService
.createHistoryProcessInstanceQuery()
.processInstanceId(processInstance.getId())
.uniqueResult()
.getEndTime();
// 流程已结束
assertNotNull(endTime);
11. 流程变量
1）流程变量与流程实例绑定， 可通过以下方法来操作流程变量：
例：
ProcessInstance startProcessInstanceById (String processDefinitionId,Map<String,Object>variables); ProcessInstance startProcessInstanceById (String processDefinitionId,Map<String,Object>variables,String processInstanceKey);
2）其它引擎服务中也存在类似的方法，例如TaskService也提供方法操作任务绑定的流程变量。
3）通过流程变量控制流程的流向是正确的做法，但是不要被这种“方便”的机制诱惑而往流程实例里面放所有的东西，
特别是与流转控制无关的业务数据。
五、 JBPM数据表
JBPM4_DEPLOYMENT： 流程定义的部署记录
JBPM4_DEPLOYPROP： 已部署的流程定义的具体属性
JBPM4_LOB：流程定义的相关资源，包括JPDL XML、图片、用户代码Java类等。
JBPM4_JOB：异步活动或定时执行的Job记录。
JBPM4_VARIABLE：流程实例的变量。
JBPM4_EXECUTION：流程实例及执行对象。
JBPM4_SWIMLANE：任务泳道。
JBPM4_PARTICIPATION：任务参与者，任务的相关用户，区别于任务的分配人。
JBPM4_TASK：流程实例的任务记录。
JBPM4_HIST_PROCINST：保存历史的流程实例记录。
JBPM4_HIST_ACTINST：保存历史的活动实例记录。
JBPM4_HIST_TASK：保存历史的任务实例记录。
JBPM4_HIST_VAR：保存历史的流程变量数据。
JBPM4_HIST_DETAIL：保存流程实例、活动实例、任务实例运行过程中历史明细数据。
JBPM4_ID_USER：保存用户记录。
JBPM4_ID_MEMBERSHIP：保存用户和用户组之间的关联关系。
JBPM4_ID_GROUP：保存用户组记录。