jbpm+tomcat+mysql配置指南

1         概述

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

Ø        IDE：Eclipse<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.2.1</st1:chsdate>

Ø        JDK：J2SDK<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">1.5.06</st1:chsdate>

Ø        Tomcat：Tomcat<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.5.17</st1:chsdate>

Ø        jBPM：jbpm-starters-kit-<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.1.2</st1:chsdate>

Ø        Database：MySQL<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.0.27</st1:chsdate>

2         环境准备

2.1    安装JDK<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">1.5.06</st1:chsdate>

去java.sun.com下载JDK<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">1.5.06</st1:chsdate>安装文件。

双击JDK<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">1.5.06</st1:chsdate>安装文件，安装JDK1.5.06。安装完成后，在系统环境变量中设置JAVA_HOME，并指向JDK1.5.06安装目录。后面称为JAVA_HOME。

<v:shapetype id="_x0000_t75" stroked="f" filled="f" path="m@4@5l@4@11@9@11@9@5xe" o:preferrelative="t" o:spt="75" coordsize="21600,21600"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:connecttype="rect" gradientshapeok="t" o:extrusionok="f"></v:path><o:lock aspectratio="t" v:ext="edit"></o:lock></v:shapetype><v:shape id="_x0000_i1025" style="WIDTH: 260.25pt; HEIGHT: 104.25pt" type="#_x0000_t75"><v:imagedata o:title="1" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image001.jpg"></v:imagedata></v:shape>

2.2    安装Eclipse<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.2.1</st1:chsdate>

去www.eclipse.org下载Eclipse<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.2.1</st1:chsdate>压缩包。

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

2.3    安装Tomcat<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.5.17</st1:chsdate>

去http://www.apache.org/下载Tomcat<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.5.17</st1:chsdate>安装文件。

双击Tomcat<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.5.17</st1:chsdate>安装文件，安装Tomcat5.5.17到系统某个目录（D:\Tomcat5.5），后面称为TOMCAT_HOME。

2.4    安装MySQL<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.0.27</st1:chsdate>

去http://www.mysql.com/下载mysql-<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.0.27</st1:chsdate>-win32.zip压缩文件。

解压该文件后，双击MySQL<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">5.0.27</st1:chsdate>安装文件，安装MySQL5.0.27到系统某个目录（D:\Tomcat5.5），后面称为MySQL_HOME。

2.5    下载jB<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">PM3.1.2</st1:chsdate>

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 <st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.1.2</st1:chsdate>。下载后解压到 D:\jbpm-starters-kit-3.1.2，后面简称JBPM_HOME。目录下含有五个子目录：

<v:shape id="_x0000_i1027" style="WIDTH: 102.75pt; HEIGHT: 81pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image002.jpg"></v:imagedata></v:shape>

²       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-<st1:chsdate w:st="on" isrocdate="False" islunardate="False" day="30" month="12" year="1899">3.1.2</st1:chsdate>包里就有，目录地址如下： 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设置项目的库引用。

<v:shape id="_x0000_i1028" style="WIDTH: 414.75pt; HEIGHT: 377.25pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image003.jpg"></v:imagedata></v:shape>

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

<v:shape id="_x0000_i1029" style="WIDTH: 183.75pt; HEIGHT: 269.25pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image004.jpg"></v:imagedata></v:shape>

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中。如下图所示：

<v:shape id="_x0000_i1030" style="WIDTH: 352.5pt; HEIGHT: 324pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image005.jpg"></v:imagedata></v:shape>

图(1) 选择已经存在的工程<o:p></o:p>

<v:shape id="_x0000_i1031" style="WIDTH: 352.5pt; HEIGHT: 343.5pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image006.jpg"></v:imagedata></v:shape>

图(2) 选择工程<o:p></o:p>

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

<v:shape id="_x0000_i1032" style="WIDTH: 163.5pt; HEIGHT: 268.5pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image007.jpg"></v:imagedata></v:shape>

图(3) 工程结构图<o:p></o:p>

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驱动程序拷贝其中。目录结构如下图所示：

<v:shape id="_x0000_i1033" style="WIDTH: 186pt; HEIGHT: 151.5pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image008.jpg"></v:imagedata></v:shape>

图(4) MySQL驱动位置<o:p></o:p>

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中。目录结构如下图所示：

<v:shape id="_x0000_i1034" style="WIDTH: 174pt; HEIGHT: 153.75pt" type="#_x0000_t75"><v:imagedata o:title="20060823_image001" src="file:///C:\DOCUME~1\JavaMan\LOCALS~1\Temp\msohtml1\01\clip_image009.jpg"></v:imagedata></v:shape>

图(5) MySQL的create.db.hibernate.properties文件位置<o:p></o:p>

3.5.2   修改create.db.hibernate.properties

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

修改前内容：

hibernate.dialect=org.hibernate.dialect.HSQLDialect<o:p></o:p>

hibernate.connection.driver_class=org.hsqldb.jdbcDriver<o:p></o:p>

hibernate.connection.url=jdbc:hsqldb:hsql://localhost:1701<o:p></o:p>

hibernate.connection.username=sa<o:p></o:p>

hibernate.connection.password=<o:p></o:p>

hibernate.show_sql=true

修改后内容：

hibernate.dialect=org.hibernate.dialect.MySQLDialect<o:p></o:p>

hibernate.connection.driver_class=com.mysql.jdbc.Driver<o:p></o:p>