第 3 章 没有 Business Central 的项目部署

流程

1. 在项目的 ~/resources/META-INF 目录中，创建一个至少包含以下内容的 kmodule.xml 元数据文件：

   <?xml version="1.0" encoding="UTF-8"?>
   <kmodule xmlns="http://www.drools.org/xsd/kmodule">
   </kmodule>

   这个空 kmodule.xml 文件足以生成一个默认 KIE 基础，其中包含 项目资源 路径下找到的所有文件。默认 KIE 基础也包含一个默认的 KIE 会话，该会话会在构建时在应用程序中创建 KIE 容器时触发。

   以下示例是更高级的 kmodule.xml 文件：

   <?xml version="1.0" encoding="UTF-8"?>
   <kmodule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.drools.org/xsd/kmodule">
     <configuration>
         <property key="drools.evaluator.supersetOf" value="org.mycompany.SupersetOfEvaluatorDefinition"/>
     </configuration>
     <kbase name="KBase1" default="true" eventProcessingMode="cloud" equalsBehavior="equality" declarativeAgenda="enabled" packages="org.domain.pkg1">
       <ksession name="KSession1_1" type="stateful" default="true" />
       <ksession name="KSession1_2" type="stateful" default="true" beliefSystem="jtms" />
     </kbase>
     <kbase name="KBase2" default="false" eventProcessingMode="stream" equalsBehavior="equality" declarativeAgenda="enabled" packages="org.domain.pkg2, org.domain.pkg3" includes="KBase1">
       <ksession name="KSession2_1" type="stateless" default="true" clockType="realtime">
         <fileLogger file="debugInfo" threaded="true" interval="10" />
         <workItemHandlers>
           <workItemHandler name="name" type="new org.domain.WorkItemHandler()" />
         </workItemHandlers>
         <listeners>
           <ruleRuntimeEventListener type="org.domain.RuleRuntimeListener" />
           <agendaEventListener type="org.domain.FirstAgendaListener" />
           <agendaEventListener type="org.domain.SecondAgendaListener" />
           <processEventListener type="org.domain.ProcessListener" />
         </listeners>
       </ksession>
     </kbase>
   </kmodule>

   这个示例定义了两个 KIE 基础。两个 KIE 基础中包含规则资产的 特定软件包。当您以这种方式指定软件包时，您必须将规则文件组织到反映指定软件包的文件夹结构中。两个 KIE 会话从 KBase1 KIE 基础实例化，以及一个来自 KBase2 的 KIE 会话。KBase2 的 KIE 会话是一个 无状态 KIE 会话，这意味着之前调用 KIE 会话（上一会话状态）中的数据会在会话调用之间丢弃。该 KIE 会话还指定了一个文件（或控制台）日志记录器、WorkItemHandler 和显示三种支持的类型的监听程序： ruleRuntimeEventListener、agendaEventListener 和 processEventListener。& lt;configuration > 元素定义可用于进一步自定义 kmodule.xml 文件的可选属性。

   作为手动将 kmodule.xml 文件附加到项目的替代选择，您可以使用 Java 应用程序中的 KieModuleModel 实例来以编程方式创建用于定义 KIE 基础和 KIE 会话的 kmodule.xml 文件，然后将项目中的所有资源添加到 KIE 虚拟文件系统 KieFileSystem 中。

   以编程方式创建 kmodule.xml 并将其添加到 KieFileSystem

   import org.kie.api.KieServices;
   import org.kie.api.builder.model.KieModuleModel;
   import org.kie.api.builder.model.KieBaseModel;
   import org.kie.api.builder.model.KieSessionModel;
   import org.kie.api.builder.KieFileSystem;
   
   KieServices kieServices = KieServices.Factory.get();
   KieModuleModel kieModuleModel = kieServices.newKieModuleModel();
   
   KieBaseModel kieBaseModel1 = kieModuleModel.newKieBaseModel("KBase1")
     .setDefault(true)
     .setEqualsBehavior(EqualityBehaviorOption.EQUALITY)
     .setEventProcessingMode(EventProcessingOption.STREAM);
   
   KieSessionModel ksessionModel1 = kieBaseModel1.newKieSessionModel("KSession1_1")
     .setDefault(true)
     .setType(KieSessionModel.KieSessionType.STATEFUL)
     .setClockType(ClockTypeOption.get("realtime"));
   
   KieFileSystem kfs = kieServices.newKieFileSystem();
   kfs.writeKModuleXML(kieModuleModel.toXML());

2. 在手动配置 kmodule.xml 文件后，手动或以编程方式在项目中检索 KIE 基础和 KIE 会话，以验证配置：

   KieServices kieServices = KieServices.Factory.get();
   KieContainer kContainer = kieServices.getKieClasspathContainer();
   
   KieBase kBase1 = kContainer.getKieBase("KBase1");
   KieSession kieSession1 = kContainer.newKieSession("KSession1_1"),
       kieSession2 = kContainer.newKieSession("KSession1_2");
   
   KieBase kBase2 = kContainer.getKieBase("KBase2");
   StatelessKieSession kieSession3 = kContainer.newStatelessKieSession("KSession2_1");

   如果 KieBase 或 KieSession 已在 kmodule.xml 文件中配置为 default="true"，如前面的 kmodule.xml 示例中所示，您可以在不传递任何名称的情况下从 KIE 容器检索它们：

   KieContainer kContainer = ...
   
   KieBase kBase1 = kContainer.getKieBase();
   KieSession kieSession1 = kContainer.newKieSession(),
       kieSession2 = kContainer.newKieSession();
   
   KieBase kBase2 = kContainer.getKieBase();
   StatelessKieSession kieSession3 = kContainer.newStatelessKieSession();

   要增加或减少在决策引擎中缓存的 KIE 模块或工件版本的最大数量，您可以在 Red Hat Process Automation Manager 发行版本中修改以下系统属性的值：

   • kie.repository.project.cache.size ：在决策引擎中缓存的最大 KIE 模块数。默认值 ：100
   • kie.repository.project.versions.cache.size: 在决策引擎中缓存的相同工件的最大版本数。默认值 ：10

   对于 KIE 存储库配置的完整列表，请 从红帽客户门户网站下载 Red Hat Process Automation Manager 7.12.0 Source Distribution ZIP 文件，再导航到 ~/rhpam-7.12.0-sources/src/drools-$VERSION/drools-compiler/src/main/java/org/drools/compiler/compiler/kie/builder/impl/KieRepositorympl.java.java.