红帽全球峰会7.4. 特定 DMN 型号的 REST 端点
Red Hat Decision Manager 提供了特定于模型的 DMN KIE 服务器端点，您可以使用这些端点与特定的 DMN 模型交互，而无需使用 Business Central 用户界面。
对于 Red Hat Decision Manager 中的容器中的每个 DMN 模型，以下 KIE 服务器 REST 端点会根据 DMN 模型的内容自动生成：
-
POST /server/containers/{containerId}/dmn/models/{modelname}:用于评估容器中指定的 DMN 模型的"业务域"端点 -
POST /server/containers/{containerId}/dmn/models/{modelname}/{decisionServiceName}: business-domain endpoint 用于评估容器中特定 DMN 模型中的指定决策服务组件 -
POST /server/containers/{containerId}/dmn/models/{modelname}/dmnresult: 一个用于评估指定的 DMN 模型的端点，其中包含自定义正文有效负载并返回DMNResult响应，包括业务域上下文、帮助程序消息和帮助程序决策指针 -
POST /server/containers/{containerId}/dmn/models/{modelname}/{decisionServiceName}/dmnresult: 一个端点，用于评估特定 DMN 模型中的指定决策服务组件并返回DMNResult响应，包括业务域上下文、帮助程序消息，以及帮助决策服务的决策指针 -
GET /server/containers/{containerId}/dmn/models/{modelname}: 返回标准 DMN XML 的端点，且不包含指定 DMN 模型的输入和决策 -
GET /server/containers/{containerId}/dmn/openapi.json(|.yaml): 检索 Swagger 或 OAS 在指定容器中 DMN 模型的端点
您可以使用这些端点与 DMN 模型或者模型中的特定决策服务交互。当您决定使用这些 REST 端点的 Business-domain 和 dmnresult 变体时，请查看以下注意事项：
-
REST 商业域端点 ：如果客户端应用程序只关注正的评估结果，则使用此端点类型对解析
Info或Warn消息没有感兴趣，并且对任何错误只需要一个 HTTP 5xx 响应。由于与 DMN 建模行为类似，这种端点对于单页式应用程序类似的客户端也很有用，因为单一的服务结果与 DMN 建模行为类似。 -
REST
dmnresult端点 ：如果客户端需要解析Info、Warn或Error信息，则使用此端点类型。
对于每个端点，使用 REST 客户端或 curl 程序来发送使用以下组件的请求：
-
基本 URL:
http://HOST:PORT/kie-server/services/rest/ 路径参数 ：
-
{containerId}: 容器的字符串标识符，如mykjar-project -
{modelName}: DMN 模型的字符串标识符，如流量冲突 -
{decisionServiceName}: DMN DRG 中决策服务组件的字符串标识符，如 trafficViolationDecisionService -
dmnresult：字符串标识符，使端点可以返回完整的DMNResult响应，并带有更详细的信息，Warn，以及Error消息传递
-
HTTP 标头 ：仅用于
POST请求：-
接受:application/json -
content-type:application/json
-
-
HTTP 方法 ：
GET或POST
以下端点中的示例基于 mykjar-project 容器，其中包含 流量冲突 DMN 模型，其中包含 traffic ViolationDecisionService 决策服务组件。
对于所有这些端点，如果出现 DMN 评估 错误信息，则返回 DMNResult 响应，以及 HTTP 5xx 错误。如果发生 DMN Info 或 Warn 消息，相关响应随业务域 REST 正文（在 X-Kogito-decision-messages 扩展 HTTP 标头）一起返回，用于客户端的逻辑。当要求更细化客户端侧业务逻辑时，客户端可以使用端点的 dmnresult 变体。
- 为指定容器中的 DMN 型号检索 Swagger 或 OAS
GET /server/containers/{containerId}/dmn/openapi.json (|.yaml)REST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/openapi.json(|.YAML)- 返回 DMN XML 没有决策逻辑
GET /server/containers/{containerId}/dmn/models/{modelname}REST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic 违反curl 请求示例
curl -u wbadmin:wbadmin -X GET "http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic%20Violation" -H "accept: application/xml"
curl -u wbadmin:wbadmin -X GET "http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic%20Violation" -H "accept: application/xml"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 响应(XML)示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 评估指定容器中的指定的 DMN 模型
POST /server/containers/{containerId}/dmn/models/{modelname}REST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic 违反curl 请求示例
curl -u wbadmin:wbadmin-X POST "http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"Driver\":{\"Points\":15},\"Violation\":{\"Date\":\"2021-04-08\",\"Type\":\"speed\",\"Actual Speed\":135,\"Speed Limit\":100}}"curl -u wbadmin:wbadmin-X POST "http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"Driver\":{\"Points\":15},\"Violation\":{\"Date\":\"2021-04-08\",\"Type\":\"speed\",\"Actual Speed\":135,\"Speed Limit\":100}}"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 带有输入数据的 POST 请求正文示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 响应(JSON)示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 在容器中的指定 DMN 模型中评估指定的决定服务
POST /server/containers/{containerId}/dmn/models/{modelname}/{decisionServiceName}对于此端点，请求正文必须包含决策服务的所有要求。其响应是决策服务生成的 DMN 上下文，包括决策值、原始输入值以及所有其他重要指标 DRG 组件以序列化形式。例如，业务知识模型以字符串形式的签名形式提供。
如果决策服务由单一输出决定组成，则响应是该特定决策的产生值。此行为在模型本身中调用决策服务时，在规范功能的 API 级别提供同等的值。例如，您可以从单页面网页应用程序与 DMN 决策服务交互。
图 7.1. 带有单输出决策的 traffic
ViolationDecisionService决策服务示例图 7.2. 带有多输出决策的 traffic
ViolationDecisionService决策服务示例REST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic violation/TrafficViolationDecisionService带有输入数据的 POST 请求正文示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl 请求示例
curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/TrafficViolationDecisionService -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/TrafficViolationDecisionService -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 单输出决策(JSON)的响应示例
"No"
"No"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 多输出决策(JSON)的响应示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 在指定容器中评估指定的 DMN 模型并返回
DMN 结果响应 POST /server/containers/{containerId}/dmn/models/{modelname}/dmnresultREST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic violation/dmnresult带有输入数据的 POST 请求正文示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl 请求示例
curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/dmnresult -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/dmnresult -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 响应(JSON)示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 在指定容器中的 DMN 模型中评估指定的决定服务并返回
DMNResult响应 POST /server/containers/{containerId}/dmn/models/{modelname}/{decisionServiceName}/dmnresultREST 端点示例
http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic violation/TrafficViolationDecisionService/dmnresult带有输入数据的 POST 请求正文示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl 请求示例
curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/TrafficViolationDecisionService/dmnresult -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'curl -X POST http://localhost:8080/kie-server/services/rest/server/containers/mykjar-project/dmn/models/Traffic Violation/TrafficViolationDecisionService/dmnresult -H 'content-type: application/json' -H 'accept: application/json' -d '{"Driver": {"Points": 2}, "Violation": {"Type": "speed", "Actual Speed": 120, "Speed Limit": 100}}'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 响应(JSON)示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}