jbpm+tomcat+mysql配置指南

1         概述

本文主要讲解jbpm+tomcat+mysql配置过程，程序用例为jBPM自带例子websale。主要环境内容如下：

Ø        IDE：Eclipse3.2.1

Ø        JDK：J2SDK1.5.06

Ø        Tomcat：Tomcat5.5.17

Ø        jBPM：jbpm-starters-kit-3.1.2

Ø        Database：MySQL5.0.27

2         环境准备

2.1    安装JDK1.5.06

去java.sun.com下载JDK1.5.06安装文件。

双击JDK1.5.06安装文件，安装JDK1.5.06。安装完成后，在系统环境变量中设置JAVA_HOME，并指向JDK1.5.06安装目录。后面称为JAVA_HOME。

2.2    安装Eclipse3.2.1

去www.eclipse.org下载Eclipse3.2.1压缩包。

将下载的Eclipse3.2压缩包，解压到系统某个目录（D:\eclipse），后面称为ECLIPSE_HOME。

2.3    安装Tomcat5.5.17

去http://www.apache.org/下载Tomcat5.5.17安装文件。

双击Tomcat5.5.17安装文件，安装Tomcat5.5.17到系统某个目录（D:\Tomcat5.5），后面称为TOMCAT_HOME。

2.4    安装MySQL5.0.27

去http://www.mysql.com/下载mysql-5.0.27-win32.zip压缩文件。

解压该文件后，双击MySQL5.0.27安装文件，安装MySQL5.0.27到系统某个目录（D:\Tomcat5.5），后面称为MySQL_HOME。

2.5    下载jBPM3.1.2

jBPM的下载地址：http://www.jboss.com/products/jbpm/downloads

²       JBoss jBPM是jBPM 的软件包

²       JBoss jBPM Starters Kit是一个综合包，它包括了jBPM软件包、开发插件、一个配置好了的基于JBoss的jBPM示例、一些数据库配置文件示例。

²       JBoss jBPM Process Designer Plugin是辅助开发jBPM的Eclipse 插件。

²       JBoss jBPM BPEL Extension jBPM关于BPEL的扩展包

本指南选择下载：JBoss jBPM Starters Kit 3.1.2。下载后解压到 D:\jbpm-starters-kit-3.1.2，后面简称JBPM_HOME。目录下含有五个子目录：

²       jbpm jBPM的软件包，包含源码，例子等文件内容。

²       jbpm-bpel只含有一个网页

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

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

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

2.6    安装jBPM的Eclipse开发插件

有个辅助工具开发起来方便一点，只不过现在 jBPM 的开发工具插件功能还不算太强，也就一个“项目创建向导”的功能，让你：

²       不用再去配置classpath库的引用了

²       直接得到了一个jBPM的项目初始结构

其实吧，开发jBPM也不需要什么插件工具，在熟练了以后，库引用了项目初始结构都可以手工创建。

插件不用再去下载了，jbpm-starters-kit-3.1.2包里就有，目录地址如下： D:\jbpm-starters-kit-3.1.1\jbpm-designer\jbpm-gpd-feature\eclipse，插件的安装方式是链接式还是直接复制式，另外，注明一下Eclipse的版本我是用3.2.1，插件和Eclispe版本相关的，要注意了。

如果安装成功，则Eclipse首选项里多了一个JBoss jBPM，另外我们也需要到这个jBPM的首选项里做一些配置工作――指定jBPM的安装路径（如下图所示）。这个配置主要是为了找到jbpm下的各种jar包，好让Eclipse设置项目的库引用。

例如新建一个jbpm的工程后，其目录树结构如下图所示：

3         具体配置情况

3.1    更改工程名称

在JBPM_HOME\jbpm目录下找到文件“.project”，用记事本打开，将以下内容<name>jbpm.3_BRANCH_3_1</name>更改为<name>jbpm.3</name>，保存文件。

在将JBPM_HOME\jbpm文件夹更改为JBPM_HOME\jbpm.3。后面引用工程名称为jbpm.3。

3.2    导入工程

启动eclipse，通过“Import”将jBPM工程导入eclipse中。如下图所示：

图(1) 选择已经存在的工程

图(2) 选择工程

点击“Finish”完成导入，导入后的工程情况如下图所示：

图(3) 工程结构图

3.3    建库

在MySQL中建立数据库jbpm。字符集采用GBK。建表SQL如下：

CREATE DATABASE `jbpm`

    CHARACTER SET 'gbk'

    COLLATE 'gbk_chinese_ci';

3.4    添加MySQL驱动

在工程jbpm.3的lib目录下建立mysql文件夹，将MySQL需要的JDBC驱动程序拷贝其中。目录结构如下图所示：

图(4) MySQL驱动位置

3.5    建立数据库表

3.5.1   创建create.db.hibernate.properties

在工程jbpm.3的src/resources目录下建立mysql目录，并将jbpm.3/src/resources/hsqldb目录下的所有文件（create.db.hibernate.properties和identity.db.xml）拷贝入mysql中。目录结构如下图所示：

图(5) MySQL的create.db.hibernate.properties文件位置

3.5.2   修改create.db.hibernate.properties

在eclipse中，双击工程jbpm.3/src/resources/mysql下的create.db.hibernate.properties，打开该文件，修改其中的内容。

修改前内容：

hibernate.dialect=org.hibernate.dialect.HSQLDialect

hibernate.connection.driver_class=org.hsqldb.jdbcDriver

hibernate.connection.url=jdbc:hsqldb:hsql://localhost:1701

hibernate.connection.username=sa

hibernate.connection.password=

hibernate.show_sql=true

修改后内容：

hibernate.dialect=org.hibernate.dialect.MySQLDialect

hibernate.connection.driver_class=com.mysql.jdbc.Driver