jbpm入门例子

1.      jBPM的简单介绍

jBPM是JBOSS下的一个开源java工作流项目，该项目提供eclipse插件，基于Hibernate实现数据持久化存储。

   参考

http://www.jboss.com/products/jbpm

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

http://wiki.jboss.org/wiki/Wiki.jsp?page=JbpmOnOracle

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

环境准备

1、安装JDK

所有 JAVA 开发第一个需要安装的，没什么好说的。记得把系统变量 JAVA_HOME 设上。

2、安装Ant

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 中。

3、安装Eclipse

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/ 　得到如下画面

 

这是一个已经用 jBPM 开发好的用户定单流程，具有下单、审核、估价等流程。它所用的数据库是一个内置的数据库。

以 cookie monster 用户登录，选择“ create new web sale order ”可以创建一个定单。如下图所示，在图左边是填写的定单情况，右边一整个定货流程的示意图，红色框表示流程进行到哪一步了。填写好定单好，选择“ Save and Close Task ”，完成定单提交。

 

选择右上角的“ Login as another user ”以另外一个用户名 ernie 登录。这时可以看到 ernie 用户的任务列表中多了一项。

 

点进去后，显示如下画面。这个示例对中文的支持不好，全都显示成了 unicode 码了。不管这什么多，反正知道是这么回事就行了。在 comment 项填写意见，选 OK 按钮，进入到下一步。如果选择 more info needed 按钮，则打回给 cookie monster 用户修改定单。

 

下面的流程，这里就不再赘述了。在这个很标准的工作流示例中，我们基本可以看到 jBPM 的应用范围还是比较广的。而且从这个示例，我们是看不出有 jBPM 的，也就是说 jBPM 在后台起着作用。

从这个例子，还看不出 jBPM 的优势。不过，如果在一个流程不确定，经常需要变动的项目中， jBPM 的好处将会显然出来。应用 jBPM 后，改变流程只需改变流程描述文件，这将在后面的内容提到。

这是一个已做好的示例，接下来我们将仿造这个实例来开发一个请假流程。
 

4 数据库初始化

jBPM 需要数据库支持， jBPM 会把自己的一个初始化数据存储到数据库，同时工作流的数据也是存储到数据库中的。 jBPM 使用 Hibernate 来做为自己的存储层，因此只要是 Hibernate 支持的数据库， jBPM 也就支持。

 

本文先以 MySQL 为例，然后再以 Oracle 为例，来谈谈 jBPM 的数据库初始化操作。

 

注：在上面的 JBoss 自带的示例中，并没有设置数据库，那是因为 jBPM 默认使用的是内存数据库 hsqldb 。

4.1  MySQL

 

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 库中创建一个个的数据表。

 

 

4.2  Oracle

先安装好 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)

C