手順

1. classpath または ReleaseId から KIE コンテナーを作成します。

   KieServices kieServices = KieServices.Factory.get();
   
   ReleaseId releaseId = kieServices.newReleaseId( "org.acme", "my-kjar", "1.0.0" );
   KieContainer kieContainer = kieServices.newKieContainer( releaseId );

   代替オプション:

   KieServices kieServices = KieServices.Factory.get();
   
   KieContainer kieContainer = kieServices.getKieClasspathContainer();

2. namespace モデルおよび modelName モデルを使用して、KIE コンテナーの DMNRuntime と、評価する DMN モデルへの参照を取得します。

   DMNRuntime dmnRuntime = kieContainer.newKieSession().getKieRuntime(DMNRuntime.class);
   
   String namespace = "http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a";
   String modelName = "dmn-movieticket-ageclassification";
   
   DMNModel dmnModel = dmnRuntime.getModel(namespace, modelName);

3. 希望のモデルでデシジョンサービスを実行します。

   DMNContext dmnContext = dmnRuntime.newContext();  1
   
   for (Integer age : Arrays.asList(1,12,13,64,65,66)) {
     dmnContext.set("Age", age);  2
     DMNResult dmnResult = dmnRuntime.evaluateAll(dmnModel, dmnContext);  3
     for (DMNDecisionResult dr : dmnResult.getDecisionResults()) {  4
       log.info("Age " + age + " Decision '" + dr.getDecisionName() + "' : " + dr.getResult());
     }
   }

   1

   モデル評価に対する入力として使用する、新しい DMN コンテキストをインスタンス化します。この例では、Age Classification の意思決定を複数回ループさせています。

   2

   入力の DMN コンテキストに対して入力変数を割り当てます。

   3

   DMN モデルに定義した DMN デシジョンをすべて評価します。

   4

   1 回の評価で結果が 1 つ以上になることがあり、ループを作成します。

   この例では、以下の結果を出力します。

   Age 1 Decision 'AgeClassification' : Child
   Age 12 Decision 'AgeClassification' : Child
   Age 13 Decision 'AgeClassification' : Adult
   Age 64 Decision 'AgeClassification' : Adult
   Age 65 Decision 'AgeClassification' : Senior
   Age 66 Decision 'AgeClassification' : Senior

手順

1. 適切な接続情報で 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

   マーシャリングの形式は、org.kie.server.api.marshalling.MarshallingFormat のインスタンスです。これは、メッセージが JSON であるか XML であるかを制御します。マーシャリング形式のオプションは、JSON、JAXB、 XSTREAM です。

2. KIE サーバーの Java クライアントインスタンスで getServicesClient() メソッドを呼び出すことで、関連する Decision Server に接続した KIE サーバーの Java クライアントから DMNServicesClient を取得します。

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

   これで、dmnClient が、Decision Server でデシジョンサービスを実行できるようになりました。

3. 希望するモデルに対してデシジョンサービスを実行します。

   例:

   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() + "' : " + dr.getResult());
   	}
   }

   1

   モデル評価に対する入力として使用する、新しい DMN コンテキストをインスタンス化します。この例では、Age Classification の意思決定を複数回ループさせています。

   2

   入力 DMN コンテキストに対して入力変数を割り当てます。

   3

   DMN モデルに定義したすべての DMN の意思決定を評価しま す。

   • $kieContainerId は、DMN モデルを含む KJAR がデプロイされているコンテナーの ID です。
   • $modelNamespace は、モデルの名前空間です。
   • $modelName は、モデルの名前です。

   4

   DMN の結果オブジェクトは、サーバーの応答から利用できます。

   この時点では、dmnResult には、評価した DMN モデルから得た意思決定の結果がすべて含まれます。

   注記

   DMNServicesClient で利用可能なメソッドを使用して、モデルで特定の DMN 意思決定だけを実行することもできます。

   ヒント

   KIE コンテナーに DMN モデルが 1 つだけ含まれる場合は、KIE API によってデフォルトで選択されるため、$modelNamespace と $modelName を除外できます。

手順

1. REST エンドポイントにアクセスするためのベース URL を決定します。これには、以下の値が必要です (例ではローカルのデプロイメント値を使用しています)。

   • ホスト (localhost)
   • ポート (8080)
   • ルートコンテキスト (kie-server)
   • ベース REST パス (services/rest/server)

   ローカルデプロイメントのサンプル URL:

   http://localhost:8080/kie-server/services/rest/server

2. ユーザー認証要件を決定します。

   ユーザーを Decision Server 設定に直接定義すると、ユーザー名およびパスワードを要求する BasicAuth が使用されます。要求を成功させるには、ユーザーに kie-server ルールが必要です。

   以下の例は、curl 要求に認証情報を追加する方法を示します。

   curl -u username:password <request>

   Red Hat シングルサインオンを使用して Decision Server を設定している場合は、要求にベアラートークンを含む必要があります。

   curl -H "Authorization: bearer $TOKEN" <request>

3. 要求と応答の形式を指定します。REST エンドポイントには JSON と XML の両方の書式が有効で、要求ヘッダーを使用して設定します。

   JSON

   curl -H "accept: application/json" -H "content-type: application/json"

   XML

   curl -H "accept: application/xml" -H "content-type: application/xml"

4. (任意) デプロイしたデシジョンモデルのリストに対するコンテナーのクエリーです。

   [GET] /containers/CONTAINER_ID/dmn

   curl 要求例:

   curl -u krisv:krisv -H "accept: application/xml" -X GET "http://localhost:8080/kie-server/services/rest/server/containers/MovieDMNContainer/dmn"

   サンプルの XML 出力:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <response type="SUCCESS" msg="OK models successfully retrieved from container 'MovieDMNContainer'">
       <dmn-model-info-list>
           <model>
               <model-namespace>http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a</model-namespace>
               <model-name>dmn-movieticket-ageclassification</model-name>
               <model-id>_99</model-id>
               <decisions>
                   <dmn-decision-info>
                       <decision-id>_3</decision-id>
                       <decision-name>AgeClassification</decision-name>
                   </dmn-decision-info>
               </decisions>
           </model>
       </dmn-model-info-list>
   </response>

   サンプルの JSON 出力:

   {
     "type" : "SUCCESS",
     "msg" : "OK models successfully retrieved from container 'MovieDMNContainer'",
     "result" : {
       "dmn-model-info-list" : {
         "models" : [ {
           "model-namespace" : "http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a",
           "model-name" : "dmn-movieticket-ageclassification",
           "model-id" : "_99",
           "decisions" : [ {
             "decision-id" : "_3",
             "decision-name" : "AgeClassification"
           } ]
         } ]
       }
     }
   }

5. モデルを実行します。

   [POST] /containers/CONTAINER_ID/dmn

   curl 要求例:

   curl -u krisv:krisv -H "accept: application/json" -H "content-type: application/json" -X POST "http://localhost:8080/kie-server/services/rest/server/containers/MovieDMNContainer/dmn" -d "{ \"model-namespace\" : \"http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a\", \"model-name\" : \"dmn-movieticket-ageclassification\", \"decision-name\" : [ ], \"decision-id\" : [ ], \"dmn-context\" : {\"Age\" : 66}}"

   JSON 要求例:

   {
     "model-namespace" : "http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a",
     "model-name" : "dmn-movieticket-ageclassification",
     "decision-name" : [ ],
     "decision-id" : [ ],
     "dmn-context" : {"Age" : 66}
   }

   XML 要求例 (JAXB スタイル):

   <?xml version="1.0" encoding="UTF-8"?>
   <dmn-evaluation-context>
       <model-namespace>http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a</model-namespace>
       <model-name>dmn-movieticket-ageclassification</model-name>
       <dmn-context xsi:type="jaxbListWrapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
           <type>MAP</type>
           <element xsi:type="jaxbStringObjectPair" key="Age">
               <value xsi:type="xs:int" xmlns:xs="http://www.w3.org/2001/XMLSchema">66</value>
           </element>
       </dmn-context>
   </dmn-evaluation-context>

   注記

   要求には、その形式にかかわらず、以下の要素が必要です。

   • モデルの名前空間
   • モデル名
   • 入力値を含むコンテキストオブジェクト

   JSON 応答例:

   {
     "type" : "SUCCESS",
     "msg" : "OK from container 'MovieDMNContainer'",
     "result" : {
       "dmn-evaluation-result" : {
         "messages" : [ ],
         "model-namespace" : "http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a",
         "model-name" : "dmn-movieticket-ageclassification",
         "decision-name" : [ ],
         "dmn-context" : {
           "Age" : 66,
           "AgeClassification" : "Senior"
         },
         "decision-results" : {
           "_3" : {
             "messages" : [ ],
             "decision-id" : "_3",
             "decision-name" : "AgeClassification",
             "result" : "Senior",
             "status" : "SUCCEEDED"
           }
         }
       }
     }
   }

   XML (JAXB 形式) 応答例:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <response type="SUCCESS" msg="OK from container 'MovieDMNContainer'">
         <dmn-evaluation-result>
               <model-namespace>http://www.redhat.com/_c7328033-c355-43cd-b616-0aceef80e52a</model-namespace>
               <model-name>dmn-movieticket-ageclassification</model-name>
               <dmn-context xsi:type="jaxbListWrapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                     <type>MAP</type>
                     <element xsi:type="jaxbStringObjectPair" key="Age">
                           <value xsi:type="xs:int" xmlns:xs="http://www.w3.org/2001/XMLSchema">66</value>
                     </element>
                     <element xsi:type="jaxbStringObjectPair" key="AgeClassification">
                           <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema">Senior</value>
                     </element>
               </dmn-context>
               <messages/>
               <decisionResults>
                     <entry>
                           <key>_3</key>
                           <value>
                                 <decision-id>_3</decision-id>
                                 <decision-name>AgeClassification</decision-name>
                                 <result xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Senior</result>
                                 <messages/>
                                 <status>SUCCEEDED</status>
                           </value>
                     </entry>
               </decisionResults>
         </dmn-evaluation-result>
   </response>