1. jBPM的简单介绍
jBPM
是JBOSS下的一个开源java工作流项目,该项目提供eclipse插件,基于Hibernate实现数据持久化存储。
参考
2. jBPM和myeclipse的冲突
当eclipse安装了myeclipse和jBPM时候,可能有冲突,具体表现在jBPM的流程设计器不能在eclipse中使用。
3. Hibernate连接mysql数据库的一般参数
下面的配置参数,根据需要可以修改:
jbpmtest
是mysql中的schema的名字;
GBK
是字符集,可以根据需要修改;
username=root
,mysql数据库的用户名是root;
password=mysql
,mysql数据库的用户密码是mysql;
hibernate.dialect
=
org.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class
=
com.mysql.jdbc.Driver
hibernate.connection.url=
jdbc
:
mysql://localhost/jbpmtest?useUnicode=true&characterEncoding=GBK
hibernate.connection.username
=
root
hibernate.connection.password
=
mysql
hibernate.show_sql
=
true
hibernate.c3p0.min_size=
1
hibernate.c3p0.max_size=
3
4. Hibernate连接Oracle数据库的一般参数
hibernate.dialect
=
org.hibernate.dialect.Oracle9Dialect
hibernate.connection.driver_class=
oracle.jdbc.driver.OracleDriver
hibernate.connection.url
=
jdbc:oracle:thin:@
localhost
:1521:orcl hibernate.connection.username=
jbpm
hibernate.connection.password
=
jbpm
5. 为jBPM创建数据库表等内容
5.1. 为mysql创建数据库以及数据内容
JbpmSessionFactory.buildJbpmSessionFactory
().
getJbpmSchema().dropSchema();
JbpmSessionFactory.buildJbpmSessionFactory
().
getJbpmSchema().createSchema();
这2个语针对mysq有效.
5.2. 为oralce创建数据库以及数据内容
JbpmSessionFactory.buildJbpmSessionFactory
().
getJbpmSchema().dropSchema();
JbpmSessionFactory.buildJbpmSessionFactory
().
getJbpmSchema().createSchema();
上面的语句对
oralce无效。
模型目录jBPM\jbpm_database\jBPM_oralce10g.pdm 是
jBPM的
Oralce模型,包含对应的Sequence的信息.
需要在数据库中创建 Sequence name=
hibernate_sequence
5.3. 流程信息保存到数据库
JbpmSessionFactory
factory =
JbpmSessionFactory.buildJbpmSessionFactory();
JbpmSession session = factory.openJbpmSession();
GraphSession graphSession = session.getGraphSession();
session.beginTransaction();
/// new ProcessDefinition 实例
ProcessDefinition myProcessDefinition = null;
ProcessInstance processInstance = new ProcessInstance(processDefinition);
processInstance.getContextInstance().setVariable("myvar","xxx");
///
graphSession.saveProcessDefinition(myProcessDefinition);
session.commitTransaction();
session.close
();
jBPM和
Hibernate,MySQL的使用中会遇到字符集的问题.
需要注意几个地方。
5.4. 在Mysql安装过程指定字符集
在
Mysql安装过程中指定相应的默认字符集是GBK
5.5. Hibernate.properties文件中的字符集设置
hibernate.connection.url=jdbc:mysql://localhost/jbpmtest?useUnicode=true&characterEncoding=GBK
5.6. hibernate.cfg.xml 文件中的字符集设置
<
property name="hibernate.connection.url">jdbc:mysql://192.168.1.2/jbpmtest</property>
5.7. MySQL的配置文件的修改:
my.ini中 default-character-set=GBK
注意有2处需要修改
6. 为流程定义变量
分成3种流程变量
全局变量(全局流程变量)
全局临时变量(全局流程临时变量)
局部变量(流程某个接点内有效的变量)
@see org.jbpm.context.exe.ContextInstance
目前还没有使用过局部变量(流程某个接点内有效的变量)
流程变量的定义
6.1. 流程变量的类型
·
java.lang.String
·
java.lang.Boolean
·
java.lang.Character
·
java.lang.Float
·
java.lang.Double
·
java.lang.Long
·
java.lang.Byte
·
java.lang.Short
·
java.lang.Integer
·
java.util.Date
·
byte[]
·
java.io.Serializable
·
classes that are persistable with hibernate
所有基本类型的包裹类型,以及实现了
Serializable
的类型都可以作为流程参数变量使用,注意参数类不能是一个类的内部类或者属性类(除非包含参数类的类实现了Serializable接口)
参考 org.jbpm.context.exe.VariableInstance
6.2. 流程变量的使用
l 变量的定义和获取
void
ContextInstance.setVariable(String variableName, Object value);
void
ContextInstance.setVariable(String variableName, Object value, Token token);
Object ContextInstance.getVariable(String variableName);
Object ContextInstance.getVariable(String variableName, Token token);
l
Variables can be deleted with
ContextInstance.deleteVariable
(
String variableName);
ContextInstance.deleteVariable
(
String variableName, Token token);
6.3. Variable lifetime
一个变量在被定义后,在变量从
ContextInstance
删除前,都可以被访问。当变量被删除后,去获取该变量将返回为空。
6.4. 自定义类的实例作为流程变量
如果一个类的实例要作为流程变量使用,该类需要实现
java.io.Serializable
接口,并且定义序列化版本.
//一个可以作为流程变量使用的类
class
Wdz implements Serializable{
//为类指定序列化版本号
private static final long serialVersionUID = 1L;
private String name="wdz";
private int age=10;
public String toString(){
return "name="+name+",age="+age;
}
}
上面的例子中,如果把类
Wdz作为类
WdzParent内部类使用,然后当成流程变量使用,那类
WdzParent必须 也实现
Serializable接口,否则会有问题.
6.5. Transient variables
流程的历史变量是不能持久化的,作用范围是对整个流程全局有效的。
在
ContextInstance类内部,采用的是一个Map来存储
TransientVariable的信息
参考代码
org.jbpm.context.exe.ContextInstance 的源代码。
主要的相关方法
public
void deleteTransientVariable(java.lang.String name)
public
void setTransientVariable(java.lang.String name,
java.lang.Object value)
public
java.lang.Object getTransientVariable(
java.lang.String
name)
6.6. Variables overloading
当一个变量和流实例关联(变量名字=
”wdz”,value=”test”),如果在设置一个变量
(变量名字=
”wdz”,value= new Integer(10)) ,那最后变量(变量名字=
”wdz)的值是Integer(10)。
这称之为overload.
6.7. Variables overriding
如果父流程有变量A(值=
”value1”),子流程又定义了变量A值=
”value2”,那在子流程范围内,获取变量A的值,那结果是值=
”value2”。这是遵循一般语言的局部变量在它的局部范围内override上级变量。
6.8. 流程变量的持久化
它依赖于流程实例的持久化,非
TransientVariable随流程实例的持久化一起被保存。
保存在数据表
jbpm_variableinstance
参考 org.jbpm.context.exe.VariableInstance
6.9. Customizing variable persistence (可以进一步了解)
User java
object <---> converter <---> variable instance
也就是自定义类的持久化需要定义自己的
converter
和变量实例类
converter
和变量实例类需要继承
org.jbpm.context.exe.VariableInstance
converter
需要实现
org.jbpm.context.exe.Converter
接口
一
工作流虽然还在不成熟的发展阶段,甚至还没有一个公认的规范标准。但其应用却已经在快速展开,这说明市场对工作流框架的需求是急迫而巨大的。
我们公司的后台短信管理系统涉及短信编发、领导层层审核等操作,这是一个比较典型的工作流系统。过去我们用的工作流引擎是 shark ,然后在使用后发现其过于庞大,后台数据库操作频繁而未进行优化,直接导致的后果就是前台操作缓慢。于是经研究决定,将工作流引擎由 shark 换成 jBPM 。
jBPM 之前是一个开源软件,后加入 JBoss 组织。正好我们公司也是用 JBoss 的。不过 jBPM 并没有绑定在 JBOSS 上, Tomcat 等也可以使用它。
jBPM 的正处在不断发展中,做为开源软件的特点,其设计变化往往很大。所以一些过去的资料可能已经不适用了。于是作者根据自己的使用经验,重新整理出这份文档,以备学习参考。
注:本文使用的 jBPM 版本为 3.1.1
环境准备
所有 JAVA 开发第一个需要安装的,没什么好说的。记得把系统变量 JAVA_HOME 设上。
Ant 是使用 jBPM 必须的一个工具。 jBPM 中的很多操作都要用到 Ant 。
安装方法:
( 1 )先下载: http://archive.apache.org/dist/ant/binaries/ ,选一个如: apache-ant-1.6.5-bin.zip 。
( 2 )解压到 D:\ant (当然其他目录也可以)。
( 3 )设置如下系统变量: ANT_HOME=d:\ant 。
( 4 )把 %ANT_HOME%\bin 加入到系统变量 PATH 中。
Eclipse 不是开发 jBPM 必须的工具,但它是对 jBPM 开发很有帮助的工具,特别是 jBPM 提供了一个 Eclipse 插件用来辅助开发 jBPM 。关于 Eclipse 的安装不赘述了,本文用的版本是: Eclipse3.2
安装 jBPM
jBPM 的下载地址: http://www.jboss.com/products/jbpm/downloads
l JBoss jBPM 是 jBPM 的软件包
l JBoss jBPM Starters Kit 是一个综合包,它包括了 jBPM 软件包、开发插件、一个配置好了的基于 JBoss 的 jBPM 示例、一些数据库配置文件示例。
l JBoss jBPM Process Designer Plugin 是辅助开发 jBPM 的 Eclipse 插件。
l JBoss jBPM BPEL Extension jBPM 关于 BPEL 的扩展包
本指南选择下载: JBoss jBPM Starters Kit 。下载后解压到 D:\jbpm-starters-kit-3.1 ,目录下含有五个子目录:
l jbpm jBPM 的软件包
l jbpm-bpel 只含有一个网页
l jbpm-db 各种数据库 hibernate 配置文件示例,有些还包含了相应的 jdbc 驱动程序。
l jbpm-designer 辅助开发 jBPM 的 Eclipse 插件,具体在 jbpm-gpd-feature 子目录中
l jbpm-server 一个已经配置好了的基于 JBoss 的 jBPM 示例 .
感觉下工作流
前面我们说了,在 JBoss jBPM Starters Kit 的 jbpm-server 目录是一个已经配置好的了 jBPM 示例,那么让我们来感觉一下 jBPM 做出的东西吧。
双击 jbpm-server 目录下的 start.bat 文件,启动 JBoss 服务。这时会打开一个 DOS 窗口,启动完成后,日志会不断输出,其中最后一句是“ 13:55:39,937 DEBUG [StaticNotifier] going to wait for (CMD_EXECUTOR, java.lang.Object@1df59bd) ”,这表示 jBPM 在开始工作了,它不断进行轮询。
打开网页: http://localhost:8080/jbpm/ 得到如下画面 ![](http://www.360doc.com/UserImage/2434/20060828090520397.bmp)
这是一个已经用 jBPM 开发好的用户定单流程,具有下单、审核、估价等流程。它所用的数据库是一个内置的数据库。
以 cookie monster 用户登录,选择“ create new web sale order ”可以创建一个定单。如下图所示,在图左边是填写的定单情况,右边一整个定货流程的示意图,红色框表示流程进行到哪一步了。填写好定单好,选择“ Save and Close Task ”,完成定单提交。 ![](http://www.360doc.com/UserImage/2434/jg/20060828090708101.bmp)
选择右上角的“ Login as another user ”以另外一个用户名 ernie 登录。这时可以看到 ernie 用户的任务列表中多了一项。 ![](http://www.360doc.com/UserImage/2434/jg/20060828090807912.bmp)
点进去后,显示如下画面。这个示例对中文的支持不好,全都显示成了 unicode 码了。不管这什么多,反正知道是这么回事就行了。在 comment 项填写意见,选 OK 按钮,进入到下一步。如果选择 more info needed 按钮,则打回给 cookie monster 用户修改定单。 ![](http://www.360doc.com/UserImage/2434/jg/20060828090908955.bmp)
下面的流程,这里就不再赘述了。在这个很标准的工作流示例中,我们基本可以看到 jBPM 的应用范围还是比较广的。而且从这个示例,我们是看不出有 jBPM 的,也就是说 jBPM 在后台起着作用。
从这个例子,还看不出 jBPM 的优势。不过,如果在一个流程不确定,经常需要变动的项目中, jBPM 的好处将会显然出来。应用 jBPM 后,改变流程只需改变流程描述文件,这将在后面的内容提到。
这是一个已做好的示例,接下来我们将仿造这个实例来开发一个请假流程。
4 数据库初始化
jBPM 需要数据库支持, jBPM 会把自己的一个初始化数据存储到数据库,同时工作流的数据也是存储到数据库中的。 jBPM 使用 Hibernate 来做为自己的存储层,因此只要是 Hibernate 支持的数据库, jBPM 也就支持。
本文先以 MySQL 为例,然后再以 Oracle 为例,来谈谈 jBPM 的数据库初始化操作。
注:在上面的 JBoss 自带的示例中,并没有设置数据库,那是因为 jBPM 默认使用的是内存数据库 hsqldb 。
1 、首先安装 MySQL 。
MySQL 的安装比较简单,网上也有很多文章,本文不再赘述。本指南所用 MySQL 版本为 MySQL 4.1 ( for windows )。再找一个 MySQL 客户端,目的是方便查看数据库中的数据,本文推荐使用 MySQL 网站上免费提供的“ MySQL Query Brower ”,当然你用其他的客户端也行,比如 MySQL-Front 。
2 、建库
MySQL 中创建一个库,库名: jbpm
3 、生成建表的 SQL 语句并建表
将 jbpm-starters-kit-3.1.1 下的子目录 jbpm 改名为 jbpm.3 ,否则在执行下面的 ant 命令时会报如 jbpm.3 目录不存在的错误:
D:\jbpm-starters-kit-3.1.1\jbpm-db\build.xml:361: The following error occurred while executing this line:
D:\jbpm-starters-kit-3.1.1\jbpm-db\build.xml:68: Basedir D:\jbpm-starters-kit-3.1.1\jbpm.3 does not exist
在 DOS 窗下,进入 D:\jbpm-starters-kit-3.1.1\jbpm-db 目录,执行如下命令:
ant mysql.scripts
执行成功后,在 D:\jbpm-starters-kit-3.1.1\jbpm-db\build\mysql\scripts 目录里生成了四个 sql 文件,它们做什么用的一看名字就知道了。在 MySQL 客户端中执行“ mysql.create.sql ”脚本,这样将在 jbpm 库中创建一个个的数据表。
先安装好 Oracle 服务器。我们公司有现存的 Oracle 服务器,也提供给了我一个属于我自己的用户名,一登录就可以任意在我的库之下创建表了。所以这一步就省了,没有的自个先装好吧。
访问 Oracle 推荐用“ PLSQL Developer ”。不过要连接 Oracle 还要在本机上装上 Oracle 自己的客户端程序,里面提供了 JDBC 包和一些配置。要连接服务器还得配置一下,我一般都是不用 GUI 而直接改 tnsnames.ora 文件,在我的电脑里此文件的目录地址是: D:\oracle\ora92\network\ADMIN\tnsnames.ora ,内容如下 ( 两面有两个配置了 ) :
# TNSNAMES.ORA Network Configuration File: E:\oracle\ora92\network\admin\tnsnames.ora
# Generated by Oracle configuration tools.
WXXRDB_192.168.3.2 =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.3.2)(PORT = 1521))
)
(CONNECT_DATA =
(SID = wxxrDB)
(SERVER = DEDICATED)