概述
jBPM 6 中底层架构基于 Maven,所以我们可以很容易的进行 Maven jBPM 6 集成示例,本文分三个部分:
- 基本原理介绍
- Maven jBPM 6 集成
- jBPM 6 中使用 Maven 特性实时监听服务器端的更新
基本原理介绍
如下图
如图所示,我们有两台服务器,jBPM 6 服务器和客户端服务器:
- 首先 jBPM 6 服务器如果我们通过 Work Bench 将编辑完成的流程打包发布,它会将其发布到 jBPM 6 服务器对应的 Maven 仓库,这个仓库相比较客户端的应用它属于一个远程仓库。它对外提供的URL为:http://IP:8080/<app name>/maven2/,它需要安全认证,不是默认公开的仓库
- 客户端服务器中运行的App它在内存中保存有一个 KieRepository,这个内存仓库通过本地参考可以与远程 jBPM 6 服务器的仓库保持实时更新
- 本地仓库通过Maven与远程仓库同步,我们需要在settings.xml中配置远程仓库的信息
Maven jBPM 6集成
Maven jBPM 6集成实际上就简化为 Maven settings.xml的配置问题。如下配置
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>guvnor-m2-repo</id>
<username>admin</username>
<password>password1!</password>
<configuration>
<wagonProvider>httpclient</wagonProvider>
<httpConfiguration>
<all>
<usePreemptive>true</usePreemptive>
</all>
</httpConfiguration>
</configuration>
</server>
</servers>
<profiles>
<profile>
<id>guvnor-m2-repo</id>
<repositories>
<repository>
<id>guvnor-m2-repo</id>
<name>BRMS Repository</name>
<url>http://10.66.218.46:8080/business-central/maven2/</url>
<layout>default</layout>
<releases>
<enabled>true</enabled>
<updatePolicy>always</updatePolicy>
</releases>
<snapshots>
<enabled>true</enabled>
<updatePolicy>always</updatePolicy>
</snapshots>
</repository>
</repositories>
</profile>
</profiles>
<activeProfiles>
<activeProfile>guvnor-m2-repo</activeProfile>
</activeProfiles>
</settings>
如上为一配置示例,我们可以看出
- 远程 jBPM 6 服务器运行的Maven Repo为 http://10.66.218.46:8080/business-central/maven2/
- 远程 jBPM 6 服务器所需要的安全认证为 admin 和 password1!
- 我们配置Maven 新版本发布会自动更新,snapshots的最新版本也会自动更新
KieServices kServices = KieServices.Factory.get();
ReleaseId releaseId = kServices.newReleaseId( "com.redhat.gss", "01081954", "1.1-SNAPSHOT" );
KieContainer kContainer = kServices.newKieContainer( releaseId );
KieBase kbase = kContainer.getKieBase();
KieSession ksession = kbase.newKieSession();
如上代码运行可以需要三种方式指定 settings.xml:
- 通过JVM properties kie.maven.settings.custom 指定 Maven 配置文件 settings.xml
- 到当前用户下找 .m2/settings.xml
- 到 M2_HOME 下找 /conf/settings.xml
jBPM 6 中使用 Maven 特性实时监听服务器端的更新
借助于 Maven 的特性,KieScanner 可以周期性的扫描远程jBPM 6 服务器运行的Maven Repo,当有远程发布有变更时,KieScanner 会自动更新 KieRepository,使其为最新的发布,如下代码
KieServices kServices = KieServices.Factory.get();
ReleaseId releaseId = kServices.newReleaseId( "org.kie.example", "project1", "1.0.0-SNAPSHOT" );
KieContainer kContainer = kServices.newKieContainer( releaseId );
KieScanner kScanner = kServices.newKieScanner( kContainer );
kScanner.start( 1000 * 10);
while(true) {
KieSession ksession = kContainer.newKieSession();
ksession.fireAllRules();
Thread.sleep(10000);
}
如果我们更新远程 project1 中的流程或规则文件,客户端的程序不要任何变化会运行远端的变化。关于这一部分的深入原理参照 https://github.com/kylinsoong/jBPM-Drools-Example/blob/master/drools-6-examples/kie-mvn/kie-mvn-architecture.md