JBoss 系列一 O O：Maven jBPM 6 集成示例

概述

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的最新版本也会自动更新

有如上配置，如下代码可以运行获取远程 jBPM 6 服务器仓库中的流程等：

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