jBPM4.0的用户指南（二）

第 2 章 安装配置
2.1. 类库

jBPM 不需要其他任何依赖库就可以在Java虚拟机上运行，参见开发指南的对象执行模式。但是在这个用户指南里我们将介绍使用jBPM的最常用方式。也就是让 jBPM将流程定义、流程实例、历史记录保存在关系数据库里。在这种情况下，hibernate就需要添加在classPath中了，当然还有些jPDL 的功能需要用到其他的类库。因此，将lib这个目录下所有的类库添加到工程里，那么所有的功能你都可以使用了。
2.2. Tomcat xxx

TODO：这里将包含一段如何将jBPM的安装程序安装在Tomcat上的说明。
2.3. JBoss xxx

TODO：这里将包含一段如何将jBPM的安装程序安装在Jboss上的说明。
2.4. DataBase

jBPM可以很好的运行在你选择的数据库中，你可以将jBPM的表和你的业务表放在同一个数据库中。这样你就可以使用同一个JDBC连接的单一事务同时更新你的jBPM数据库和业务数据。
2.4.1. 测试

这一节将指引你通过一些步骤来进行测试。
2.4.2. 安装数据库
2.4.3. 设置一个连接
2.5. 流程设计器（GPD）

图形化流程设计器（GPD）使用Eclipse作为其平台，这一节的内容将介绍如何在Eclipse中安装这个设计器。
2.5.1. 下载eclipse

你需要Eclipse3.4.1

下载：用于Java开发的Eclipse IDE（85M）或者用于JavaEE开发的Eclipse IDE（163M）

旧版的eclipse是不够用的，因为不支持XML编辑器
2.5.2. 添加更新站点gpd/jbpm-gpd-site.zip

使用Eclipse软件升级（Software Update）机制安装设计器是非常简单的。在gpd目录下有一个gpd/jbpm-gpd-site.zip文件，这就是更新站点（archived update site）的压缩包。

在Eclipse里添加更新站点的方法：

    *

      帮助-->软件更新（Help --> Software Updates）
    *

      选择“有效软件”标签（Available Software）
    *

      点击添加站点（Add Site）
    *

      在对话框里添加站点击（Add Site）对话框，点击压缩包（Archive）
    *

      找到gpd/jbpm-gpd-site.zip
    *

      点击“确定”（ok）自动回到“软件更新和扩展”对话框
    *

      选择jPDL 4 流程设计器更新站点（jPDL 4 GPD Update Site）
    *

      点击安装（Install）
    *

      在安装（Install）对话框中,选择Flow Common Feature 和jPDL 4 Feature
    *

      点击下一步（Next）
    *

      选择接受（Accept），并点完成（Finish）
    *

      重启Eclipse

添加设计器的更新站点



图 2.1. 添加设计器的更新站点

2.5.3. 定义jBPM用户库

这一节演示如何在你的工作空间定义一个用户库，用来放置jBPM的库文件。如果你创建一个新工程，只需要将用户库全部添加到build path下

    *

      点击窗口-->属性（Windows-->Preren）
    *

      选择Java-->创建路径-->用户类库（Java --> Build Path --> User Libraries）
    *

      点击新建（New）
    *

      类型名字jBPM Libraries
    *

      点击添加JARs（Add JARs...）
    *

      找到jBPM安装程序下的lib目录
    *

      选择lib下的所有jar文件并点击打开（Open）
    *

      选择jBPM Libraries作为入口
    *

      重新点击添加JARs（Add JARs）
    *

      在jBPM的安装程序的根目录下选择jbpm.jar文件
    *

      点击打开（Open）
    *

      在jbpm.jar下选择源码附件（Source attachment）作为入口
    *

      点击编辑（Edit）
    *

      在源码附件的配置（Source Attachment Configuration）对话框中，点击目录（External Folder...）
    *

      找到jBPM安装程序下的src目录
    *

      点击选择（Choose）
    *

      点击两次'确定'（Ok）会关闭所有对话框

定义jBPM类库



图 2.2. 定义jBPM类库

2.5.4. 在目录中添加jPDL4模式

如果你想直接编辑XML源码，最好是在你的XML目录中指定一下模式（schema），这样当你在编辑流程源码的时候，可以更好的帮助你编写代码。

    *

      点击窗口-->属性（Windows-->Preferences）
    *

      选择XML-->目录（XML-->CataLog）
    *

      点击添加（Add）
    *

      添加XML目录（Add XML Catalog Entry）的窗口打开
    *

      点击map-icon的图标下面的按钮并选择文件系统（File System）
    *

      在打开的对话框中，选择jBPM安装目录下src文件夹中jpdl.xsd文件
    *

      点击打开（Open）并且关闭所有的对话框

在目录中添加jPDL4模式



图 2.3. 在目录中添加jPDL4模式

2.5.5. 导入示例

这一节我们会在Eclipse的安装程序下导入示例工程

    *

      选择文件-->导入（File-->Import）
    *

      选择正常-->工作区中已有的工程（General --> Existing Projects into Workspace）
    *

      点击下一步（Next）
    *

      点击浏览去选择一个根目录（Browse）
    *

      通向jBPM安装程序的根目录
    *

      点击好（Ok）
    *

      示例工程会自动找到并且选中
    *

      点击完成（Finish）

设置完成，现在你可以开始享受这个最酷的Java流程技术。

这一章讲述了如何在不同的应用环境中安装jBPM。