jBPM4.0的用户指南（五-1）

第5章的内容太多了，所以我分开写了

[size=x-large]第 5 章 jPDL[/size]

jPDL文件描述的是流程的过程，这篇文章也可以作为jPDL的快速参考文档。

下面是一个jPDL流程文件的例子：

<?xml encoding="utf-8"?>
<process name="Purchase" xmlns="http://jbpm.org/4/jpdl">
<start>
<transition to="Verify supplier" />
</start>
<state name="Verify supplier">
<transition name="Supplier ok" to="Check supplier data" />
<transition name="Supplier not ok" to="Error" />
</state>
<exclusive name="Check supplier data">
<transition name="nok" to="Error" />
<transition name="ok" to="Completed">
</exclusive>
<end name="Completed" />
<end name="Error" />
</process>


[size=large]5.1. process流程处理[/size]

顶级元素（element）是流程处理定义

[size=medium]表 5.1. process流程处理的属性[/size]
属性 类型 默认值 是否必须 描述
name名称 文本 必须 在与用户交互时，作为流程名字显示的一个名字或是标签。
key键 字母或数字字符 如果省略，key会被非字母和非数字的字符替换。 可选（optional） 用来辨别不同的流程定义。拥有同一个key的流程会有多个版本。对于所有已发布的流程版本，key:name这种组合都必须是完全一样的。
version版本 整型 比已部署的key相同的流程版本号高1，如果还没有与之相同的key的流程被部署，那么版本就从1开始。 可选 流程的版本号

[size=medium]表 5.2. process流程的元素[/size]
元素 个数 描述
description描述 0个或1个 描述文本
activities活动 至少1个 流程中会有很多活动，至少要有1个是启动的活动。

[size=large]5.2. Activities活动[/size]

BPMN（Business Process Modeling Notation，业务流程建模符号）：我们在这里不仅涉及了BPMN活动，而且还介绍了BPMN的事件（events）和网关（gateways）
[size=medium]5.2.1. start启动[/size]

简单的说是流程启动的流向（execution），准确地说是流程的一个启动活动（activity）。一个流程至少有一个启动（start）活动（activity），一个启动活动必须有一个向外的跳转（transition），这个跳转会在流程启动的时候被执行。

已知的限制：一个流程处理只能有一个启动节点（start）。
[size=medium]
表 5.3. start启动的属性[/size]
属性 类型 默认值 是否必须 描述
name名称 文本 可选 活动的名字，在启动活动没有内部的跳转（transition）时，name名称是可选的。

[size=medium]表 5.4. start启动的元素[/size]
元素 个数 描述
transition跳转 1 向外的跳转
[size=medium]
5.2.2. State状态节点[/size]

一个等待状态节点。流程处理的流向会在外部触发器调用提供的API之前一直等待。状态节点和其他的活动不一样，它没有其他任何属性或元素。
[size=small]5.2.2.1. 序列状态节点[/size]

让我们看一个用序列连接状态和跳转的例子。
序列状态节点

图 5.1. 序列状态节点

<process name="StateSequence" xmlns="http://jbpm.org/4/jpdl">
<start>
<transition to="a" />
</start>
<state name="a">
<transition to="b" />
</state>
<state name="b">
<transition to="c" />
</state>
<state name="c" />
</process>


下列代码将启动一个流向：

Execution execution = executionService.startProcessInstanceByKey("StateSequence");


创建的流程处理实例会停留在状态节点a的位置，使用signalExecution的方法就会触发一个外部触发器。

String executionId = exectuion.getId();
execution = executionService.signalExectuionById(executionId);


[size=small]5.2.2.2. 可选择的状态节点
[/size]
在第2个状态节点的例子里，我们将演示如何使用状态节点实现路径的选择。
状态节点中的选择

图 5.2. 状态节点中的选择

<process name="State" xmlns="http://jbpm.org/4/jpdl">
<start>
<transition to="wait for response" />
</start>
<state name="wait for response">
<transition name="accept" to="submit document" />
<transition name="reject" to="try again" />
</state>
<sate name="submit document" />
<state name="try again" />


让我们在这个流程处理定义里启动一个新的流程实例。

Execution execution = executionService.startProcessInstanceByKey("StateSequence");


现在，流向到达wait for response状态节点了。流向会一直等待到外部触发器的出现。这里的状态节点拥有多个向外的跳转，外部触发器将为向外的跳转提供不同的信号名（signalName），下面我们将提供accept信号名（signalName）：

executionService.signalExecutionById(executionId,"accept");


流向会沿着名字是accept的向外的跳转继续进行。同样，当使用reject作为参数触发signalExecutionXxx方法时。流向会沿着名字是reject的向外的跳转继续进行。