第 21 章 KIE 服务器 REST API 用于 KIE 容器和业务资产

流程

1. 识别您要发送请求的相关 API 端点，如 [GET] /server/containers，以从 KIE 服务器检索 KIE 容器。

2. 在 REST 客户端或 curl 工具中，为对 /server/containers 的 GET 请求输入以下组件。根据您的用例调整任何请求详情。

   对于 REST 客户端：

   • 身份验证 ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • HTTP 标头 ：设置以下标头：

     • 接受:application/json
   • HTTP 方法 ：设置为 GET。
   • URL ：输入 KIE Server REST API 基本 URL 和端点，如 http://localhost:8080/kie-server/services/rest/server/containers。

   对于 curl 工具：

   • -u ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • -h: 设置以下标头：

     • 接受:application/json
   • -x: 设置为 GET。
   • URL ：输入 KIE Server REST API 基本 URL 和端点，如 http://localhost:8080/kie-server/services/rest/server/containers。

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -X GET "http://localhost:8080/kie-server/services/rest/server/containers"

3. 执行请求并查看 KIE 服务器响应。

   服务器响应示例(JSON)：

   {
     "type": "SUCCESS",
     "msg": "List of created containers",
     "result": {
       "kie-containers": {
         "kie-container": [
           {
             "container-id": "itorders_1.0.0-SNAPSHOT",
             "release-id": {
               "group-id": "itorders",
               "artifact-id": "itorders",
               "version": "1.0.0-SNAPSHOT"
             },
             "resolved-release-id": {
               "group-id": "itorders",
               "artifact-id": "itorders",
               "version": "1.0.0-SNAPSHOT"
             },
             "status": "STARTED",
             "scanner": {
               "status": "DISPOSED",
               "poll-interval": null
             },
             "config-items": [],
             "container-alias": "itorders"
           }
         ]
       }
     }
   }

4. 在本例中，从响应返回的其中一个部署的 KIE 容器复制或记下项目 group-id、artifact-id 和 version (GAV)数据。

5. 在 REST 客户端或 curl 实用程序中，发送带有以下内容的另外一个 API 请求，它向 /server/containers/{containerId} 发送一个 PUT 请求，以使用复制的项目 GAV 数据部署新的 KIE 容器。根据您的用例调整任何请求详情。

   对于 REST 客户端：

   • 身份验证 ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • HTTP 标头 ：设置以下标头：

     • 接受:application/json

     • content-Type:application/json

       注意

       将 fields=not_null 添加到 Content-Type 时，null 字段会从 REST API 响应中排除。

   • HTTP 方法 ：设置为 PUT。
   • URL ：输入 KIE Server REST API 基本 URL 和端点，如 http://localhost:8080/kie-server/services/rest/server/containers/MyContainer。
   • Request body ：使用新 KIE 容器的配置项添加 JSON 请求正文：

   {
     "config-items": [
       {
         "itemName": "RuntimeStrategy",
         "itemValue": "SINGLETON",
         "itemType": "java.lang.String"
       },
       {
         "itemName": "MergeMode",
         "itemValue": "MERGE_COLLECTIONS",
         "itemType": "java.lang.String"
       },
       {
         "itemName": "KBase",
         "itemValue": "",
         "itemType": "java.lang.String"
       },
       {
         "itemName": "KSession",
         "itemValue": "",
         "itemType": "java.lang.String"
       }
     ],
     "release-id": {
       "group-id": "itorders",
       "artifact-id": "itorders",
       "version": "1.0.0-SNAPSHOT"
     },
     "scanner": {
       "poll-interval": "5000",
       "status": "STARTED"
     }
   }

   对于 curl 工具：

   • -u ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • - h ：设置以下标头：

     • 接受:application/json

     • content-Type:application/json

       注意

       将 fields=not_null 添加到 Content-Type 时，null 字段会从 REST API 响应中排除。

   • -x ：设置为 PUT。
   • URL ：输入 KIE Server REST API 基本 URL 和端点，如 http://localhost:8080/kie-server/services/rest/server/containers/MyContainer。
   • -d ：添加 JSON 请求正文或文件(@file.json)，其中包含新 KIE 容器的配置项目：

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -H "Content-Type: application/json" -X PUT "http://localhost:8080/kie-server/services/rest/server/containers/MyContainer" -d "{ \"config-items\": [ { \"itemName\": \"RuntimeStrategy\", \"itemValue\": \"SINGLETON\", \"itemType\": \"java.lang.String\" }, { \"itemName\": \"MergeMode\", \"itemValue\": \"MERGE_COLLECTIONS\", \"itemType\": \"java.lang.String\" }, { \"itemName\": \"KBase\", \"itemValue\": \"\", \"itemType\": \"java.lang.String\" }, { \"itemName\": \"KSession\", \"itemValue\": \"\", \"itemType\": \"java.lang.String\" } ], \"release-id\": { \"group-id\": \"itorders\", \"artifact-id\": \"itorders\", \"version\": \"1.0.0-SNAPSHOT\" }, \"scanner\": { \"poll-interval\": \"5000\", \"status\": \"STARTED\" }}"

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -H "Content-Type: application/json" -X PUT "http://localhost:8080/kie-server/services/rest/server/containers/MyContainer" -d @my-container-configs.json

6. 执行请求并查看 KIE 服务器响应。

   服务器响应示例(JSON)：

   {
     "type": "SUCCESS",
     "msg": "Container MyContainer successfully deployed with module itorders:itorders:1.0.0-SNAPSHOT.",
     "result": {
       "kie-container": {
         "container-id": "MyContainer",
         "release-id": {
           "group-id": "itorders",
           "artifact-id": "itorders",
           "version": "1.0.0-SNAPSHOT"
         },
         "resolved-release-id": {
           "group-id": "itorders",
           "artifact-id": "itorders",
           "version": "1.0.0-SNAPSHOT"
         },
         "status": "STARTED",
         "scanner": {
           "status": "STARTED",
           "poll-interval": 5000
         },
         "config-items": [],
         "messages": [
           {
             "severity": "INFO",
             "timestamp": {
               "java.util.Date": 1540584717937
             },
             "content": [
               "Container MyContainer successfully created with module itorders:itorders:1.0.0-SNAPSHOT."
             ]
           }
         ],
         "container-alias": null
       }
     }
   }

   如果您遇到请求错误，请查看返回的错误代码信息并相应地调整您的请求。

   进程实例的 REST API 请求

   对于将复杂数据对象发送到进程实例端点 /server/containers/{containerId}/processes/{processId}/instances 的 REST API 请求，请确保在请求正文中包含完全限定类名称（如 com.myspace.Person）或简单类名称（如 Person）。请求正文需要类名称才能映射到 Red Hat Process Automation Manager 中的正确业务对象。如果您从请求中排除类名称，KIE 服务器不会将对象 unmarshall 到预期的类型。

   正确的进程实例请求正文

   {
     "id": 4,
     "lease": {
       "com.myspace.restcall.LeaseModel": {
         "annualRent": 109608,
         "isAutoApproved": false
       }
     }
   }

   进程实例请求正文不正确

   {
     "id": 4,
     "lease": {
       "annualRent": 109608,
       "isAutoApproved": false
     }
   }