说明

Jbpm的开发流程可以按如下几步进行：流程的定义、流程的发布、流程实例的启动、流程节点的流转、查看流 程节点图片。本示例是在spring2.0、hibernate3.2、struts1.2下开发。

如果是其它版本的框架也很容易做程 序的迁移。

流程的定义

流程的定义建议使用jbpm提供的eclipse下的插件，图形化配置插件安装文件可以到jbpm-starters-kit-3.1.4"jbpm-designer"jbpm-gpd-feature"eclipse下找到，需注意版本。使用这种方 式可以把定义的流程描述的三个文件压缩成zip包，统一的部署到数据库中，方便b/s系统中显示图片当前节点信息。

1插 件安装

把jbpm-gpd-feature文件夹复制到C:"Program Files"MyEclipse-6.0M1"eclipse"plugins下，注意自己的ecplise路径。

在C:"Program Files"MyEclipse-6.0M1"eclipse"links文件夹下建立jbpm-gpd.link文件。内容如下：path=C:""Program Files""MyEclipse-6.0M1""eclipse""plugins""jbpm-gpd-feature。

这样再重新启动eclipse就可以使用流程定义功能了。

2流 程的定义

在eclipse环境中选择file->new->other下的jboss jbpm->process definition流程定义。要在自己的项目文件中先指定文件要创建的文件夹。

这样会产生三个文件：gpd.xml、processdefinition.xml、processimage.jpg。

processdefinition.xml为描述流程定义文件，本例为：

<?xml version="1.0" encoding="UTF-8"?>

<process-definition name="文档测试流程">

   <start-state name="开始">

      <transition name="提交张三审批" to="张三审批"></transition>

   </start-state>

   <task-node name="张三审批">

      <task name="审批1">

         <assignment actor-id="张三"/>

      </task>

      <transition name="提交李四审批" to="李四审批"></transition>

   </task-node>

   <task-node name="李四审批">

      <task name="审批2">

         <assignment actor-id="李四"/>

      </task>

      <transition name="提交王五审批" to="王五审批"></transition>

   </task-node>

   <task-node name="王五审批">

      <task name="审批3">

         <assignment actor-id="王五"/>

      </task>

      <transition name="结束流程" to="结束"></transition>

   </task-node>

   <end-state name="结束"></end-state>

</process-definition>

processimage.jpg文件是定义流程产生的图片、gpd.xml文件是图形文件的座标说明。用于 在b/s下显示流程流转的图片位置。

本例中的gpd.xml文件

<?xml version="1.0" encoding="UTF-8"?>

<process-diagram name="文档测试流程" width="801" height="477">

 <node name="开始" x="308" y="4" width="140" height="40">

    <transition name="提交张三审批">

      <label x="5" y="-10"/>

    </transition>

 </node>

 <node name="张三审批" x="310" y="90" width="140" height="40">

    <transition name="提交李四审批">

      <label x="5" y="-10"/>

    </transition>

 </node>

 <node name="李四审批" x="313" y="192" width="140" height="40">

    <transition name="提交王五审批">

      <label x="5" y="-10"/>

    </transition>

 </node>

 <node name="王五审批" x="308" y="307" width="140" height="40">

    <transition name="结束流程">

      <label x="5" y="-10"/>

    </transition>

 </node>

 <node name="结束" x="307" y="401" width="140" height="40"/>

7 　 jBPM 的客户端开发

有了前面的 HelloWorld 后台流程，我们就要开始客户端程序了。正如前面提到的，本文不写 JSP ，而改采用 JUnit 的形式，输出则用 System.out.println 。举一反三，知道在方法中输入及用 println 输出，在 JSP 和 SWING 等 GUI 界面还不是一样嘛。

这个 JUnit 客户端，我们就借用创建项目时自动生成的 SimpleProcessTest.java 了，改写后如下：

http://97wen.com/

http://77.haowyt.com/

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 目录不存在的错误：

在 DOS 窗下，进入 D:\jbpm-starters-kit-3.1.1\jbpm-db 目录，执行如下命令：

执行成功后，在 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 ，内容如下 ( 两面有两个配置了 ) ：

前面都是 Oracle 的一些知识，不会的 Google 一下吧。最后配置好后，用 PLSQL Developer 输入你的用户名和密码联接到 Oracle ，就算 OK 了。

参考上面 MySQL 的步骤，基本一样：

（1）       将 jbpm 改名为 jbpm.3

（2）       再执行 ant oracle.scripts

（3）       用 jbpm-db\build\oracle\scripts 目录的 oracle.create.sql 脚本，在 Oracle 中生成 jBPM 的所有表。在“ PLSQL Developer ”中可以新建一个 Command Windows 窗口然后输入命令： @D:\jbpm-starters-kit-3.1.1\jbpm-db\build\oracle\scripts\oracle.create.sql

工作流虽然还在不成熟的发展阶段，甚至还没有一个公认的规范标准。但其应用却已经在快速展开，这说明市场对工作流框架的需求是急迫而巨大的。

我们公司的后台短信管理系统涉及短信编发、领导层层审核等操作，这是一个比较典型的工作流系统。过去我们用的工作流引擎是 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 后，改变流程只需改变流程描述文件，这将在后面的内容提到。

jBPM(一): 开场白, 想从jBMP中学点什么?

豆豆网   技术应用频道   2009年04月16日  【字号：小 中 大】 收藏本文

<?xml version="1.0" encoding="UTF-8"?>
<process-definition
xmlns=""  name="test1">
<start-state name="start">
<transition name="" to="部门经理审批"></transition>
</start-state>
<task-node name="部门经理审批">
<task>
<assigment actorId="部门经理"></assigment>
</task>
<transition name="" to="总经理审批"></transition>
</task-node>
<task-node name="总经理审批">
<task>
<assigment actorId="总经理"></assigment>
</task>
<transition name="" to="end1"></transition>
</task-node>
<end-state name="end1"></end-state>
</process-definition>

package com.jbpm.test;
import junit.framework.TestCase;
import org.jbpm.JbpmConfiguration;
public class TestJbpm_01 extends TestCase {
public void testJbpm(){
//创建jbpm数据库表。他就像hibernate里面的哪个export一样。实际上他就是hibernate里面的哪个export。
//应为他映射了很多个表，所以我们就能创建那么多个表。
JbpmConfiguration.getInstance().createSchema();
}
}

package com.jbpm.test;
import junit.framework.TestCase;
import org.jbpm.JbpmConfiguration;
import org.jbpm.JbpmContext;
import org.jbpm.graph.def.ProcessDefinition;
public class TestJbpm_02 extends TestCase {
//jbpmConfiguration对象的创建
static JbpmConfiguration jbpmConfiguration = JbpmConfiguration.getInstance();
public void testJbpm(){
//然后我们把processDefinition里面相关的对象持久化到数据库里面去。
//流程定义文件里面有很多个概念，他有node，有transition，还有processDefinition，那么我们不需要一个
//一个保存，jbpm把保存这么多对象的方法封装成一个接口，叫做deployProcessDefinition。我们只要调用这个
//方法，传一个processDefinition对象，我们就能将他们存入到数据库里面去。
//这个首先第一步我们要得到一个processDefinition对象，然后我们把他部署到流程中去。
ProcessDefinition processDefinition = ProcessDefinition.parseXmlResource("testJBPM/testJbpm.xml");
//我们要存就必须获得一个session对象，而jbpm已经把session对象封装到一个JbpmContext对象里面了。
//那么这个jbpmContext对象是怎么得到的呢，我们要先有一个jbpmConfiguration对象，我们要对数据库进行
//操作的时候一定要有jbpmConfiguration这个对象，用他来创建一个类似于hibernate当中的session一样的
//对象——jbpmContext。他是我们对数据库所有的操作的一个接口。
JbpmContext jbpmContext = jbpmConfiguration.createJbpmContext();
try{
//然后部署的操作已经由jbpmContext给我们创建好了，我们只需要调一下他的一个方法就可以了。
jbpmContext.deployProcessDefinition(processDefinition);
}finally{
//最后我们还要对他close一下，就像我们用hibernate的时候要close session一样。
jbpmContext.close();
}
}
}

package com.jbpm.test;
import junit.framework.TestCase;
import org.hibernate.Session;
public class TestJbpm_03 extends TestCase {
public void testJbpm(){
Session session = null;
try{
session = HibernateUtil.getSession();
session.beginTransaction();
Document doc = new Document();
doc.setTitle("title3");
doc.setContent("this is content3");
session.save(doc);
session.getTransaction().commit();
}catch(Exception e){
e.printStackTrace();
session.getTransaction().rollback();
}finally{
HibernateUtil.closeSession(session);
}
}
}

package com.jbpm.test;
import junit.framework.TestCase;
import org.jbpm.JbpmConfiguration;
import org.jbpm.JbpmContext;
import org.jbpm.graph.def.ProcessDefinition;
import org.jbpm.graph.exe.ProcessInstance;
/**
/*
/*将申请单和流程实例绑定
/*
public class TestJbpm_04 extends TestCase {
static JbpmConfiguration jbpmConfiguration = JbpmConfiguration.getInstance();
public void testJbpm(){
JbpmContext jbpmContext = jbpmConfiguration.createJbpmContext();
jbpmContext.setSessionFactory(HibernateUtil.getSessionFactory());
try {
ProcessDefinition processDefinition = jbpmContext.getGraphSession().findLatestProcessDefinition("testJbpm");
ProcessInstance processInstance = new ProcessInstance(processDefinition);
jbpmContext.save(processInstance);
//将我们的document和instance绑定。
long processInstanceId = processInstance.getId();
Document document = (Document)jbpmContext.getSession().load(Document.class,1);
document.setProcessInstanceId(processInstanceId);
jbpmContext.getSession().update(document);
processInstance.getContextInstance().setVariable("document", document.getId());
}catch(Exception e){
e.printStackTrace();
}finally{
jbpmContext.close();
}
}
}

package com.jbpm.test;
import junit.framework.TestCase;
import org.jbpm.JbpmConfiguration;
import org.jbpm.JbpmContext;
import org.jbpm.graph.exe.ProcessInstance;
public class TestJbpm_05 extends TestCase {
static JbpmConfiguration jbpmConfiguration = JbpmConfiguration.getInstance();
public void testJbpm(){
JbpmContext jbpmContext = jbpmConfiguration.createJbpmContext();
jbpmContext.setSessionFactory(HibernateUtil.getSessionFactory());
try{
Document document = (Document)jbpmContext.getSession().load(Document.class, 3);
long processInstanceId = document.getProcessInstanceId();
ProcessInstance processInstance = jbpmContext.getProcessInstance(processInstanceId);
processInstance.signal();
}finally{
jbpmContext.close();
}
}
}