jBPM工作流部署

jBPM工作流部署

——发布到Tomcat + Oracle

实验背景：

系统环境：

Windows 2003 | SUN JDK1.6U4 | Tomcat 6.0.14 | jbpm-starters-kit-3.1.4 | Oracle 10g

主机完整名称：

       pc148

浏览器

       Internet Explorer 6.0

实验准备：

1、  安装JDK与Oracle

JDK的安装这里就不多说了，学过Java的人都知道，本实验安装的是jdk-6u4版本。安装完后记得添加JAVA_HOME的环境变量。

Oracle的安装不属于本文的介绍范围，请参阅相关文档。本实验安装的是Oracle 10g 10201版本，安装完后建立的数据库实例名为ORCL，创建的用户名为jbpmuser，密码为shine。

2、  安装Tomcat

下载安装Tomcat- 6.0.16 是目前最新版本：http://apache.mirror.phpchina.com/tomcat/tomcat-6/v6.0.16/bin/apache-tomcat-6.0.16.exe ；要在JDK安装之后安装Tomcat，安装过程中会自动搜索JRE的目录，当然也可以选择其它的JRE，其它默认设置即可。

3、  安装Ant

Ant 是一个编译工具，使用 jBPM 时必须用它来编译文件， jBPM 中的很多操作都要用到 Ant ，安装方法如下：

（1） 先下载：http://apache.mirror.phpchina.com/ant/binaries/apache-ant-1.7.0-bin.zip；

（2） 解压到 E:/Java/tools/apache-ant- 1.7.0 （当然其他目录也可以）；

（3） 设置环境变量：ANT_HOME= E:/Java/tools/apache-ant- 1.7.0 ；

（4）把 %ANT_HOME%/bin 加入到环境变量 PATH 中。

4、  安装jBPM

下载jBPM ，目前最新版本为 3.1.4 ：http://jaist.dl.sourceforge.net/sourceforge/jbpm/jbpm-starters-kit-3.1.4.zip。是个压缩包，下载后解压到 E:/Java/tools/jbpm-starters-kit-3.1.4 ，目录下共含有五个子目录：

l          jbpm —— jBPM 的软件包，包含源代码和编译后的jar包，以及依赖类库、文档与样例。同时，这也是个完整的Eclipse项目，可以直接以外部项目导入到Eclipse中。

l          jbpm-bpel —— 只含有一个网页

l          jbpm-db —— 各种数据库 hibernate 配置文件示例，有些还包含了相应的 jdbc 驱动程序

l          jbpm-designer —— 辅助开发 jBPM 的 Eclipse 插件，具体在 jbpm-gpd-feature 子目录中

l          jbpm-server —— 一个已经配置好了的基于 JBoss 的 jBPM 示例

5、  安装Eclipse及jBPM开发插件

Eclipse不是开发 jBPM 必须的工具，但它是对 jBPM 开发很有帮助的工具，特别是 jBPM 提供了一个 Eclipse 插件用来辅助开发 jBPM 。关于 Eclipse 的安装请参阅相关文档。本实验安装的是MyEclipse6.0集成Eclipse3.3。

       安装完Eclipse安装jBPM的开发插件，步骤如下：

（1）       打开Eclipse选择菜单“Help->Software Updates->Find and Install”；

（2）       弹出窗口中选择“Search for new features to install”，然后点击“Next >”；如图

（3）       点击按扭“New Local Site…”选择插件目录，位于jbpm-designer/jbpm-gpd-feature/eclipse目录下，如：E:/Java/tools/jbpm-starters-kit- 3.1.4 /jbpm-designer/jbpm-gpd-feature/eclipse。选定后点“OK”，如图

（4）       选中“jbpm-gpd-feature/eclipse”，然后点击“Finish”，如图

（5）       然后选择同意条款，接提示步骤安装就可以了。

 

        到此为止需要的所有工具都安装好了。接下来先体验一下jBPM工作流。在 JBoss jBPM Starters Kit 的 jbpm-server 目录是一个已经在JBoss中配置好的了 jBPM 示例，双击 jbpm-server 目录下的 start.bat 文件，启动 JBoss 服务。打开网页： http://localhost:8080/jbpm 　得到如下页面：

这是一个已经用 jBPM 开发好的用户定单流程，具有下单、审核、估价等流程。它所用的数据库是一个内置的数据库。 以 cookie monster 用户登录，选择“ create new web sale order ”可以创建一个定单。如下图所示，在图左边是填写的定单情况，右边是整个定货流程的示意图，红色框表示流程进行到哪一步了。填写好定单好，选择“ Save and Close Task ”，完成定单提交。

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

点进去后，右边的流程图，红色框表示流程进行到第二步了，在 comment 项填写意见，选 OK 按钮，进入到下一步。如果选择“more info needed”按钮，则打回给cookie monster 用户修改定单，如图。

       接着以bert用户登录选择“wait for money”，填好“money received”后点击“Save and Close Task”结束整个流程。

实验步骤：

       现在要把上面演示的例子部署到Tomcat中，并将数据数配置为Oracle。

STEP 1，初始化数据库

       jBPM 需要数据库支持， jBPM 会把自己的一个初始化数据存储到数据库，同时工作流的数据也是存储到数据库中的。 jBPM 使用 Hibernate 作为的存储层。将jbpm-starters-kit- 3.1.4 下的子目录jbpm改名为jbpm.3，否则在执行下面的ant命令时会报jbpm.3 目录不存在的错误：

在 DOS 窗下，进入E:/Java/tools/jbpm-starters-kit- 3.1.4 /jbpm-db目录，执行ant oracle.scripts命令。执行成功后在E:/Java/tools/jbpm-starters-kit-3.1.4/jbpm-db/build/oracle/scripts目录里生成以下四个sql 文件：

l          oracle.create.sql —— 创建表结构的sql语句

l          oracle.drop.sql —— 删除表结构的sql语句

l          oracle.drop.create.sql —— 先删除表结构再创建的sql语句

l          oracle.clean.sql —— 清除所有表中数据的sql语句

在Oracle 数据库中执行@E:/Java/tools/jbpm-starters-kit- 3.1.4 /jbpm-db/build/oracle/scripts/ oracle.create.sql，进行建表。

 

STEP 2，准备发布包

将E:/Java/tools/jbpm-starters-kit- 3.1.4 /jbpm-server/server/jbpm/deploy目录下的jbpm.war包用WinRaR解压开，并复制到已安装Tomcat的webapps目录下，添加jbpm所需的支持库到…/webapps/jbpm/WEB-INF/lib目录下，如下图，这些jar文件在jbpm-starters-kit-3.1.4目录下都能搜索的到。

 

STEP 3，修改配置文件

       将E:/Java/tools/jbpm-starters-kit- 3.1.4 /jbpm.3/src/config.files目录下的jbpm.cfg.xml、hibernate.cfg.xml、log4j.properties三个文件复制到…/webapps/jbpm/WEB-INF/classes下面。hibernate.cfg.xml是Hibernate的数据库配置文件，要做一些修改，原来内容如下：

 

<!-- jdbc connection properties -->     <property name="hibernate.dialect"> org.hibernate.dialect.HSQLDialect</property>     <property name="hibernate.connection.driver_class"> org.hsqldb.jdbcDriver</property>