所有图片请到jbpm开源站点去查看。此部分对应着jbpm站点的doc的部署那一部分。这部分的理解应该没有什么太大出入,欢迎各位收藏浏览我的文章。谢谢!
对于一些常用单词或者行业内已经常用的单词我并没有做翻译,例如schedule等,我想这样能够更方便大家的理解。job我译成一次作业了。还有一些是我吃不准的,请见谅!如果有什么疑问或者见地请与我联系!我会尽快更正。
希望能与您共同进步,欢迎交流: yun15291li@hotmail.com
序言:
在经过了jbmp开始入门以及指南两章后,对JBPM有个大概的了解。下面我们来看看JBPM部署方面的知识。
接下来介绍如何把JBPM部署到不同的环境中。
JBPM可以在许多不同的环境进行部署,其中包括ant task(应该算是个附属脚本,不应该算做部署环境吧),swing client,web app,ejb,web services中。
部署jbpm到j2se环境:
这应该算是jbpm可以部署的几种方案中最简单的,把jbpm应用到一个简单java main程序中,一个单元测试中,一个swing应用中。
作为最最基础的,jbpm能够被应用在简单的java程序中。你只要把jbpm.core.jar添至系统classpath中并且配置好数据库。在java程序中你就可以获得jbpm服务org.jbpm.JbpmServiceLocator
下面给出几种部署:
1、 在webapp中:如果一个servlet容器:tomcat、resin等。
2、 在一个ant-task:jbpm包含一个ant-tasks,用来给process archive打包并且部署一个process archive。
3、 JUnite test中:jbpm的默认配置是想开发测试process archives,应用于一个瞬时、内存数据库中,那也就意味着你不用建立一个独立数据库和初始化它。Jbpm检测到没有jbpm表,那么就会自动建好。这里应用的是hibernate框架来实现对象持久层。
4、 在一个定制的app中:当你的应用需要整合一个工作流管理系统,你可以仅仅使用jbpm作为你们应用当中的一个组件,甚至于您系统的用户都没注意到使用jbpm这一点。
部署jbpm到一个web app中:
1、 安装jdbc驱动(一般就是下载相应的jar文件追加classpath或者copy到WEB-INF/lib目录下)
2、 把jbpm.properties放到WEB-INF/classes中
3、 这些jar文件放到WEB-INF/lib目录下
a) jbpm.core.jar
b) hibernate- 2.1.1.jar
c) c3p0.jar
d) dom4j.jar
e) cglib2.jar
f) ehcache.jar
g) odmg.jar
h) commons-collections.jar
i) commons-logging.jar
j) commons-beanutils.jar
k) commons-lang.jar
4、 jbpm.war到app下(原文没写,我猜也是应该如此的。)等我测试后在公布正确步骤,会在今后文章中完善。
部署jbpm到一个J2EE服务器中:
简单的部署在J2EE container中,jbpm已经写了一个ejb-wrapper来包裹jbpm api,接下来的大致意思就是:利用ant可以帮助您把jbpm部署到jboss中。这一点我测试过了。其他请参看原文。
配置:
适当的配置jbpm,请遵从下面4种配置机制:
1、 把jbpm.properties放到classloader能够找到的位置,因为它加载的时候使用getResourceAsStream方法。不懂的可以查看jdk。大致就是放到classpath可以找到的位置,如web app中的WEB-INF/classes中,在tomcat启动后就会自动把此目录下文件加载到classpath中。
2、 在调用getInstance方法之前加载配置文件(properties)。
3、 在调用getInstance方法之前调用配置文件(classloader,string)。
4、 对于创建复杂不同的jbpm配置实例在相同的jvm(classloader),你可以用jbpm配置和servicelocator的构造器并且不用做任何静态初始化和配置。
配置参数如下:
属性 | 值 | 描述 | 默认值 |
hibernate.* | @see the hibernate docs | 在jbpm配置文件中直接完成hibernate的配置 | 默认是一个内存数据库hsqldb。主要是为测试而用的 |
jbpm.create.tables | { only-if-not-present | never } | 方便应用,jbpm在最开始启动时候会检测是否存在表,如果没有则会自动创建。产生ddl语句开始drop表和约束然后创建表和约束 | only-if-not-present |
jbpm.create.tables.log | { true | false } | Ddl语句创建表是否被log输出. | false |
jbpm.create.tables.query | { a plain SQL query } | 简单的sql查询语句,这个属性会检测表是否存在,并且这个属性仅仅用在属性“'jbpm.create.tables'”被设置成’only-if-not-present'的情况。如果执行sql查询语句出现异常,那么jbpm会假定表不存在. | SELECT ID FROM JBPM_DEFINITION WHERE ID = 1 |
jbpm.apply.transactions | { yes | no } | Jbpm如何处理transaction(事务)'yes'意思是对于执行每个更新方法把事务应用到jdbc连接上。其中排除定义在*readservices中的更新方法。'no'意味着将不会应用任何事务处理操作。’no’能够应用在一个容器或者用户自己提供的jdbc连解决中。 | yes |
jbpm.file.mgr | { database | filesystem | the class-name of a class that implements org. jbpm. persistence. FileMgr } | Jbpm如何存储文件(例如在process archive中的类文件)。此配置被添加是因为一些数据库驱动(例如oracle)不能很好的处理二进制文件。 | database |
jbpm.file.mgr.directory |
| Jbpm存储文件的根目录的名字,设置成如:/usr/jbpm或者c:/data/jbpm | -no default specified- |
jbpm.validate.xml | { true | false } | 如果这个属性设置为false的话,Process archive分析将不会有效验证processdefinition.xml文件。 | true |
jbpm.id.generator | { default | the class-name of a class that implements org. jbpm. persistence. IdGenerator } | 产生ID方式。用于jbpm持久对象。 | org. jbpm. persistence. hibernate. SequenceBlockIdGenerator |
jbpm.id.generator.node.id | { an integer between 0 and 65535 } | 在cluster中这个节点(node)的唯一ID | 0 |
jbpm.id.generator.bocksize | { an integer } | (不知道怎么翻译好,下面是原文)大致意思是ID产生模式的区块大小。 | 100 |
jbpm.id.generator.configuration | { same | the resource of the id generator hibernate properties } | ID产生器需要一个在分离事务中的session。因此session工厂用于产生ID,ID可以不从数据源管理的container中获得。所以如果你不使用datasource(数据源)在其中管理事务的话,你可以使用默认值。'same' 意思是和其他配置参数采用相同配置属性来为ID产生器的session工厂。否则,采用hibernate配置来产生使用ID产生器session工厂。(上面这段话可能翻译有误,大致意思如此。) | same |
jbpm.log.stdout | {on|off} | 配置公用(普通)log输出。当设置为off,jbpm不再配置公用(普通)log。 | on |
jbpm.log.default | { trace | debug | info | warn | error | fatal } | 默认的log级别。 | error |
jbpm.log.package.* (whererepresents any package name) | { trace | debug | info | warn | error | fatal } | 以给定的值覆写jbpm默认的log级别。 | jbpm. log. package. org. jbpm= debug |
jbpm.scheduler.wait.period | long | 在schduler polls中等待的毫秒数。 | 5000 |
jbpm.execute.actions | { true | false } | 如果设置为true,jbpm将执行指定的action handler。可以设置为false,为了测试目的以免执行业务流程。 | true |
JBPM数据库:
概述:
Jbpm存储所有信息在数据库中:
1、 过程定义
2、 流程执行的运行时信息
3、 流程log
Schema generation
默认状态下,第一次访问数据库时候,jbpm将会检测表是否存在。如果不存在那么jbpm数据库表将会被自动创建。这可以在上面配置信息中找到’jbpm.create.tables’
针对一个数据库的schema能够在一个文件中创建,按照下面的步骤:
1、 更新文件:${jbpm.home}/core/schema.generation.properties来反射你选择的数据库。默认的数据库是Hypersonic DB。在这个文件里有样本生成。可以仿照生成自己需要的文件。
2、
在文件夹${jbpm.home}/core用ant generate.dll产生schema。产生的文件在${jbpm.home}/target/sql/create-jbpm-database.sql
更换数据库:
1、
更新文件core/schema.generation.properties
2、 把对应的jdbc驱动放到lib目录(classpath能够找得到)
3、 在dos(命令提示符)下cd到打开core目录
4、 执行ant generate.dll
5、
现在,你已经产生dll脚本在${jbpm.home}/target/sql/create-jbpm-database.sql
6、 当运行jbpm时候,确信你提供了正确的hibernate配置。在上面的配置中已经介绍。
一些其他注意事项:
1、 有一些数据库想firebird和oracle需要添加如下属性配置到jbpm.properties:
Hibernate.query.substitutions=true 1,false 0
2、校验数据库中的text类型的长度,默认一个string类型是255长度。你可以以两种方式调整:通过增加长度参数,在hibernate mapping 文件中像这样:<property name="configuration" type="string" length="10000"/>
, 或者通过手动更新刚才用ant产生的dll脚本。
APPSERVER 兼容性:
Scheduler:
Jbpm有一个scheduler。ActionHandler实现器(和其他代理实现类)可以通过schedulerservices来schedule工作。SchedulerService可以在ExecutionContext中的getSchedulerService方法来进行访问。
Jbpm的scheduler包括4部分:
1、 scheduler service:允许schedule和取消一次作业。实际上scheduler service仅仅插入schedule和移除jbpm数据库中的一次作业记录。在某一个过程执行事件actions能被执行,在actions里面,你可以schedule和取消一次作业。
2、 scheduler server:它是一个能够检查一次作业取消还是执行的组件。Scheduler server应该比较有规律(例如每隔 5m)就被调用一次。为完成此功能,jbpm提供3和4功能。
3、 scheduler servlet:响应request的servlet。通知2来检查工作。
4、 scheduler client:一个非常简单的java程序,用来一个request给3。时间间隔一般比较小(几秒)。
一个关于如何在过程定义中使用scheduler的例子,请参看scheduler test:
1、
core/src/java/org/jbpm/delegation/action/ScheduleJobActionHandler.java
是一个可配置的用来schedule一次作业的acition。
2、
core/src/java/org/jbpm/delegation/action/CancelJobActionHandler.java
是一个可配置的用来取消一个或者多个作业的action。
3、
core/src/test/resources/process/schedulingprocess.xml
查看上面两个文件如何使用
在jboss cluster中的jbpm
这里讲的是如何在jboss cluster部署jbpm 企业bean。前提:你需要有两个或者更多的计算机,并且预先装好jvm和ant。可选地,你能够在一个计算机上运行多个jboss实例,但是这种情况,这里并没有介绍。
安装:
+----------------+
| Node 1 |
| +------------+ |
| | Hypersonic |.|...................................... . . .
| | Database | | : :
| | for jBpm | | +---------:------+ +---------:------+
| +------------+ | | Node 2 : | | Node 3 : |
| : | | : | | : |
| +------------+ | | +------------+ | | +------------+ |
| | jBpm ejb | | | | jBpm ejb | | | | jBpm ejb | |
| | module | | | | module | | | | module | |
| +------------+ | | +------------+ | | +------------+ |
| ! | | ! | | ! |
+-------!--------+ +---------!------+ +---------!------+
! ! !
! ! !
!!!!!!! remote application clients !!!!!!!!!!!!!!
在每个node上做如下操作:
- 安装jboss 3.2.3或者更高版本
- 更新 jbpm.home目录里的build.properties
- 在${jbpm.home}里运行ant build
- 在${jbpm.home}里运行'ant configure.jboss. 3.2.3+'
- 在文件 ${jboss.home}/server/jbpm/deploy/jbpm-ds.xml 更改 下面一行。
<connection-url>jdbc:hsqldb:hsql://localhost:1701</connection-url>
请使用node1的ip,不要使用localhost(即使是在node1上也是不要使用localhost)。切记!
在node1上执行下面操作:
- 运行'{jboss.home}/bin/run.bat -c jbpm'
- 在目录 ${jbpm.home}/ejb 'ant deploy' 将会创建 ${jbpm.home}/ejb/target/j2ee/jbpm.ejb.jar然后copy 它到 ${jboss.home}/server/jbpm/farm (这将稍后是部署ejb模块到所有node上)
- 在目录${jbpm.home}/ejb中运行 'ant deploy.process.archives' 上载process archives到数据库中。
在node2和其他没有数据库的节点(如3),做如下操作:
On nodes 2 and higher (=the ones without a database), also do the following :
- 删除文件 ${jboss.home}/server/jbpm/deploy/jbpm-db-service.xml
- 从文件 ${jboss.home}/server/jbpm/deploy/jbpm-ds.xml 中移除下面这一行:'<depends>jboss:service=JbpmDatabase</depends>'
开启所有node的服务: '{jboss.home}/bin/run.bat -c jbpm'
这时,所有node 的准备工作就做好了。
- 在目录${jbpm.home}/ejb 下运行 'ant test'