jBPM4.4工作流开发指南
- 格式:pdf
- 大小:2.90 MB
- 文档页数:38
第 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) 下载下来,然后解压到你的硬盘上的什么地方。
JBPM4.4应用开发——入门篇2010-10-27 20:38:24标签:JBPM工作流工作流程入门原创作品,允许转载,转载时请务必以超链接形式标明文章原始出处、作者信息和本声明。
否则将追究法律责任。
/1931202/411612首先简单说说JBPM——java Business Process Management (java 业务流程管理)jBPM是一个框架、一堆开放的源代码。
而非一套“应用程序”。
jBPM的流程引擎可以看做是一个java工程——若干java类、依赖库和配置文件;使用和学习jBPM需要如下条件:1.jBPM的流程定义和运行时的上下文需要被存储到关系型数据库中——可以是基于调试目的的内存数据库HSQLDB,也可以是真正的持久化数据库(MySql,Oracle,PostgreSql,Sybase等等);2.jBPM的流程设计一般都需要一个基于客户端的图形化流程设计器软件,当然在jBPM4版本以后可以支持在web上做流程设计(这要归功于Sigvio项目)3.最终,基于jBPM开发出来的应用程序一般都会被部署到一台应用服务器中,以便服务于来自web的访问、监控和管理等。
注意:在jBPM4.3以后,几乎所有的准备工作(安装数据库,建表,安装应用服务器,安装图形化设计器插件等)jBPM软件包的发布者都帮我们做好了。
只要通过Ant脚本“一键获取”所需要的jBPM4整套开发、运行和管理环境。
在安装jBPM之前首先要安装JDK和Ant。
快速开始--------------------------------------------------------一、1.打开cmd命令控制台:进入到${jbpm.home}/install2.运行脚本:ant demo.setup.tomcat或ant.demo.setup.jboss使用这两个服务器都可以。
具体这个命令做了上面事:请查看install目录下的build.xml文件中的目标。
jBPM开发入门指南jBPM开发入门指南(1)工作流虽然还在不成熟的发展阶段,甚至还没有一个公认的规范标准。
但其应用却已经在快速展开,这说明市场对工作流框架的需求是急迫而巨大的。
我们公司的后台短信管理系统涉及短信编发、领导层层审核等操作,这是一个比较典型的工作流系统。
过去我们用的工作流引擎是 shark ,然后在使用后发现其过于庞大,后台数据库操作频繁而未进行优化,直接导致的后果就是前台操作缓慢。
于是经研究决定,将工作流引擎由 shark 换成 jBPM 。
jBPM 之前是一个开源软件,后加入 JBoss 组织。
正好我们公司也是用 JBoss 的。
不过 jBPM 并没有绑定在 JBOSS 上, Tomcat 等也可以使用它。
jBPM 的正处在不断发展中,做为开源软件的特点,其设计变化往往很大。
所以一些过去的资料可能已经不适用了。
于是作者根据自己的使用经验,重新整理出这份文档,以备学习参考。
注:本文使用的 jBPM 版本为 3.1.1环境准备1、安装JDK所有 JAVA 开发第一个需要安装的,没什么好说的。
记得把系统变量 JAVA_HOME 设上。
2、安装AntAnt 是使用 jBPM 必须的一个工具。
jBPM 中的很多操作都要用到 Ant 。
安装方法:( 1 )先下载: /dist/ant/binaries/ ,选一个如: apache-ant-1.6.5-bin.zip 。
( 2 )解压到 D:\ant (当然其他目录也可以)。
( 3 )设置如下系统变量: ANT_HOME=d:\ant 。
( 4 )把 %ANT_HOME%\bin 加入到系统变量 PATH 中。
3、安装EclipseEclipse 不是开发 jBPM 必须的工具,但它是对 jBPM 开发很有帮助的工具,特别是 jBPM 提供了一个 Eclipse 插件用来辅助开发 jBPM 。
关于 Eclipse 的安装不赘述了,本文用的版本是: Eclipse3.24安装 jBPMjBPM 的下载地址: /products/jbpm/downloadsz JBoss jBPM 是 jBPM 的软件包z JBoss jBPM Starters Kit 是一个综合包,它包括了 jBPM 软件包、开发插件、一个配置好了的基于 JBoss 的 jBPM 示例、一些数据库配置文件示例。
Myeclipse8.6搭建jbpm4.4的开发环境jbpm版本:4.4IDE:myeclipse8.6DB:mysql-5.0.261、Myeclipse中安装jbpm1)、解压jbpm4.42)、打开myeclipse8.6---->选择Help菜单---->选择Myeclipse Configuration Center------>打开第三个选项卡SoftWare----->选择右上角add site---->选折add form archive file-----》找到${jbpm_home}\install\src\gpd 目录下找到jbpm-gpd-site.zip即可!name随便输入即可(比如我输入jbpm)!这样下面就看到多一个jbpm(部分过程看下图)选择“add site”,弹出如下对话框:选择“Add from Archive File”,弹出如下对话框:选择“打开”,弹出如下对话框:选择“OK”,出现如下对话框:3)、一个一个选中jpd下面的文件,点击右击“add to profile”即可!4)、点击右下角“apply change”按钮即可!安装完成后会重启Myeclipse,重启后在新建项目里会多出一项“JBoss jBPM”,如下图所示:2、生成jbpm数据库表(这里以安装mysql为列)a)、先打开mysql数据库新建一个数据库比如jbpm(create database jbpm);b)、打开${jbpm_home}\install\src\db\create 下面,找到mysql的表脚本!c)、全部复制过来粘贴到mysql命令行上(当然也可以source ***.sql方式),3、搭建JBPM4运行环境一、下载JBPM4.3可以到官方下载,然后直接解压就可以了doc: 用户手册,javadoc和开发指南examples: 用户手册中用到的示例流程install: 安装脚本lib: 第三方库和一些特定的jBPM依赖库src: 源代码jbpm.jar: jBPM主库归档二、搭建JBPM4运行环境1、新建一个Java Project项目2、添加依赖库jar包a)jbpm.jar包b)JBPM目录/lib下的所有的jar包,当然了,这里有些是可选的。
jbpm-⼯作流的基本操作删除流程实例:Jbpm流程引擎定义:jbpm,全称是Java Business Process Management(业务流程管理),他是覆盖了业务流程管理,⼯作流管理,服务协作等领域的⼀个开源的,灵活的,易扩展的可执⾏的流程语⾔框架作⽤:jbpm的流程框架⾮常灵活,使⽤起来也⾮常安全,降低开发的风险,同时jbpm拥有⾃⼰的图形化开发⼯具,⾮常⽅便随时了解和掌握运⾏的进程Jbpm的开发步骤:1、引⼊jbpm 4.4 jar2、引⼊jbpm.cfg.xml、jbpm.hibernate.cfg.xml核⼼配置⽂件如图:Jbpm.cfg.xml 配置:<?xml version="1.0" encoding="UTF-8"?><jbpm-configuration><import resource="jbpm.default.cfg.xml" /><import resource="jbpm.businesscalendar.cfg.xml" /><import resource="jbpm.tx.hibernate.cfg.xml" /><import resource="jbpm.jpdl.cfg.xml" /><import resource="jbpm.bpmn.cfg.xml" /><import resource="jbpm.identity.cfg.xml" /><!-- Job executor is excluded for running the example test cases. --><!-- To enable timers and messages in production use, this should be included. --><!--<import resource="jbpm.jobexecutor.cfg.xml" />--></jbpm-configuration>Jbpm.hibernate.cfg.xml 配置:<?xml version="1.0" encoding="utf-8"?><!DOCTYPE hibernate-configuration PUBLIC"-//Hibernate/Hibernate Configuration DTD 3.0//EN""/hibernate-configuration-3.0.dtd"><hibernate-configuration><session-factory><property name="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property><property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property><property name="hibernate.connection.url">jdbc:mysql:///jbpm</property><property name="ername">root</property><property name="hibernate.connection.password">123456</property><property name="hibernate.hbm2ddl.auto">update</property><property name="hibernate.format_sql">true</property><property name="hibernate.show_sql">true</property><mapping resource="jbpm.repository.hbm.xml" /><mapping resource="jbpm.execution.hbm.xml" /><mapping resource="jbpm.history.hbm.xml" /><mapping resource="jbpm.task.hbm.xml" /><mapping resource="jbpm.identity.hbm.xml" /></session-factory></hibernate-configuration>Log4j.properties 配置:### direct log messages to stdout ###log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.Target=System.erryout=org.apache.log4j.PatternLayoutyout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n### direct messages to file mylog.log ###log4j.appender.file=org.apache.log4j.FileAppenderlog4j.appender.file.File=c:/mylog.logyout=org.apache.log4j.PatternLayoutyout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n### set log levels - for more verbose logging change 'info' to 'debug' ###log4j.rootLogger=info, stdout3、创建表结构(有18张表)4、/**5、 * 使⽤jbpm ⽅式创建表结构 18张表6、 */7、public void createTable()8、 {9、 org.jbpm.api.Configuration.getProcessEngine();}流程引擎的使⽤步骤:1 、部署流程实例:1、public void deploy()2、 {3、//通过Configuration 类构建流程引擎对象4、 ProcessEngine processEngine = Configuration.getProcessEngine();5、6、//获取RepositoryService 接⼝服务7、 RepositoryService repositoryService = processEngine.getRepositoryService(); 8、9、//发布的⽅式:零散发布10、 repositoryService.createDeployment()11、 .addResourceFromClasspath("jbpm_test.jpdl.xml")12、 .addResourceFromClasspath("jbpm_test.png")13、 .deploy();14、 }其他发布⽅式:2、启动流程实例:public void startProcessInstanceByKey(){//通过Configuration 类构建流程引擎对象ProcessEngine processEngine = Configuration.getProcessEngine();//获取ExecutionService 对象ExecutionService executionService = processEngine.getExecutionService();executionService.startProcessInstanceByKey("jbpm_test"); //key 默认为流程⽂件名称 }3、查询个⼈任务ProcessEngine processEngine = Configuration.getProcessEngine();TaskService taskService = processEngine.getTaskService();List<Task> list = taskService.findPersonalTasks("员⼯");for(Task t:list){System.out.println("任务编号:"+t.getId());System.out.println("任务名称:"+t.getName());}4、办理个⼈任务public void personalComplete(){ProcessEngine processEngine = Configuration.getProcessEngine();TaskService taskService = processEngine.getTaskService();pleteTask("50002"); //任务id}流程变量设置:public void taskComplete(){TaskService taskService = Configuration.getProcessEngine().getTaskService();Map<String, User> userMap = new HashMap<String, User>();User user = new User();user.setDay(2);user.setName("⼩明");userMap.put("user", user);//办理业务并设置流程变量taskService.setVariables("240002", userMap);pleteTask("240002");}流程引擎ProcessEngine 的六⼤服务接⼝:流程引擎processEngine 对象的获取:通过Configuration 类的构建如:ProcessEngine processEngine = Configuration.getProcessEngine();1、 RepositoryService 接⼝(流程资源服务):RepositoryService service= processEngine.getRepositoryService()作⽤:提供对流程的部署、删除、查询和流程图的查看操作。
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,这里,要修改为连接我们的数据库。
JBPM指南JBPM(Java Business Process Management)是一个开源的、轻量级的、面向业务流程的工作流引擎。
它提供了一套完整的业务流程管理解决方案,包括流程的设计、执行、监控和优化等功能。
它的核心理念是将业务逻辑与技术实现相分离,使得业务流程的设计和执行更加灵活,同时也提高了开发的效率。
本指南旨在为培训机构提供JBPM的相关知识和实践指导,帮助培训机构更好地理解和应用JBPM。
一、JBPM概述1.JBPM的特点:JBPM是基于领域特定语言(DSL)的工作流引擎,支持面向业务流程的开发和管理,可以将复杂的业务流程拆解为多个简单的流程节点进行管理和执行。
2.JBPM的架构:JBPM的架构包括流程定义、流程实例和任务管理三个核心模块,同时还包括与其他系统进行集成的服务和界面模块。
3.JBPM的应用场景:JBPM可以应用于各种复杂的业务流程场景,如订单处理、审批流程、工作流程等。
二、JBPM的安装和配置2.JBPM的配置:介绍JBPM的配置文件,包括数据源配置、日志配置、用户管理等。
三、JBPM的流程设计和执行1. 流程定义:介绍使用JBPM Designer工具进行流程定义的方法,包括创建流程、定义流程节点和流程跳转等。
2.流程执行:介绍JBPM引擎的流程执行过程,包括启动流程实例、执行节点任务、变量传递等。
四、JBPM的任务管理和监控1.任务定义:介绍如何创建和定义任务节点,包括任务的输入输出参数、任务的执行者等。
2.任务管理:介绍如何查询和管理流程中的任务,包括任务的分配、处理和完成等。
3.流程监控:介绍如何监控流程的执行情况,包括查询流程实例状态、查询流程历史记录等。
五、JBPM的集成和扩展1.与其他系统的集成:介绍JBPM与其他系统的集成方法,包括使用RESTAPI、使用消息队列等。
2.JBPM的扩展:介绍如何扩展JBPM的功能,包括自定义节点、自定义任务等。
六、JBPM的最佳实践1.流程建模的最佳实践:介绍如何设计和优化业务流程,包括流程的可读性和可扩展性等。
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的历史记录。
jBPM4.4⼊门指南1.⼯作流与⼯作流管理系统1.1. ⼯作流(Work Flow)⼯作流就是⼯作流程的计算机模型,即将⼯作流程中的⼯作如何前后组织在⼀起的逻辑和规则在计算机中以恰当的模型进⾏表⽰并对其实施计算。
⼯作流要解决的主要问题是:为实现某个业务⽬标,在多个参与者之间,利⽤计算机,按某种预定规则⾃动传递⽂档、信息或者任务。
通俗的说,流程就是多个⼈在⼀起合作完成某件事情的步骤,把步骤变成计算机能理解的⽅式就是⼯作流。
公司内采⽤纸张表单,⼿⼯传递的⽅式,⼀级⼀级审批签字,⼯作效率低下,对于统计报表功能则不能实现。
⽽采⽤⼯作流软件,使⽤者只需在电脑上填写有关表单,会按照定义好的流程⾃动往下跑,下⼀级审批者将会收到相关资料,并可以根据需要修改、跟踪、管理、查询、统计、打印等,⼤⼤提⾼了效率,实现了知识管理,提升了公司的核⼼竞争⼒。
作为⼀个成熟稳定的⼯作流产品,不仅提供⽇常办公和关键业务流程智能化管理,⽽且能根据公司的特殊实际要求轻松⽅便地随时定制各种流程,并可实现不同⾓⾊不同的跟踪、查询、统计、打印等强⼤功能1.2.⼯作流管理系统(Workflow Management System)⼯作流管理系统(WfMS)的主要功能是通过计算机技术的⽀持去定义、执⾏和管理⼯作流,协调⼯作流执⾏过程中⼯作之间以及群体成员之间的信息交互。
⼯作流需要依靠⼯作流管理系统来实现。
⼯作流管理系统是定义、创建、执⾏⼯作流的系统,应能提供以下三个⽅⾯的功能⽀持:1.定义⼯作流:包括具体的活动、规则等2.运⾏控制功能:在运⾏环境中管理⼯作流过程,对⼯作流过程中的活动进⾏调度3.运⾏交互功能:指在⼯作流运⾏中,WfMS与⽤户(活动的参与者)及外部应⽤程序⼯具交互的功能。
⼀、定义⼯作流⼆、执⾏⼯作流1.3.什么地⽅使⽤⼯作流技术OA中的审批流转的功能,其作⽤是能按照指定的流程(步骤)流转要审批的表单(就像流⽔线⼀样)。
有如下问题:1,流程有很多。
1.工作流与工作流管理系统1.1. 工作流(Work Flow)工作流就是工作流程的计算机模型,即将工作流程中的工作如何前后组织在一起的逻辑和规则在计算机中以恰当的模型进行表示并对其实施计算。
工作流要解决的主要问题是:为实现某个业务目标,在多个参与者之间,利用计算机,按某种预定规则自动传递文档、信息或者任务。
通俗的说,流程就是多个人在一起合作完成某件事情的步骤,把步骤变成计算机能理解的方式就是工作流。
公司内采用纸张表单,手工传递的方式,一级一级审批签字,工作效率低下,对于统计报表功能则不能实现。
而采用工作流软件,使用者只需在电脑上填写有关表单,会按照定义好的流程自动往下跑,下一级审批者将会收到相关资料,并可以根据需要修改、跟踪、管理、查询、统计、打印等,大大提高了效率,实现了知识管理,提升了公司的核心竞争力。
作为一个成熟稳定的工作流产品,不仅提供日常办公和关键业务流程智能化管理,而且能根据公司的特殊实际要求轻松方便地随时定制各种流程,并可实现不同角色不同的跟踪、查询、统计、打印等强大功能1.2.工作流管理系统(Workflow Management System)工作流管理系统(WfMS)的主要功能是通过计算机技术的支持去定义、执行和管理工作流,协调工作流执行过程中工作之间以及群体成员之间的信息交互。
工作流需要依靠工作流管理系统来实现。
工作流管理系统是定义、创建、执行工作流的系统,应能提供以下三个方面的功能支持:1.定义工作流:包括具体的活动、规则等2.运行控制功能:在运行环境中管理工作流过程,对工作流过程中的活动进行调度3.运行交互功能:指在工作流运行中,WfMS与用户(活动的参与者)及外部应用程序工具交互的功能。
一、定义工作流二、执行工作流1.3.什么地方使用工作流技术OA中的审批流转的功能,其作用是能按照指定的流程(步骤)流转要审批的表单(就像流水线一样)。
有如下问题:1,流程有很多。
2,不同的公司,流程的具体步骤是不一样的,有时还需要增加新流程或修改现有流程。
JBPM开发指南2007年7月目录一、概述 (4)二、第一个流程 (5)2.1、开始前的准备 (5)2.2 、Hello World 例子 (6)三、学习JPDL (11)3.1 、简介 (11)3.2 、流程版本(Version) (11)3.3 、流程定义 (12)3.3.1 process-definition(流程定义) (12)3.3.2 node(自动节点) (13)3.3.3 start-state(开始状态) (13)3.3.4 end-state(结束节点) (14)3.3.5 state(状态) (14)3.3.6 task-node (任务节点) (15)3.3.7 fork(分支) (16)3.3.8 join(联合) (17)3.3.9 decision(决策) (18)3.3.10 transition(转换) (19)3.3.11 event(事件) (20)3.3.12 action(动作) (20)3.3.13 script(脚本) (22)3.3.14 expression(表达式) (23)3.3.15 variable(变量) (23)3.3.16 handler(句柄) (23)3.3.17 timer(定时器) (24)3.3.18 create-timer(创建定时器) (25)3.3.19 cancel-timer(取消定时器) (26)3.3.20 task(任务) (26)3.3.21 swimlane(泳道) (27)3.3.22 assignment(委派) (28)3.3.23 controller(控制器) (29)3.3.24 process-state 子流程 (29)3.3.25 sub-process 子流程 (30)3.3.26 condition 条件 (30)3.3.27 exception-handler 异常处理 (31)小结 (33)四、流程中任务的分配 (37)4.1 assignment-handler方式的任务分配 (38)4.2 swimlane方式的任务分配 (39)五、JBPM持久化 (42)5.1 特殊数据库支持 (42)5.2 JBPM数据库的安装 (42)5.2 JBPM流程发布 (46)5.2.1 搭建JBPM的WEB应用 (46)5.2.2 发布第一个流程 (48)六、日历(Scheduler) (54)6.1 Scheduler在C/S程序上的应用 (54)6.2 Scheduler 在Web上的应用 (57)6.3 Scheduler时间的分类 (60)七、异步执行 (63)八、JBPM流程建模与应用 (64)8.1 JBPM的建模工具 (64)8.1.1 建模工具的安装 (64)8.2 公司报销流程示例 (67)8.2.1 流程建模 (67)8.2.2 流程数据库搭建 (76)8.2.3 构建业务表 (79)8.2.4 搭建工程 (82)8.2.5 报销流程的发布 (83)8.2.6 应用程序搭建 (84)九、写在最后 (100)一、概述JBPM是一个扩展性很强的工作流系统,百分百用JAVA语言开发,持久层采用Hibernate实现,理论上说,只要Hibernate支持的数据库JBPM都支持。
jbpm4.4常用接口使用说明jbpm任务stringsession设计模式manager在jbpm4.4开发过程中,我们需要使用其提供的接口来完成任务,1.AssignmentHandlerAssignmentHandler是jbpm为我们提供的一个绑定用户,分配任务的接口,我们可以通过实现这个接口来指定Task 的执行者,必须配合jpdl.xml下的标签和程序来使用,web环境下一般都是session中的用户。
举个例子:一个员工提交一个请假申请,如果我们给这个Task添加一个AssignmentHandler,把员工的姓名绑定进去,那么jbpm就会知道,这个流程是这个员工创建的……按正常逻辑请假单已经提交到了领导那,我们可以通过再实现一个AssignmentHandler接口,通过AssignmentHandler动态的对流程实例定义Actor,将领导设置成task的执行者。
这样做的好处就是灵活……当领导登录时,session中是领导的姓名,领导查自己的任务列表就会看到那份员工提交的请假单了。
jpdl.xml的一部分(主要是<assignment-handler >和<decision >两个标签)1.<task assignee="${name}"g="235,146,92,52"name="LeaveApplication">2.<assignment-handler class="com.mtf.jbpm.handler.NewApplicationAssignmentHandler"/> //创建请假单前绑定用户,员工3.<transition g="-113,-17"name="SubmitApply"to="ManagerApprove"/>4.</task>5.<task assignee="${name}"g="244,235,92,52"name="ManagerApprove">6.<assignment-handler class="com.mtf.jbpm.handler.ManagerApproveAssignmentHandler"/>//当请假单流转到manager那时触发,领导7.<transition g="-46,-23"name="ManagerApproved"to="DaysCheck"/>8.<transition g="-15,-35"name="ManagerDisApproved"to="end"/>9.</task>10.<decision g="67,240,48,48"name="DaysCheck">11.<handler class="com.mtf.jbpm.handler.DaysCheckHandler"/> //分支流程12.<transition g="-20,-2"name="LessThan3Days"to="HrMakeSure"/>13.<transition g="-49,-11"name="MoreThan3Days"to="ExecutiveApprove"/>14.</decision>15.∙申请请假单的AssignmentHandler1.public class NewApplicationAssignmentHandler implements AssignmentHandler{2.3.@Override4.public void assign(Assignable assignable, OpenExecution execution)5.throws Exception {6. System.out.println("pxj 创建一leave");7. String name =(String) execution.getVariable("name");8. System.out.println(name);9. assignable.setAssignee(name);10. }11.}∙领导的AssignmentHandler1.public class ManagerApproveAssignmentHandler implements AssignmentHandler{2.3.@Override4.public void assign(Assignable assignable, OpenExecution execution)5.throws Exception {6. System.out.println("经理开始审批");7. String id = (String) execution.getVariable("parentId");8.int managerId = Integer.parseInt(id);9. EmployeeDao employeeDao = new EmployeeDaoImpl();10. Employee e= employeeDao.findEmployeeById(managerId);11. assignable.setAssignee(e.getE_name_cn());12. }13.}其中parentId是请假单提交的时候设定的,解释一下:员工提交请假单当然是提交到自己领导那了,于是我在提交请假单的方法中查找了一下自己领导的id,存在这个parentId中,到这里面在寻找这个人的姓名(领导的名字)通过assignable.setAssignee(e.getE_name_cn()); 将这个Task的执行者设置成领导……于是乎当领导查自己的任务列表时,就能查到自己下属提交的请假单了∙这个方法就是提交请假单的方法,应该写在前面才对,思路有些混乱……1./**2. * submitApplication 2012-7-93. */4.@Override5.public void submitApplication(String actorId, float days,6. ProcessInstance pi, int id) {7. String taskId = processEngine.getTaskService().createTaskQuery()8. .processInstanceId(pi.getId()).uniqueResult().getId();9.// 绑定流程10.// 寻找上级11. LeaveDao dao = new LeaveDaoImpl();12. Leaves leaves = null;13.try {14. List<Leaves> all = dao.queryParentById(id, 1);15.for (int i = 0; i < all.size(); i++) {16. leaves = all.get(i);17. }18. } catch (Exception e) {19. }20. System.out.println("TaskId" + taskId);21. Task tasks = processEngine.getTaskService().getTask(taskId);22. String executionId = tasks.getExecutionId();23. processEngine.getExecutionService().setVariable(executionId,24."parentId",new String(leaves.getL_emp_id()+""));25. processEngine.getExecutionService().setVariable(executionId,"days",26. days);27. processEngine.getTaskService().completeTask(taskId);28.}主要接收:流程实例id,创建人姓名,请假人id,本次总结我只想把jbpm的接口总结一下,关于流程的部分请看下部分。
JBPM4.4相关详细配置及使用文档所需软件:Jbpm 4.4、Myeclipse8.6(或eclipse3.5)、Apache、Tomcat6.0、jdk1.6、sqlserver2000一、Myclipse中安装jbpm插件(以Myeclipse8.6为例)1)下载jbpm4.4并解压;2)打开myclipse→选择help菜单,选择software and workspace center3)选择software然后选择右上角add site4)选择add from archive filejbpm-gpd-site.zip6) name 随便输入即可(比如jbpm )→点击OK ,这样下面就看到多一个jbpm ,一个一个选中jpd 下面的文件,点击右击“add to profile ”,点击右下角“apply change ”按钮7) 安装完成后会重启Myeclipse ,重启后在新建项目里会多出一项“JBoss${jbpm_home}\jbpm-4.4\install\src\gpd\jbp m-gpd-site.zipjBPM”,如下图所示:8)表单定制图形化界面乱码解决:找到安装目录Genuitec\MyEclipse8.5\myeclipse.ini文件添加-Dfile.encoding=UTF-8重启MyEclipse即可。
(注此方法适于MyEclipse7.5以上版本)MyEclipse7.5以下(或eclipse3.5)直接找eclipse安装文件下的eclipse.ini添加-Dfile.encoding=UTF-8二、安装Apache-ant(以1.8.1为例)下载Ant,本文使用apache-ant-1.8.1:/dist/ant/binaries/安装方法如下:1)解压到后的apache-ant-1.8.1目录;2)设置环境变量:在环境变量中添加ANT_HOME,值为安装目录(如F:\java\java_tool\ant\apache-ant-1.8.1);3)把%ANT_HOME%\bin 加入到环境变量 PATH 中;4)测试是否安装成功:在CMD DOS模式下运行 ant -version 回车,看输出说明配置成功三、sqlserver配置(以sqlserver2000为例)1)创建Dynamic Web project或Java project工程;2)右击工程导入jbpm4.4 \lib下所有jar包及jpbm.jar包;3)将解压的jbpm-4.4\examples\src下的所有配置文件拷贝工程src下;配置文件名如下:jbpm.cfg.xml、jbpm.hibernate.cfg.xml、jbpm.mail.properties、jbpm.mail.templates.xml、logging.properties4)修改jbpm.hibernate.cfg.xml<property name="hibernate.dialect">org.hibernate.dialect.SQLServerDialect</property><property name="hibernate.connection.driver_class">net.sourceforge.jtds.jdbc.Driver</property><property name="hibernate.connection.url">jdbc:sqlserver://192.168.1.100:1433;DatabaseName=jbpm</property><property name="ername">sa</property><propertyname="hibernate.connection.password">sa123456</property><property name="hibernate.hbm2ddl.auto">create-drop</property><property name="hibernate.format_sql">true</property>5)下载JDTS第三方驱动(支持SQL2000,2005,SYBASE),下载解压后找jtds-1.2.5.jar并复制WEB-INF/lib目录下,然后右击工程导入此jar驱动包,下载地址:/为什么要用第三方驱动的原因是微软公司的驱动的兼容性不太好如下:✓如果采用jdbc-odbc驱动,那么就必须按照查询顺序来一次读取(不论有没有image或text类型);✓如果采用微软提供的ms sql server jdbc driver,如果查询语句中,不存在image或text类型字段,那么可以按照无序获取;✓如果采用微软提供的ms sql server jdbc driver,如果查询语句中,存在image或text类型字段,那么就必须按照顺序读取,否则就会报告Driver]ResultSet can not re-read row data for column之类的错误;✓如果想不查询语句中有没有image或text类型字段,都可以不按照顺序获取,或重复获取。
JBPM⼯作流⼀.开发环境的搭建1.下载Jbpm4.41.1下载地址:1.2解压后的⽬录2.安装GPD插件(eclipse图形化流程设计器)2.1打开eclipse--------选择help--------选择install new software2.2选择add添加插件:点击Archive选择插件⽬录:插件⽬录所在位置就是下载的解压后的路径中找jbpm-4.4\install\src\gpd2.3选择插件后续直接下⼀步就⾏,等待安装插件。
1.配置运⾏时的环境打开eclipse-------------preference1.配置JPDL xml的schema dtd4.1⽬的有时在建jpdlxml⽂件的时候没有节点的提⽰,我们配置⼀下这个schema dtd,就有提⽰了。
4.2配置步骤打开eclipse-------------preference⼆.JBPM简介2.1什么是jbpmJBPM,全称是Java Business Process Management(业务流程管理),它是覆盖了业务流程管理、、服务协作等领域的⼀个开源的、灵活的、易扩展的可执⾏流程语⾔框架。
2.2为什么⽤jbpm业务分析师和开发⼈员使⽤的是同⼀种语⾔来交谈,⼤⼤降低了开发的风险,如果要开发⼀个项⽬,速度也更快了,因为开发⼈员不⽤再将⽤户需求转化成软件设计了。
其次,JBPM采⽤的不是⼀般的开发⼯具,⽽是⾃⼰的图形化开发⼯具,⾮常⽅便随时了解和掌握运⾏的进程。
最后,JBPM的流程框架⾮常灵活,使⽤起来也⾮常安全,它经过了安全认证,因此可以保证⼀些商业机密不被泄露。
三.开发步骤1.引⼊jar包在jbpm4.4的解压包中根⽬录Jbpm的jar包还有lib⽂件夹中除report-engine,war包外所有jar包注:因为Jbpm4.4是⽤Mysql作为DB的,如果要⽤Oracle作为DB需要引⼊相应的驱动包。
2.创建配置⽂件<?xml version="1.0" encoding="utf-8"?><!DOCTYPE hibernate-configuration PUBLIC"-//Hibernate/Hibernate Configuration DTD 3.0//EN""/hibernate-configuration-3.0.dtd"><hibernate-configuration><session-factory><!-- 连接数据库的⼀些信息 --><property name="hibernate.dialect">org.hibernate.dialect.Oracle10gDialect</property><property name="hibernate.connection.driver_class">oracle.jdbc.driver.OracleDriver</property><property name="hibernate.connection.url">jdbc:oracle:thin:@localhost:1521:orcl</property><property name="ername">jbpm</property><property name="hibernate.connection.password">jbpm</property><property name="hibernate.hbm2ddl.auto">update</property><property name="hibernate.format_sql">true</property><!-- ⼩配置:映射⽂件 --><mapping resource="jbpm.repository.hbm.xml"/><mapping resource="jbpm.execution.hbm.xml"/><mapping resource="jbpm.history.hbm.xml"/><mapping resource="jbpm.task.hbm.xml"/><mapping resource="jbpm.identity.hbm.xml"/></session-factory></hibernate-configuration>3.画流程图新建jpdl.xml⽂件/*** 创建表结构:有18张表*/@Testpublic void createTable(){// 读取配置⽂件new org.hibernate.cfg.Configuration().configure("jbpm.hibernate.cfg.xml").buildSessionFactory(); }18张表的含义:/a757956132/p/4774188.html5.获取⼯作流引擎//获取⼯作流引擎//ProcessEngine processEngine = new Configuration().setResource("jbpm.cfg.xml").buildProcessEngine();//获取⼯作流引擎ProcessEngine processEngine =Configuration.getProcessEngine();6.部署流程定义//获取⼯作流引擎//ProcessEngine processEngine = new Configuration().setResource("jbpm.cfg.xml").buildProcessEngine();//获取⼯作流引擎ProcessEngine processEngine =Configuration.getProcessEngine();7.启动流程实例//获取⼯作流引擎//ProcessEngine processEngine = new Configuration().setResource("jbpm.cfg.xml").buildProcessEngine();//获取⼯作流引擎ProcessEngine processEngine =Configuration.getProcessEngine();8.查询任务@Testpublic void selectMyStack(){//根据指定的⼈员去查看他的任务List<Task> stacks= processEngine.getTaskService().findPersonalTasks("部门经理");System.out.println("经理的任务");for (Task task : stacks) {System.out.println("任务ID:"+task.getId()+"\t任务名称:"+task.getName()+"\t任务的办理⼈:"+task.getAssignee());}}9.查询当前任务所在节点@Testpublic void getActivity(){String name=processEngine.getExecutionService().createProcessInstanceQuery().processInstanceId("jbpm01.10001").uniqueResult().findActiveActivityNames().toString(); System.out.println("当前任务所在节点:"+name);}10.办理任务@Testpublic void saveTask(){processEngine.getTaskService().completeTask("80002");System.out.println("任务办理成功");}流程管理四.流程管理四.4.1部署流程4.2查看所有流程定义的信息@Testpublic void findAll(){List<ProcessDefinition> list = pe.getRepositoryService().createProcessDefinitionQuery().list();for (ProcessDefinition pd : list) {/*** id的格式 name-版本号* name:jbpm.cfg.xml⽂件中根据点的name属性值* key,如果在配置⽂件中指定了,那么就是根据点中的test的值,如果不指定默认是name的值* version版本号,同⼀个名称的第⼀个为1后续的⾃增*/System.out.println("id:"+pd.getId()+"\tname:"+pd.getName()+"\tkey"+pd.getKey()+"\t版本号:"+pd.getVersion()+"\t部署的id:"+pd.getDeploymentId()); }}4.3删除指定id流程信息@Testpublic void deleteByid(){pe.getRepositoryService().deleteDeploymentCascade("100001");System.out.println("删除成功");}4.4删除指定key的所有流程信息@Testpublic void deleteByids(){//01.取出当前key对应的版本信息List<ProcessDefinition> list = pe.getRepositoryService().createProcessDefinitionQuery().processDefinitionKey("jbpmtest").list();for (ProcessDefinition pd : list) {pe.getRepositoryService().deleteDeploymentCascade(pd.getDeploymentId());}System.out.println("删除成功");}4.5获取流程图@Testpublic void getImage() throws Exception{String deploymentId="10001";//根据id去查询所有对应的资源名Set<String> resourceNames = pe.getRepositoryService().getResourceNames(deploymentId);for(String item: resourceNames){System.out.println("资源名称:"+item);}InputStream in=pe.getRepositoryService().getResourceAsStream(deploymentId, resouceName);OutputStream os=new FileOutputStream("D:\\1.png");int a=in.read();while (a!=-1) {os.write(a);a=in.read();}in.close();os.close();System.out.println("成功");}4.6部署zip格式的资源public void addZipResource(){InputStream is=this.getClass().getClassLoader().getResourceAsStream("two.zip");ZipInputStream zs=new ZipInputStream(is);String id= pe.getRepositoryService().createDeployment().addResourcesFromZipInputStream(zs).deploy();System.out.println("部署成功:deploymentid:"+id);}4.7找到所有最新版本的流程定义@Testpublic void findNewVersionInfo(){//查询所有List<ProcessDefinition> list = pe.getRepositoryService().createProcessDefinitionQuery()//.orderAsc(ProcessDefinitionQuery.PROPERTY_VERSION).list();Map<String,ProcessDefinition> map=new java.util.HashMap<String,ProcessDefinition>();for (ProcessDefinition item : list) {map.put(item.getKey(),item);}for (ProcessDefinition pd : map.values()) {System.out.println("id:"+pd.getId()+"\tname:"+pd.getName()+"\tkey"+pd.getKey()+"\t版本号:"+pd.getVersion()+"\t部署的id:"+pd.getDeploymentId()); }4.8设置流程变量public void setVariable() {pe.getExecutionService().setVariable("jbpm01.90001", "请假天数", 18);}@Testpublic void getVariable() {Integer days = (Integer) pe.getExecutionService().getVariable("jbpm01.90001", "请假天数");System.out.println(days);}五.JBPM和SSH整合⽬的:整合jBPM的⽬的就是能够通过注⼊的⽅式得到ProcessEngine实例,因为ProcessEngine是jbpm 的核⼼.1.关于jar包在Tomcat/lib⽬录下添加jBPM软件包⾥的下列三个jar包,删掉Tomact/lib下的el-api2.关于配置⽂件修改jbpm.cfg.xml⽂件<?xml version="1.0" encoding="UTF-8"?><jbpm-configuration><import resource="jbpm.default.cfg.xml"/><import resource="jbpm.businesscalendar.cfg.xml"/><!-- Hibernate的事务管理器 --><!-- <import resource="jbpm.tx.hibernate.cfg.xml" /> --><!-- 修改为Spring的事务管理器 --><import resource="jbpm.tx.spring.cfg.xml"/><import resource="jbpm.jpdl.cfg.xml"/><import resource="jbpm.bpmn.cfg.xml"/><import resource="jbpm.identity.cfg.xml"/><!-- Job executor is excluded for running the example test cases. --><!-- To enable timers and messages in production use, this should be included. --><import resource="jbpm.jobexecutor.cfg.xml" />--></jbpm-configuration>修改applicationcontext.xml⽂件<?xml version="1.0" encoding="UTF-8"?><beans xmlns="/schema/beans"xmlns:xsi="/2001/XMLSchema-instance" xmlns:tx="/schema/tx" xmlns:aop="/schema/aop" xmlns:context="/schema/context" xsi:schemaLocation="/schema/beans/schema/beans/spring-beans.xsd/schema/tx/schema/tx/spring-tx.xsd/schema/aop/schema/aop/spring-aop.xsd/schema/context/schema/context/spring-context.xsd"><!-- 扫描包中注解标注的类 --><context:component-scan base-package="cn"></context:component-scan><!-- 1.引⼊jdbc.properties⽂件 --><bean id="propertyConfigurer"class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"><property name="location"><value>classpath:jdbc.properties</value></property></bean><!-- 2.配置dataSource c3p0数据源 --><bean id="datasource" class="boPooledDataSource"><!-- 数据库连接信息 --><property name="jdbcUrl" value="${jdbc.url}"></property><property name="driverClass" value="${jdbc.driver}"></property><property name="user" value="${ername}"></property><property name="password" value="${jdbc.password}"></property><!-- 其他配置 --><!--初始化时获取三个连接,取值应在minPoolSize与maxPoolSize之间。