工作流开发指南.doc

《工作流开发指南.doc》由会员分享，可在线阅读，更多相关《工作流开发指南.doc（76页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、【精品文档】如有侵权，请联系网站删除，仅供学习与交流工作流开发指南.精品文档.JBPM开发指南2007年7月目录一、概述4二、第一个流程52.1、开始前的准备52.2 、Hello World 例子6三、学习JPDL113.1 、简介113.2 、流程版本（Version）113.3 、流程定义123.3.1 process-definition(流程定义)123.3.2 node(自动节点)133.3.3 start-state(开始状态)133.3.4 end-state(结束节点)143.3.5 state(状态)143.3.6 task-node (任务节点)153.3.7 fork(

2、分支)163.3.8 join(联合)173.3.9 decision(决策)183.3.10 transition(转换)193.3.11 event(事件)203.3.12 action(动作)203.3.13 script(脚本)223.3.14 expression（表达式）233.3.15 variable(变量)233.3.16 handler(句柄)233.3.17 timer(定时器)243.3.18 create-timer(创建定时器)253.3.19 cancel-timer(取消定时器)263.3.20 task(任务)263.3.21 swimlane(泳道)273.

3、3.22 assignment(委派)283.3.23 controller(控制器)293.3.24 process-state 子流程293.3.25 sub-process 子流程303.3.26 condition 条件303.3.27 exception-handler 异常处理31小结33四、流程中任务的分配374.1 assignment-handler方式的任务分配384.2 swimlane方式的任务分配39五、JBPM持久化425.1 特殊数据库支持425.2 JBPM数据库的安装425.2 JBPM流程发布455.2.1 搭建JBPM的WEB应用465.2.2 发布第一个

4、流程48六、日历(Scheduler)546.1 Scheduler在C/S程序上的应用546.2 Scheduler 在Web上的应用576.3 Scheduler时间的分类60七、异步执行63八、JBPM流程建模与应用648.1 JBPM的建模工具648.1.1 建模工具的安装648.2 公司报销流程示例678.2.1 流程建模678.2.2 流程数据库搭建768.2.3 构建业务表798.2.4 搭建工程828.2.5 报销流程的发布838.2.6 应用程序搭建84九、写在最后100一、概述JBPM是一个扩展性很强的工作流系统，百分百用JAVA语言开发，持久层采用Hibernate实现，

5、理论上说，只要Hibernate支持的数据库JBPM都支持。同时它还能被部署在任何一款JAVA应用服务器上。二、第一个流程2.1、开始前的准备JBPM的工程文件，大家可以到如下网站上去下载： 目前的最新版本是3.2.1，本文就以此版本为例。在这里请大家下载jbpm-starters-kit-3.1.2这样一个版本。在这个版本里包括一个JBPM流程设计器的Eclipse插件，和一个用JBOSS作为服务器的示例流程等相关文件。解压jbpm-starters-kit-3.1.2.rar到某个特定目录，这里我们首先用到的是包里的JBPM目录下的文件。JBPM目录里面是JBPM的Eclipse的工程文件

6、，我们可以用Eclipse导入该工程。从Eclipse的File菜单里选择import Existing Projects into Workspacenext根据向导找到前面提到的JBPM目录就可以把该工程导入到Eclipse当中。如下图：好了，接下来，我们就在这个工程的基础之上来开始我们的第一个流程。2.2 、Hello World 例子我们的第一个流程示例源自JBPM的reference。流程图如下：JBPM的流程定义采用XML的方式（实际绝大多数的流程引擎的流程定义都采用的是这种方式），作为测试XML定义我们既可以写在代码当中，也可以以一个独立的XML文件的形式存在，接下来的例子我们将

7、分别为大家介绍一下这两种情况。我们首先来看看把XML流程定义写在代码中的方式。新建一个Junit的测试用例，测试代码如下：package org.jbpm.tutorial.helloworld;import junit.framework.TestCase;import org.jbpm.graph.def.ProcessDefinition;import org.jbpm.graph.exe.ProcessInstance;import org.jbpm.graph.exe.Token;public class HelloWorldTest extends TestCase public

8、void testHelloWorldProcess() /*这个段测试方法演示了一个流程的在代码中以字符串形式定义和这个流程定义的具体执行。 这个流程定义包含三个节点：一个未命名的开始状态（start-state）， 一个名字为s的状态（state）和一个名字为end的结束状态（end-state）。 下一行的功能是把一段xml文本解析为一个ProcessDefinition，一个ProcessDefinition是一个java对象的形式对流程的正式的描述。*/ ProcessDefinition processDefinition = ProcessDefinition.parseXmlS

9、tring( + + + + + + + + );/*下边的一行根据流程定义构造了的一个具体的执行实例。 构造以后，执行的流程就有了一个被定位在开始状态（start-state）上的主要的执行路径 */ ProcessInstance processInstance = new ProcessInstance(processDefinition);/*构造以后，执行的流程就有了一个主要的执行路径（root token） */ Token token = processInstance.getRootToken();/*当然，构造以后，流程定义的主要的执行路径被定位在开始状态（start-sta

10、te）*/ assertSame(processDefinition.getStartState(), token.getNode(); /*开始流程执行，通过默认的转换（transition）离开开始状态（start-state）*/ token.signal();/*直到运行的流程进入一个等待状态，signal方法将一直被阻塞，运行的流程将要进入第一个等待状态：状态s.因此现在主要的执行路径,定位到了状态s上。 */ assertSame(processDefinition.getNode(s), token.getNode();/*执行signal，流程将继续执行，将通过默认的转换（tr

11、ansition）离开状态s*/ token.signal();/*流程实例已经到达了结束状态。*/ assertSame(processDefinition.getNode(end), token.getNode(); 运行测试，我们看到流程和我们预想的结果完全符合。在这里我们的流程定义是写在一个代码中，XML的定义方式是以通过拼字符串的方式完成的，这种方式给我们带来的结果是不直观，同时流程定义起来也很不方便。除了这种定义方式之外我们可以把刚才那段写在代码里的流程定义信息搬到我们的XML文件里，同样可以达到相同的效果。接下来我们就来看一下这种做法。流程定义文件：helloWorld.xml测

12、试代码：HelloWorldTest.javapackage org.jbpm.tutorial.helloworld;import junit.framework.TestCase;import org.jbpm.graph.def.ProcessDefinition;import org.jbpm.graph.exe.ProcessInstance;import org.jbpm.graph.exe.Token;public class HelloWorldTest extends TestCase public void testHelloWorldProcess() ProcessDe

13、finition processDefinition = ProcessDefinition.parseXmlResource(helloWorld.xml);/*从这里可以看出，与上面那段代码唯一不同之处就是没有字符串形式的流程定义信息了，取而代之的是对流程定义的XML进行解析*/ ProcessInstance processInstance = new ProcessInstance(processDefinition); Token token = processInstance.getRootToken(); assertSame(processDefinition.getStart

14、State(), token.getNode(); token.signal(); assertSame(processDefinition.getNode(s), token.getNode(); token.signal(); assertSame(processDefinition.getNode(end), token.getNode(); 运行测试，得到的结果同上例完全相同。到这里为止，我们已经做了一个非常简单的流程示例，对JBPM的流程定义及使用方法也有了初步的概念，在下面的内容中我们将着重来讨论JBPM的流程定义方法，及各个节点的主要含义及使用方法。三、学习JPDL3.1 、简介

15、JPDL（JBPM Process Definition Language）是JBPM流程定义语言。JPDL详细定义了这个状态图的每个部分，如: 开始、结束状态，状态之间的转换等。这种语言的定义对于用户来说比较容易理解，也比较容易对其进行扩展。一个JBPM的流程定义XML文件中包含一个元素，而一个元素又包含零个或一个元素，零个或多个的元素，一个元素，零个或多个的元素或元素或元素或元素，以及零个或多个的元素，零个或多个和元素，一个元素等等。此外，元素有一个标示符，以“name”属性来表示，这个属性必须存在，用来表示该流程的名称。3.2 、流程版本（Version）我们的流程XML文件定义完成之后

16、，接下来的工作就是要将其发布到对应的数据库中，当我们每次将我们的流程定义部署到数据库时，部署时流程的名称就是前面提过的里定义的name”属性的值。JBPM的版本机制允许在数据库中多个同名流程定义共存，流程实例以当时的最新版本来启动，并且在它的整个生命周期中将保持以相同的流程定义执行。当一个新的版本被部署，新的流程实例以新版本启动，而老的流程实例则以老的流程定义继续执行。在部署的时候，jbpm 安排一个版本（version）号码（数字）给流程定义。为了实现安排version号码，如果它是第一个版本（version），JBPM采取1+或者1。从ProcessDefinition pd=JbpmCo

17、ntext.getGraphSession().findLatestProcessDefinition(processName)中可以通过一个给定的processName查找最近的流程定义，这里的processName就是前面我们在定义流程的时候在里定义的name”属性的值，这个属性就是用来表示该流程的名称。如我们的下列代码就是要列出JBPM数据库里的有所有最后一次发布的流程定义的版本：JbpmContext context=JbpmContext.getCurrentJbpmContext();List ls=context.getGraphSession().findLatestProce

18、ssDefinitions();/*这里返回的List是ProcessDefinition的集合*/3.3 、流程定义3.3.1 process-definition(流程定义)流程定义的根节点，是所有节点的父节点名称类型数量描述name属性可选的流程的名称。swimlane元素0.*流程中使用的泳道。泳道表示流程角色，它们被用于任务分配。start-state元素0.1流程起始状态。注意，没有起始状态的流程是合法的，但是不能被执行。end-state|state|node|task-node|process-state|super-state|fork|join|decision元素0.*流

19、程定义的节点。注意，没有节点的流程是合法的，但是不能被执行。event元素0.*作为一个容器服务于动作的流程事件。action|script|create-timer|cancel-timer元素0.*全局定义的的动作，可以在事件和转换中引用。注意，为了被引用，这些动作必须指定名称。task元素0.*全局定义的任务，可以在动作中使用。exception-handler元素0.*一个异常处理器列表，用于这个流程定义中的委托类所抛出的所有异常。3.3.2 node(自动节点)这种节点和State相反，也称自动节点。当业务程序实例执行到这个节点，不会停止执行。而是会继续往下执行。如果该节点存在多个离

20、开转向。那么，就会执行其中的第一个离开转向，在Node状态中，不需要外部参与者的参与，业务流程的这个部分是自动的、即时完成的。名称类型数量描述action|script|create-timer|cancel-timer事件1用于表示这个节点行为的定制动作。普通节点元素请参考普通节点元素。3.3.3 start-state(开始状态)start-state是我们整个流程的开始节点，所有的流程实例从这里开始。 名称类型数量描述Name属性可选的节点的名称。Task元素0.1起始一个流程实例的任务，或者用来捕获流程发起者Event元素0.*支持的事件类型：node-leave。transition

21、元素0.*离开转换，每个离开节点的转换必须有一个不同的名称。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托类所抛出的所有异常。3.3.4 end-state(结束节点)对于每一个流程定义都会有一个结束节点，与开始节点对应名称类型数量描述Name属性必需的结束状态的名称。event元素0.*支持的事件类型：node-enter。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托类所抛出的所有异常。3.3.5 state(状态)State节点也叫手工节点，进入到这种节点，整个流程的执行就会中断。直到系统外参与者发起继续

22、执行的命令，即调用signal或end方法，业务程序实例的执行才能够继续下去。名称类型数量描述name属性必需的节点的名称。async属性true|false，默认是false如果设置为true，这个节点将会异步执行。请参考”异步执行”章节。transition元素0.*离开转换。每个离开节点的转换必须有一个不同的名称，最多只允许所有离开转换中的一个没有名称。第一个转换被指定为默认转换，当离开节点而没有指定转换时，默认转换发生。event元素0.*支持的事件类型：node-enter|node-leave。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托

23、类所抛出的所有异常。timer元素0.*指定一个定时器，用来监视节点中的一个执行所持续的时间。3.3.6 task-node (任务节点)其性质和node节点一样，在没有task的时候，也都是自动执行，不等待。task-node被归类为一个等待节点，是指在task-node中的task列表中的task没有全部执行完之前，它会一直等待。Task可以在task-node节点下定义，也可以挂在process-definition节点下。最普遍的方式是在task-node节点下定义一个或多个任务。默认情况下，流程在task-node节点会处于等待状态，直到所有的任务被执行完毕。Task的执行是按顺序执

24、行的，任务都完成后，token仍然不会指向后面的节点；需要自己手动调用processInstance.signal()才会驱动流程到下面的节点。名称类型数量描述signal属性可选的unsynchronized|never|first|first-wait|last|last-wait，默认是last。signal指定了任务的完成对流程执行继续的影响。create-tasks属性可选的yes|no|true|false，默认是true。当需要在运行时通过计算来决定哪个任务将被创建时，可以设置为false，如果这样的话，在node-enter事件上加一个动作，在动作中创建任务，并且把create

25、-tasks设置为false。end-tasks属性可选的yes|no|true|false，默认是false。如果设置end-tasks为true，在离开节点时，所有打开的任务将被结束。task元素0.*当执行到达本节点时所应被创建的任务。普通节点元素请参考普通节点元素。为了帮助读者理解task-node节点的signal属性，这里举例如下：对于这样的流程定义： a) 这里没有定义signal属性的值，这就表明当节点中的三个任务都完成后，流程才进入后面的节点b) 当表明token不会在本节点停留，而是直接到后面的节点c) 当表明三个任务都完成后，token仍然不会指向后面的节点；需要自己手动

26、调用processInstance.signal()才会驱动流程到下面的节点d) 当表明只要有一个任务完成后，token就指向后面的节点e) 当表明当第一个任务实例完成时继续执行；当在a节点入口处没有任务创建时，token在a任务节点处等待，直到任务被创建或完成。f) 当时，这是默认值，和不设置signal属性的情况相同。g) 当时，当最后一个任务实例完成时候继续执行下去。 当a这个任务节点没有任务被建立时,任务节点等待直到任务被建立。3.3.7 fork(分支)一个fork把一个执行路线分割成多个执行路线. 默认分支的行为是为每个离开分支转换建立一个子令牌,在令牌要到达的分支之间建立一个父母

27、-子女关系名称类型数量描述name属性必需的节点的名称。async属性true|false，默认是false如果设置为true，这个节点将会异步执行。请参考”异步执行”章节。transition元素0.*离开转换。每个离开节点的转换必须有一个不同的名称，最多只允许所有离开转换中的一个没有名称。第一个转换被指定为默认转换，当离开节点而没有指定转换时，默认转换发生。event元素0.*支持的事件类型：node-enter|node-leave。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托类所抛出的所有异常。timer元素0.*指定一个定时器，用来监视节点

28、中的一个执行所持续的时间。3.3.8 join(联合)默认联合(join)假设所有来自同一个父母的子令牌联合，当在上使用fork(分支)这个情形就出现了并且所有令牌分支建立，并且到达同一个联合(join)。当全部令牌都进入联合的时候联合就结束了， 然后联合将检查父母-子女， 当所有兄弟令牌到达联合(join)，父母令牌将传播(唯一的)离开转换，当还有兄弟令牌活动时，联合的行为将作为等待状态。名称类型数量描述name属性必需的节点的名称。async属性true|false，默认是false如果设置为true，这个节点将会异步执行。transition元素0.*离开转换。每个离开节点的转换必须有一

29、个不同的名称，最多只允许所有离开转换中的一个没有名称。第一个转换被指定为默认转换，当离开节点而没有指定转换时，默认转换发生。event元素0.*支持的事件类型：node-enter|node-leave。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托类所抛出的所有异常。timer元素0.*指定一个定时器，用来监视节点中的一个执行所持续的时间。对于Join节点，我们知道默认是要等到所有分支都到了流程才能往下继续走，要改变这一情况，我们可以通过给该节点加Action的方法改变该Join节点的Discriminator，就可以使只要有一个分支到达流程就可以继

30、续执行的效果了，如下面的Action:package workflow.test.action;/这里通过设置Discriminator可以实现只要有一个分支到达流程就可以继续了，/它的默认值是falseimport org.jbpm.graph.def.ActionHandler;import org.jbpm.graph.exe.ExecutionContext;import org.jbpm.graph.node.Join;public class JoinAction implements ActionHandlerpublic void execute(ExecutionContex

31、t arg0) throws Exception Join join=(Join)arg0.getNode();join.setDiscriminator(true);3.3.9 decision(决策)一个decision用以决定在多个执行路径中哪个才可以被执行。如果你是一个程序员，把它可以理解成switch case结构即可，一个decision能够具有许多离开的transition。 名称类型数量描述handler元素要么指定“handler”元素，或者在转换上指定条件。一个org.jbpm.jpdl.Def.DecisionHandler的实现名称。transition元素0.*离开转

32、换。决策的离开转换可以被扩展为拥有一个条件，决策会查找条件计算为true的第一个转换，没有条件的转换被认为计算为true（为了建模“otherwise”分支）。请参考condition元素。普通节点元素请参考普通节点元素。Handler所指定的DecisionHandler的实现类里的decide方法返回一个字符串，表示要执行哪个transition，如下例：package mon;import org.jbpm.graph.exe.ExecutionContext;import org.jbpm.graph.node.DecisionHandler;public class ForkDeci

33、sion implements DecisionHandlerpublic String decide(ExecutionContext arg0) throws Exception String dayCount=(String)arg0.getVariable(dayCount);String go=to boss approve;if(Integer.parseInt(dayCount)10)go=to join;return go;3.3.10 transition(转换)转换用来指定节点之间的连接。transition元素放在node里面，那么这个transition就会从这个节点出

34、离开。 名称类型数量描述name属性可选的转换的名称。注意，每个节点的离开转换必须有一个不同的名称。to属性必需的目标节点的分级名称，表示将要达到的那个节点名称. action|script|create-timer|cancel-timer元素0.*发生转换时将要执行的动作。注意，转换的动作无需放入事件（因为只有一个事件）。exception-handler元素0.*一个异常处理器列表，用于这个流程节点中的委托类所抛出的所有异常。3.3.11 event(事件)JBPM定义了一系列与工作流节点元素相关联的事件，例如，流程实例运行过程中，可以触发节点进入（node-enter)、节点离开 （n

35、ode-leave）、流程启动（process-start）、流程结束（process-end）、任务创建（task-create）、 任务分派（task-assign）、任务启动（task-start）等事件。在流程定义时，JBPM的事件均与action绑定。事件的触发将导致相应actions的执行。名称类型数量描述type属性必需的表示相对于事件要放置的元素事件类型。action|script|create-timer|cancel-timer元素0.*在这个事件上将要执行的动作列表。3.3.12 action(动作)一个action是一段java代码。在流程执行期间在一些事件之上定义，这

36、样会在相关事件触发时自动在工作流引擎上执行。名称类型数量描述name属性必需的动作的名称。当动作被指定名称后，它们可以在流程定义中被查出，这对于运行时动作以及仅一次声明动作是有用的。class属性或者用ref-name，或者用expression。实现org.jbpm.graph.def.ActionHandler接口的类的全名。ref-name属性或者用class。所引用动作的名称。如果指定一个引用动作，则本动作不需要再做处理。expression属性或者指定一个class，或者ref-name。一个解决一个方法的jPDL表达式。accept-propagated-events属性可选的ye

37、s|no|true|false，默认是yes|true。如果设置为false，则动作仅在本动作元素的触发事件上被执行。更多信息，请参考“第9.5.4 事件传播”。config-type属性可选的field|bean|constructor|configuration-property。指定动作对象将被怎样创建以及本元素的内容怎样象配置信息那样被动作对象所使用。async属性true|false默认false，这意味着动作将在当前执行的线程中被执行。如果设置为true，一个消息将被发送到命令执行器，并且执行器组件将在一个独立的事务中同步执行动作。请参考”异步执行”章节。内容可选的action的内

38、容可以被作为你定制动作实现的配置信息，这是考虑到可重用的委托类的创建。有关委托配置的更多信息，请参考“第16.2.3节委托配置”。3.3.13 script(脚本)Script里是动作执行的beanshell脚本. 更多有关beanshell的的信息请参考Beanshell的网站： http:/www.beanshell.org 。如下所示 System.out.println(this script is entering node +node); .表格 16.16名称类型数量描述name属性可选的脚本动作的名称。当动作被指定名称后，它们可以在流程定义中被查出，这对于运行时动作以及仅一次声

39、明动作是有用的。Accept-propagated-events属性可选的0.*yes|no|true|false，默认是yes|true。如果设置为false，则动作仅在本动作元素的触发事件上被执行.expression元素0.1beanshell脚本。如果你没有指定variable元素，可以写表达式作为脚本元素的内容（忽略expression元素标签）。variable元素0.*脚本所需变量。如果没有指定变量，则当前令牌的所有变量将被装载到脚本，当你想要限制装载到脚本中的变量数量时使用variable。3.3.14 expression（表达式）Expression里可书写Beanshel

40、l脚本名称类型数量描述内容一个beanshell脚本。3.3.15 variable(变量)一个是变量是一种key-value对。它与过程实例（一次过程执行）相关联。Key是java.lang.string，value是任何java类型的任何pojo。所以任何是java类型，即使不给jbpm知道也能被应用到变量中。JBPM的流程变量在尽量模仿java.util.map的语义。这一点可以通过JBPM的API来了解。也就是说一个变量只能当它被插入时被赋值，任何java类型都可以作为变量中的value。 名称类型数量描述name属性必需的流程变量的名称。access属性可选的默认是read,write，用逗号分割的一个访问列表。迄今为止，使用的访问仅为read，write和required。mapped-name属性可选的默认是变量的名称。用来指定变量名称被映射的名称，mapped-name的含义依赖于这个元素所被使用的上下文。对于一个脚本，将是一个脚本变量名称；对于一个任务控制器，将是任务表