4从jBPM3转换到jBPM4

第 1 章导言上一页下一页第 1 章导言最好使用firefox浏览这份教程。

在使用internet explorer的时候会有一些问题。

1.1. 许可证与最终用户许可协议jBPM是依据GNU Lesser General Public License（LGPL）和JBoss End User License Agreement（EULA）中的协议发布的，请参考完整的LGPL协议和完整的最终用户协议。

1.2. 下载可以从sourceforge上下载发布包。

/projects/jbpm/files/1.3. 源码可以从jBPM的SVN仓库里下载源代码。

https:///repos/jbpm/jbpm4/1.4. 什么是jBPMjBPM是一个可扩展、灵活的流程引擎，它可以运行在独立的服务器上或者嵌入任何Java应用中。

1.5. 文档内容在这个用户指南里，我们将介绍在持久执行模式下的jPDL流程语言。

持久执行模式是指流程定义、流程执行以及流程历史都保存在关系数据库中，这是jBPM实际通常使用的方式。

这个用户指南介绍了jBPM中支持的使用方式。

开发指南介绍了更多的、高级的、定制的、没有被支持的选项。

1.6. 从jBPM 3升级到jBPM 4没办法实现从jBPM 3到jBPM 4的升级。

可以参考开发指南来获得更多迁移的信息。

1.7. 报告问题在用户论坛或者我们的支持门户报告问题的时候，请遵循如下模板：聪明的读者可能已经注意到这些问题已经指向了可能导致问题的几点原因：）特别是对依赖库和配置的调整都很容易导致问题。

这就是为什么我们在包括安装和使用导入实现建议配置机制时花费了大量的精力。

所以，在你开始在用户手册覆盖的知识范围之外修改配置之前，一定要三思而行。

同时在使用其他版本的依赖库替换默认的依赖库之前，也一定要三思而行。

第 2 章安装配置2.1. 发布只需要把jBPM (jbpm-4.X.zip) 下载下来，然后解压到你的硬盘上的什么地方。

jBPM­4.3用户手册第六章 jpdl1.Process (流程)process是流程定义的根元素（The top level element representing one process definition）。

表 1. process的属性属性 类型 默认值 是否必须描述name 文本 必须 在与用户交互时， 作为流程名字显示的一个名字或是标签。

key 字母或数字，下划线如果省略的话，key默认与name 相同，但name中的非字母和非数字的字符在key中会被替换为下划线。

可选用来辨别不同的流程定义。

一个流程可以发布多个拥有相同key的version。

对于所有已发布的version，key‐name组合都必须保持一致。

version 整型 从1开始；新部署的版本号在之前部署的最高版本号基础上增1可选 流程的版本号编者注 1‐1实验的主要代码片段如下：ProcessEngine pe = Configuration.getProcessEngine();RepositoryService re = pe.getRepositoryService();String deployId1 = re.createDeployment().addResourceFromClasspath("org/sklse/test/process/sample1.jpdl.xml").deploy(); ProcessDefinition pd1 = re.createProcessDefinitionQuery().deploymentId(deployId1).uniqueResult();System.out.println(pd1.getName() + " " + pd1.getKey() + " " + pd1.getVersion() + " " + pd1.getId());sample1.jpdl.xml的属性为：key="key1" name="sample1"结论一：同一jpdl.xml可以deploy多次，即再次执行re.createDeployment().addResourceFromClasspath("org/sklse/test/process/sample1.jpdl.xml").deplo y();也是可以的，这就是所谓的一个jpdl.xml的多个version，查看这两次发布的ProcessDefinition的version可以发现的确有变化。

1. 流程定义(Process Definition)流程定义是记录在xml文件中的对流程的描述，它包含唯一的流程开始节点和多个流程功能节点，每个节点之间使用transition进行连接。

Process Definition使用id, key和version进行标识，jBPM中可能包含多个key 值相同的Process Definition，key值相同的Process Definition会拥有不同的version 值，而id是使用key-version的形式用来表示唯一的Process Definition的。

jBPM中使用RepositoryService来控制流程定义的发布，浏览，删除等操作。

2. 流程实例(Process Instance)以流程定义为蓝本生成的流程实例，在jBPM属于Execution的一种。

当我们执行start时，会根据流程定义启动一个新的流程实例，然后它会根据流程定义里的节点运行，在遇到state或task时停顿，等待外部用户调用signal，最后会执行到end 节点，结束整个流程。

jBPM中只允许有一个start节点，所以每个流程都是单一入口的，jBPM4中可以允许有多个end节点，所以我们可以在任意位置结束流程。

jBPM中使用ExecutionService来控制流程实例的启动，浏览，执行，删除等操作3. state节点状态结点是一个典型的等待状态。

同任务结点不同的是，状态结点不会向任务列表添加任务实例。

当业务进程需要等待外部系统的干预时，这种结点是很有用的。

（需要外部系统干预，但又不是让人去干预）假设如下情况：在进入该结点时，通过node-enter事件向外部系统发送一个消息，然后结点进入等待状态；当外部系统完成处理，并回送一个消息，这将导致触发一个signal()方法的运行，该方法重新激活正在等待的流程继续下行jBPM中使用ExecutionService来控制对state的signal操作。

PVM提供了一套和token类似的execution过程调度机制，通过对execution的完全操控，节点运行期行为有了无限的可能PVM的流程定义模型上图里的类全是接口。

位于最上层的是ObservableElement，其提供给流程元素以附加Event（事件）的能力。

在ObservableElementImpl里，它持有一个events的集合属性。

对于流程元素来说，典型的事件有：流程启动/结束，节点启动/结束和转移线执行（take）【在Event方法中定义】。

protected Map<String, EventImpl> events;EventImpl透过EventListenerReference实例的集合持有EventListener实例。

这样在引擎执行过程调度时，就非常容易地通过流程元素本身获取事件监听器并在相应的时候执行它们。

EventImpl.javaprotected List<EventListenerReference> listenerReferences;EventListenerReference.javaprotected EventListener eventListener;和传统的观察者模式一致，EventListener接口有且只有一个方法：/** listener to process execution events.** @author Tom Baeyens*/public interface EventListener extends Serializable {/** is invoked when an execution crosses the event on which this listener is registered */void notify(EventListenerExecution execution) throws Exception; }紧接着ObservableElement的是CompositeElement，其扩展了ObservableElement接口。

jBPM4.4一、什么是jBPMJBPM是一个扩展性很强的工作流系统，百分百用JAVA语言开发，持久层采用Hibernate实现，理论上说，只要Hibernate支持的数据库JBPM都支持。

同时它还能被部署在任何一款JAVA应用服务器上。

java Business Process Management :工作流，工作流引擎注:记得j小写,因为j代表java,与Log4j中j一样工作流管理系统不止一中，如还有Intaliol BPMS …但JBoss jBPM灵活性且扩展性高。

jBPM项目于2002.3由Tom Baeyens 发起，2003.12发布1.0版本，2004年10.18发布2.0，并在这天加入了JBOSS组织-→被RedHat公司二、能干什么提供工作流的实现，帮助更好的进行BPM三、jBPM有什么，简介jBPM的Service API 各种服务1：ProcessEngine：流程引擎。

并不负责具体的业务，而是用于获取各种Service。

2：RepositoryService：流程资源服务的接口，如流程定义发布、查询、删除等。

3：ExecutionService：用于操作流程实例的服务，可以进行流程实例发布、查询、流程推进、设置流程变量等操作。

4：TaskService：用于操作人工任务的服务，可以进行任务创建、查询、获取、提交完成、保存、删除等操作。

5：HistoryService：用于操作流程历史的服务，提供对流程历史库（就是已经完成的流程实例）的操作。

比如：历史流程实例，历史活动实例等。

6：IdentityService：用于操作用户、用户组以及成员关系的服务7：ManagementService：流程管理控制服务的接口，只提供异步工作（Job）相关的执行和查询操作。

四、Myeclipse8.5 搭配开发环境1.jbpm-4.4.zip 下载完2.myeclipse→help→Myeclipse Configuration Center →add…….3.找到\jbpm-4.4\install\src\gpd\jbpm-gpd-site.zip 安装这个插件4.记得不要联网安装，不要选source文件5.安装完后window→JBoss jBPM→runtime Location→add 添加jbpm的路径6.添加lib下所有jar包，如果你使用的是tomcat6.0则：要把Juel-api.jar ,juel-impl.jar,juel-engine.jar 拷到tomcat lib 下并把原来的el-api.jar删掉项目中就不要再导上面三个包五、修改配置文件1、将example中的下列配置文件拷贝到java项目的src目录下：jBPM.cfg.xml、jBPM.hibernate.cfg.xml、jBPM.mail.properties、jBPM.mail.templates.xml、process_forms.css2、在以上配置文件中的jBPM.hibernate.cfg.xml，实际上就是我们熟悉的hibernate.cfg.xml，这里，要修改为连接我们的数据库。

一、流程定义1.部署流程定‎义Proce‎s sEng‎i ne proce‎s sEng‎i ne = new Confi‎g urat‎i on().build‎P roce‎s sEng‎i ne();Repos‎i tory‎S ervi‎c e repos‎i tory‎S ervi‎c e = proce‎s sEng‎i ne.getRe‎p osit‎o rySe‎r vice‎();例：布署文件中‎的流程//布署当前目‎录下pd.jpdl.xml文件‎Strin‎g deplo‎y ment‎I d = repos‎i tory‎S ervi‎c e.creat‎e Depl‎o ymen‎t().addRe‎s ourc‎e From‎C lass‎p ath("pd.jpdl.xml").deplo‎y();例：布署网页上‎T extA‎r ea中的‎流程<form actio‎n="jbpm?famil‎y168=deplo‎y" metho‎d="post"><texta‎r ea name="xml" cols=50 rows=15></texta‎r ea><input‎type="submi‎t" value‎="发布"/><input‎type="reset‎" value‎="取消"/></form>在后台处理‎如下：Strin‎g xml = reque‎s t.getPa‎r amet‎e r("xml");repos‎i tory‎S ervi‎c e.creat‎e Depl‎o ymen‎t().addRe‎s ourc‎e From‎S trin‎g("proce‎s s.jpdl.xml", xml).deplo‎y();2.删除流程定‎义类Proc‎e ssDe‎f init‎i on 包含如下属‎性：ID：流程定义I‎D号Deplo‎y ment‎I d：流程定义的‎布署ID号‎Key：关键字name：流程名versi‎o n：版本号数据如下ID Key 名称版本hello‎-1 hello‎ hello‎ 1//获取类Pr‎o cess‎D efin‎i tion‎的属性ID‎Strin‎g id = reque‎s t.getPa‎r amet‎e r("id");//根据流程I‎D获取流程‎定义实例Proce‎s sDef‎i niti‎o n pd = repos‎i tory‎S ervi‎c e.creat‎e Proc‎e ssDe‎f init‎i onQu‎e ry().proce‎s sDef‎i niti‎o nId(id).uniqu‎e Resu‎l t();//根据流程定‎义的布署I‎D号，删除该流程‎定义//注意:jbpm4‎是不允许直‎接根据流程‎定义的ID‎来直接删除‎流程定义的‎，因为还要删‎除其它配置‎数据repos‎i tory‎S ervi‎c e.delet‎e Depl‎o ymen‎t Casc‎a de(pd.getDe‎p loym‎e ntId‎());3.获取全部流‎程定义根据流程名‎获取所有流‎程定义List<Proce‎s sDef‎i niti‎o n> proce‎s sDef‎i niti‎o ns = repos‎i tory‎S ervi‎c e.creat‎e Proc‎e ssDe‎f init‎i onQu‎e ry().order‎A sc( Proce‎s sDef‎i niti‎o nQue‎r y.PROPE‎R TY_N‎AME).list();还可以根据‎以下顺序进‎行排序(org.jbpm.api.Proce‎s sDef‎i niti‎o nQue‎r y)publi‎c stati‎c final‎ng.Strin‎g PROPE‎R TY_D‎E PLOY‎M ENT_‎T IMES‎T AMP "deplo‎y ment‎.times‎t amp" publi‎c stati‎c final‎ng.Strin‎g PROPE‎R TY_I‎D "idPro‎p erty‎.strin‎g Valu‎e"publi‎c stati‎c final‎ng.Strin‎g PROPE‎R TY_K‎E Y "keyPr‎o pert‎y.strin‎g Valu‎e"publi‎c stati‎c final‎ng.Strin‎g PROPE‎R TY_N‎A ME "idPro‎p erty‎.objec‎t Name‎"publi‎c stati‎c final‎ng.Strin‎g PROPE‎R TY_V‎E RSIO‎N "versi‎o nPro‎p erty‎.longV‎a lue"二、流程实例1.启动一个流‎程实例1.1根据ke‎y启动流程‎实例用户必须为‎新启动的流‎程实例分配‎一个key‎，这个key‎是用户执行‎的时候定义‎的且唯一。

（BPM业务流程管理)开发手册第 1 章简介1.1. 目标读者这个开发指南是为了给有经验的开发者看的，这样就可以获得jBPM的完全的灵活性。

在这个开发文档中提及的特性可能当前不会被支持到。

请自行使用。

1.2. 概述第 2 章孵化器解释了最终会放到用户手册中的功能，它们会成为支持的一部分。

要注意孵化器中的功能还没有确保稳定。

（比如这里可能主要的语法或实现在下一个版本中被改变）。

第 3 章BPMN 2.0介绍如何在jBPM中使用BPMN 2.0流程语言。

第 5 章流程虚拟机到第 9 章高级图形执行解释了jBPM的核心，流程虚拟机（PVM），活动和事件监听器是如何建立在它上面的。

第 10 章配置到第 18 章Signavio web建模器解释了jBPM框架的高级用法。

1.3. 源代码和WIKIjBPM的源代码可以在我们的SVN获得：https:///repos/jbpm/jbpm4/这里有一篇关于如何构建源代码的wiki：http:///maven2/org/jbpm/jbpm4/1.5. 依赖库如果你想在自己的项目中安装或部署jBPM，现在也比以前方便了很多：只需要把正确的jar放到系统的classpath下。

我们还没有清理maven pom文件中的依赖描述。

所以我们还不能给出lib 目录下，你需要包含到应用中的，jar 的最小集合。

（参考Jira issue JBPM-2556 然后进行投票，如果你希望让我们知道这些问题对你优先级很高）。

依赖库的版本放在lib，是我们测试过的。

所以我们推荐你使用lib目录下的依赖版本。

为了在这方面帮助你，这里有一个jPDL当前所用的maven依赖的列表：jboss的idm依赖在org.jboss.identity.idm:*部分，可以忽略，包含org.hibernate:hibernate-entitymanager这个列表应该已经让你开始选择一个子集，而不是从${jbpm.home}/lib目录下包含所有依赖库。

jbpm4⼯作流详解jBPM4的学习流程 1>jBPM4通过org.jbpm.pvm.internal.ant.JbpmDeployTask通过读取jbpm.cfg.xml中的JDBC数据连接信息 2>对jbpm4的数据库表简单介绍 3>通过ProcessEngine类的贯穿来获取服务接⼝(Service API)来认识所有的常⽤类 4>对流程定义语⾔中活动⼏个常⽤的介绍 5>事件的介绍 JBPM：部署流程定义 jBPM4通过org.jbpm.pvm.internal.ant.JbpmDeployTask通过读取jbpm.cfg.xml中的JDBC数据连接信息直接将业务流程部署到数据库中。

它不仅可以部署单个业务流程，也可以部署⼀组业务流程归档到服务器上。

jbpm⾸先扫描业务流程归档中所有以.jpdl.xml结尾的⽂件，并解析，然后⽤来发起流程实例，业务流程归档中所有其他资源也会在部署过程中被持久化到数据库中。

所有这些资源被统⼀编号保存在数据库表jbpm4_lob中我们可以通过jbpm4提供的RepositoryService.getResourceAsStream API随时访问这些资源。

jbpm4的数据库表简单介绍JBPM4_DEPLOYMENT 流程定义表 JBPM4_DEPLOYPROP 流程定义属性表JBPM4_EXECUTION 流程实例表 JBPM4_HIST_ACTINST 流程活动(节点)实例表JBPM4_HIST_DETAIL 流程历史详细表JBPM4_HIST_PROCINST 流程实例历史表JBPM4_HIST_TASK 流程任务实例历史表 JBPM4_HIST_VAR 流程变量(上下⽂)历史表JBPM4_ID_GROUP ⾓⾊表 JBPM4_ID_MEMBERSHIP ⽤户⾓⾊表 JBPM4_ID_USER ⽤户表 JBPM4_JOB 定时表 JBPM4_LOB 存储表JBPM4_PARTICIPATION 参与者表 JBPM4_SWIMLANE 泳道表 JBPM4_TASK 任务表 JBPM4_VARIABLE 上下⽂表（1）JBPM4_DEPLOYMENT、（2）JBPM4_DEPLOYPROP及（3）JBPM4_LOB：存储上传⼀个包含png和jpdl.xml的zip包的相关数据 jbpm4_deployment表多了⼀条记录 jbpm4_deployprop表多了四条记录,对应langid,pdid,pdkey,pdversion jbpm4_lob 表多了⼆条记录,保存流程图png图⽚和jpdl.xml （4）JBPM4_HIST_PROCINST与（5）JBPM4_HIST_ACTINST 分别存放的是Process Instance、Activity Instance的历史记录。