jBPM开发企业流程应用之在Tomcat上部署流程引擎及控制台

作者:kthq

jBPM是jBoss的子项目，那么其在jBoss上的部署就相当简单了，基本不用废话，因为在jBPM套装版本(suite)中的server目录就是一个已经部署好jBPM的jBoss，不过这个jBoss启动的时候要连带启动很多应用，太慢了，有点受不了。所以我们最好在Tomcat上部署一个纯洁的、独立的jBPM应用，以便研究。

 

那么，首先，我们需要建库，在db目录中有各种数据库的建库脚本，方便起见，我们用默认的jbpm.jpdl.hsqldb.sql，在hsqldb上建立数据库。

hsqldb是个轻量级的、简单易用的内存/文本数据库，乃是用来做demo的上上佳品。具体怎么使用hsqldb不是这里讨论的重点。可以这样运行hsqldb的控制台进行建库：

java -cp hsqldb.jar org.hsqldb.util.DatabaseManager

同时，假设你把数据存储在文本文件：

D:/_tech/jbpm/jbpm-jpdl-suite/_HSQLDB/huqi_jbpm.txt

那么，我们的数据库连接描述就是：

jdbc:hsqldb:file:D:/_tech/jbpm/jbpm-jpdl-suite/_HSQLDB/huqi_jbpm.txt

 

安装好数据库，建好表，我们就可以开始部署控制台和工作流引擎的war包了。deploy目录中的jbpm-console.war正是此war包，在Tomcat上部署它，需要对它做一些改动和配置。

找到el-api.jar和el-ri.jar两个jar包，把它们加入war包中相应的lib目录。

在war包的classes目录中找到hibernate.cfg.xml这个文件，首先修改数据源，按照我们刚才建立的库，将hibernate.connection.url属性改为：

< property  name ="hibernate.connection.url" > jdbc:hsqldb:file:D:_techjbpmjbpm-jpdl-suite_HSQLDBhuqi_jbpm.txt </ property >

完整的hibernate数据源配置是：

     <!--  hibernate dialect  -->
     < property  name ="hibernate.dialect" > org.hibernate.dialect.HSQLDialect </ property >

     <!--  JDBC connection properties (begin)  -->
     < property  name ="hibernate.connection.driver_class" > org.hsqldb.jdbcDriver </ property >
     < property  name ="hibernate.connection.url" > jdbc:hsqldb:file:D:_techjbpmjbpm-jpdl-suite_HSQLDBhuqi_jbpm.txt </ property >
     < property  name ="hibernate.connection.username" > sa </ property >
     < property  name ="hibernate.connection.password" ></ property >
     <!--  JDBC connection properties (end)  -->

另外，看到这一段了吧：

     <!--  following mapping files have a dependendy on   -->
     <!--  'jbpm-identity.jar', mapping files             -->
     <!--  of the pluggable jbpm identity component.      -->
     <!--  Uncomment the following 3 lines if you         -->
     <!--  want to use the jBPM identity mgmgt            -->
     <!--  component.                                     -->
     <!--  identity mappings (begin)  -->
     < mapping  resource ="org/jbpm/identity/User.hbm.xml" />
     < mapping  resource ="org/jbpm/identity/Group.hbm.xml" />
     < mapping  resource ="org/jbpm/identity/Membership.hbm.xml" />
     <!--  identity mappings (end)  -->

这是jBPM自带的组织系统，被用来分配流程参与者的。我们的建库脚本中并没有这3张表（当然，你有兴趣的话也可以自己建这三张表），所以请把这3行注释掉！则jBPM将会使用Tomcat的用户系统来分配参与者。

顺便说一下，这个版本的jBPM至少需要Tomcat5.0的版本去运行，否则会告诉你web.xml的格式不正确。

Tomcat的用户系统都在Tomcat_Home/conf/tomcat-users.xml中定义，jBPM的设计器可以建立一个默认的测试流程，这个流程中涉及到的参与者在tomcat-users.xml中可以这样定义，看例子：

<? xml version='1.0' encoding='utf-8' ?>
< tomcat-users >
   < role  rolename ="administrator" />
   < role  rolename ="tomcat" />
   < role  rolename ="role1" />
   < role  rolename ="manager" />
   < role  rolename ="admin" />
   < role  rolename ="participant" />
   < user  username ="ernie"  password ="ernie"  roles ="administrator,manager,participant" />
   < user  username ="bert"  password ="bert"  roles ="participant" />
   < user  username ="tomcat"  password ="tomcat"  roles ="tomcat" />
   < user  username ="both"  password ="tomcat"  roles ="tomcat,role1" />
   < user  username ="role1"  password ="tomcat"  roles ="role1" />
   < user  username ="grover"  password ="grover"  roles ="participant" />
   < user  username ="monster"  password ="monster"  roles ="participant" />
   < user  username ="huqi"  password ="huqi"  roles ="administrator,manager,participant" />
   < user  username ="cookie"  password ="cookie"  roles ="participant" />
   < user  username ="admin"  password =""  roles ="admin,manager" />
</ tomcat-users >

 

最后，把修改好的war包copy到Tomcat的webapps目录中，启动tomcat，访问控制台：

http://127.0.0.1:8080/jbpm-console/