7.2. 使用 KIE 服务器 Java 客户端 API 执行 DMN 服务

流程

1. 在客户端应用程序中，将以下依赖项添加到 Java 项目的相关类路径中：

   <!-- Required for the KIE Server Java client API -->
   <dependency>
     <groupId>org.kie.server</groupId>
     <artifactId>kie-server-client</artifactId>
     <version>${rhpam.version}</version>
   </dependency>

   & lt;version > 是项目中当前使用的 Red Hat Process Automation Manager 的 Maven 工件版本（例如 7.67.0.Final-redhat-00024）。

   注意

   考虑将 Red Hat Business Automation 材料清单(BOM)依赖项添加到项目 pom.xml 文件，而不是为每个依赖项指定 Red Hat Process Automation Manager < version >。Red Hat Business Automation BOM 适用于 Red Hat Decision Manager 和 Red Hat Process Automation Manager。添加 BOM 文件时，项目中包含来自提供的 Maven 存储库的正确依赖项版本。

   BOM 依赖项示例：

   <dependency>
     <groupId>com.redhat.ba</groupId>
     <artifactId>ba-platform-bom</artifactId>
     <version>7.13.5.redhat-00002</version>
     <scope>import</scope>
     <type>pom</type>
   </dependency>

   有关 Red Hat Business Automation BOM 的更多信息，请参阅 RHPAM 产品与 maven 库版本之间的映射是什么？

2. 使用适当的连接信息实例化 KieServicesClient 实例。

   例如：

   KieServicesConfiguration conf =
       KieServicesFactory.newRestConfiguration(URL, USER, PASSWORD); 1
   
   conf.setMarshallingFormat(MarshallingFormat.JSON);  2
   
   KieServicesClient kieServicesClient = KieServicesFactory.newKieServicesClient(conf);

   1

   连接信息：

   • URL 示例 ：http://localhost:8080/kie-server/services/rest/server
   • 该凭据应当引用具有 kie-server 角色的用户。

   2

   Marshalling 格式是一个 org.kie.server.api.marshalling.MarshallingFormat 的实例。它控制消息是 JSON 还是 XML。Marshalling 格式的选项为 JSON、JAXB 或 XSTREAM。

3. 通过调用 KIE 服务器 Java 客户端上的方法 getServicesClient（） 从连接到相关 KIE 服务器 Java 客户端的 KIE 服务器 Java 客户端获取 DMNServicesClient Client：

   DMNServicesClient dmnClient = kieServicesClient.getServicesClient(DMNServicesClient.class );

   dmnClient 现在可在 KIE 服务器上执行决策服务。

4. 为所需模型执行决策服务。

   例如：

   for (Integer age : Arrays.asList(1,12,13,64,65,66)) {
       DMNContext dmnContext = dmnClient.newContext(); 1
       dmnContext.set("Age", age);  2
       ServiceResponse<DMNResult> serverResp =   3
           dmnClient.evaluateAll($kieContainerId,
                                 $modelNamespace,
                                 $modelName,
                                 dmnContext);
   
       DMNResult dmnResult = serverResp.getResult();  4
       for (DMNDecisionResult dr : dmnResult.getDecisionResults()) {
           log.info("Age: " + age + ", " +
                    "Decision: '" + dr.getDecisionName() + "', " +
                    "Result: " + dr.getResult());
       }
   }

   1

   实例化新的 DMN 上下文，作为模型评估的输入。请注意，本例多次通过 Age 类决策进行循环。

   2

   为输入 DMN 上下文分配输入变量。

   3

   评估 DMN 模型中定义的所有 DMN 决策：

   • $kieContainerId 是部署了包含 DMN 模型的 KJAR 的容器的 ID
   • $modelNamespace 是型号的命名空间。
   • $modelName 是模型的名称。

   4

   DMN Result 对象可从服务器响应中获得。

   此时，dmnResult 包含所评估的 DMN 模型中的所有决定结果。

   您还可以使用 DMNServicesClient 的替代方法，在模型中仅执行特定的 DMN 决策。

   注意

   如果 KIE 容器仅包含一个 DMN 模型，您可以省略 $modelNamespace 和 $modelName，因为 KIE Server API 会默认选择它。