手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → Data Object をクリックします。

3. 一意の データオブジェクト 名を入力し、パッケージ を選択します。これにより、その他のルールアセットでもデータオブジェクトを利用できるようになります。同じパッケージに、同じ名前のデータオブジェクトを複数作成することはできません。指定するパッケージは、そのデータオブジェクトを必要とするルールアセットが割り当てられている、もしくはこれから割り当てるパッケージにする必要があります。

   別のパッケージからのデータオブジェクトのインポート

   ルールアセットのパッケージに、別のパッケージから既存のデータオブジェクトをインポートすることもできます。インポートするオブジェクトを選択するには、Project Explorer から (ガイド付きデシジョンテーブル、ガイド付きルールなどの) アセットパネルを展開し、特定のアセットを選択し、アセットデザイナーで Data Objects → New item に移動します。

4. データオブジェクトを永続化するには、Persistable チェックボックスを選択します。永続型データオブジェクトは、JPA 仕様に準じてデータベースに保存できます。デフォルトの JPA は Hibernate です。
5. OK をクリックします。

6. データオブジェクトデザイナーで add field をクリックして、Id 属性、Label 属性、Type 属性を使用するオブジェクトにフィールドを追加します。必須属性にはアスタリスク (*) マークが付いています。

   • Id: フィールドの一意の ID を入力します。
   • Label: (任意) フィールドのラベルを入力します。
   • Type: フィールドのデータ型を入力します。

   • List: このチェックボックスを選択すると、このフィールドで、指定したタイプのアイテムを複数保持できるようになります。

     図3.1 データオブジェクトへのデータフィールドの追加

     

7. Create をクリックして、新しいフィールドを追加します。Create and continue をクリックすると、新しいフィールドが追加され、別のフィールドを引き続き作成できます。

   注記

   フィールドを編集するには、フィールド行を選択し、画面右側の general properties を使用します。

手順

1. DRL デザイナーで、ルールに when を入力して、条件命令文を追加します。when セクションは、ルールの条件を定義するファクトパターンで構成されますが、ファクトパターンが 1 つも追加されない場合もあります。

   when セクションを空にすると、デシジョンエンジンで fireAllRules() を呼び出すたびに、then セクションのアクションが実行します。これは、デシジョンエンジンのステートを設定するルールを使用する場合に便利です。

   条件のないルール

   rule "bootstrap"
     when   // empty
   
     then   // actions to be executed once
       insert( new Applicant() );
   end
   
   // The above rule is internally rewritten as:
   
   rule "bootstrap"
     when
       eval( true )
     then
       insert( new Applicant() );
   end

2. 一致させる最初の条件のパターンを入力し、任意で制約、バインディング、およびサポートされる DRL 要素を入力します。基本的なパターンフォーマットは patternBinding : patternType ( constraints ) です。パターンは、パッケージで利用可能なデータオブジェクトに基づいており、then セクションのアクションを発生させるのに必要な条件を定義します。

   • 単純なパターン: 制約のない単純なパターンは、指定したタイプのファクトに一致します。たとえば、次は、申込者が存在することだけが条件になります。

     when
       Applicant( )

   • 制約のあるパターン: 制約を持つパターンは、指定したタイプのファクトと、追加制限を括弧で指定したパターン (true または false) に一致します。たとえば、次は、申込者が 21 歳に満たないことを条件としています。

     when
       Applicant( age < 21 )

   • Pattern with binding: パターンのバインディングは簡単な参照となり、ルールのその他のコンポーネントが、定義したバターンに戻って参照します。たとえば、次の例で、LoanApplication のバインディング a が、underage の申込者に関連するアクションとして使用されます。

     when
       a : LoanApplication( )
       Applicant( age < 21 )
     then
       a.setApproved( false );
       a.setExplanation( "Underage" )

3. 引き続き、このルールに適用する条件パターンをすべて定義します。以下は、DRL 条件を定義するいくつかのキーワードオプションです。

   • and: 条件コンポーネントを論理積に分類します。接中辞および接頭辞の and がサポートされます。デフォルトでは、結合演算子を指定しないと、リストされている条件またはアクションがすべて and と結合します。

     a : LoanApplication( ) and Applicant( age < 21 )
     
     a : LoanApplication( )
     and Applicant( age < 21 )
     
     a : LoanApplication( )
     Applicant( age < 21 )
     
     // All of the above are the same.

   • or: 条件コンポーネントを論理和に分類します。接中辞および接頭辞の or がサポートされます。

     ( Bankruptcy( amountOwed == 100000 ) or IncomeSource( amount == 20000 ) )
     
     Bankruptcy( amountOwed == 100000 )
     or IncomeSource( amount == 20000 )

   • exists: 存在すべきファクトおよび制約を指定します。これは、ファクトが存在していることを示しているのではなく、ファクトが存在すべきであることを示しています。このオプションは、最初に一致したものだけが適用され、その後一致するものは無視されます。

     exists (Bankruptcy( yearOfOccurrence > 1990 || amountOwed > 10000 ))

   • not: 存在するべきでないファクトおよび制約を指定します。

     not (Applicant( age < 21 ))

   • forall: 最初のパターンに一致したすべてのファクトが残りのパターンに一致する制約を作成します。

     forall( app : Applicant( age < 21 )
                   Applicant( this == app, status = 'underage' ) )

   • from: 条件パターンによりデータが一致するソースを指定します。

     Applicant( ApplicantAddress : address )
     Address( zipcode == "23920W" ) from ApplicantAddress

   • entry-point: パターンのデータソースに対応するエントリーポイントを定義します。通常は from とともに使用します。

     Applicant( ) from entry-point "LoanApplication"

   • collect: 構成を条件の一部として使用できる、オブジェクトのコレクションを定義します。この例では、指定した各担保に対して、デシジョンエンジンで保留されているすべての申し込みが ArrayLists に分類されます。申し込みが 3 つ以上ある場合は、このルールが実行します。

     m : Mortgage()
     a : ArrayList( size >= 3 )
         from collect( LoanApplication( Mortgage == m, status == 'pending' ) )

   • accumulate: オブジェクトのコレクションを処理し、各要素のカスタムアクションを実行し、(制約が true と評価されると) 結果オブジェクトを 1 つ以上返します。このオプションは、collect よりも強力で、柔軟性が高いオプションです。accumulate( <source pattern>; <functions> [;<constraints>] ) 形式を使用します。この例では、min、max、および average は累積関数で、各センサーのすべての測定値から、最低気温、最高気温、そして平均気温の値を計算します。その他のサポートされる関数には、count、sum、variance、standardDeviation、collectList、および collectSet があります。

     s : Sensor()
     accumulate( Reading( sensor == s, temp : temperature );
                 min : min( temp ),
                 max : max( temp ),
                 avg : average( temp );
                 min < 20, avg > 70 )

     高度な DRL オプション

     これは、条件を定義する基本的なキーワードオプションおよびパターン構築の例です。さらに高度な DRL オプションと構文が DRL デザイナーでサポートされています。オンラインの『Drools ドキュメンテーション』を参照してください。

4. ルールの条件コンポーネントをすべて定義したら、DRL デザイナーの右上のツールバーの Validate をクリックして、DRL ファイルの妥当性を確認します。ファイルの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、DRL ファイルの構文およびコンポーネントを見直し、エラーが表示されなくなるまで妥当性確認を行います。
5. DRL デザイナーで Save をクリックして、設定した内容を保存します。

手順

1. DRL デザイナーで、ルールの when セクションの後に then を入力して、アクション命令文を追加します。

2. ルールの条件に基づいて、ファクトパターンに対して実行するアクションを 1 つ以上入力します。

   次は、DRL アクションを定義するキーワードオプションの例です。

   • and: アクションコンポーネントを論理積に分類します。接中辞および接頭辞の and がサポートされます。デフォルトでは、結合演算子を指定しないと、リストされている条件またはアクションがすべて and と結合します。

     application.setApproved ( false ) and application.setExplanation( "has been bankrupt" );
     
     application.setApproved ( false );
     and application.setExplanation( "has been bankrupt" );
     
     application.setApproved ( false );
     application.setExplanation( "has been bankrupt" );
     
     // All of the above are the same.

   • set: フィールドの値を設定します。

     application.setApproved ( false );
     application.setExplanation( "has been bankrupt" );

   • modify: ファクトに対して修正するフィールドを指定し、変更をデシジョンエンジンに通知します。

     modify( LoanApplication ) {
             setAmount( 100 )
     }

   • update: フィールドと、修正される関連ファクト全体を指定して、その変更をデシジョンエンジンに通知します。ファクトが変更したら、アップデートした値の影響を受ける可能性がある別のファクトを変更する前に、update を呼び出す必要があります。modify キーワードには、この追加手順がありません。

     update( LoanApplication ) {
             setAmount( 100 )
     }

   • delete: デシジョンエンジンからオブジェクトを削除します。キーワード retract も DRL デザイナーでサポートされ、同じアクションを実行しますが、キーワード insert との一貫性を保つために delete が好まれます。

     delete( LoanApplication );

   • insert: 新しい ファクトを挿入し、ファクトに必要な結果フィールドと値を定義します。

     insert( new Applicant() );

   • insertLogical: 新しい ファクトをデシジョンエンジンに論理的に挿入し、ファクトに必要な結果フィールドと値を追加します。Red Hat Decision Manager のデシジョンエンジンは、ファクトの挿入および取り消しに対して論理的な決断を行います。定期的な挿入、または指定した挿入の後に、ファクトを明示的に取り消す必要があります。論理挿入の後に、ファクトをアサートした条件が TRUE ではなくなると、ファクトは自動的にに取り消されます。

     insertLogical( new Applicant() );

     高度な DRL オプション

     これは、アクションを定義する基本的なキーワードオプションおよびパターン構築の例です。さらに高度な DRL オプションと構文が DRL デザイナーでサポートされています。オンラインの『Drools ドキュメンテーション』を参照してください。

3. ルールのアクションコンポーネントをすべて定義したら、DRL デザイナーの右上のツールバーの Validate をクリックして、DRL ファイルの妥当性を確認します。ファイルの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、DRL ファイルの構文およびコンポーネントを見直し、エラーが表示されなくなるまで妥当性確認を行います。
4. DRL デザイナーで Save をクリックして、設定した内容を保存します。

手順

1. Red Hat JBoss Developer Studio で、File → New → Project をクリックします。
2. 開いた New Project ウィンドウで、Drools → Drools Project を選択し、Next をクリックします。
3. Create a project and populate it with some example files to help you get started quickly の 2 番目のアイコンをクリックして、Next をクリックします。

4. Project name を入力し、プロジェクトのビルドオプションで Maven ラジオボタンを選択します。GAV 値が自動的に生成されます。必要に応じて、プロジェクトに対してこの値を更新できます。

   • Group ID: com.sample
   • Artifact ID: my-project
   • Version: 1.0.0-SNAPSHOT

5. Finish をクリックしてプロジェクトを作成します。

   これは、基本的なプロジェクト構造、クラスパス、サンプルルールを設定します。以下は、プロジェクト構造の概要です。

   my-project
    `-- src/main/java
       | `-- com.sample
       |    `-- DecisionTable.java
       |    `-- DroolsTest.java
       |    `-- ProcessTest.java
       |
    `-- src/main/resources
       | `-- dtables
       |    `-- Sample.xls
       | `-- process
       |    `-- sample.bpmn
       | `-- rules
       |    `-- Sample.drl
       | `-- META-INF
       |
    `-- JRE System Library
       |
    `-- Maven Dependencies
       |
    `-- Drools Library
       |
    `-- src
       |
    `-- target
       |
    `-- pom.xml

   以下の要素に注目してください。

   • src/main/resources ディレクトリーの Sample.drl ルールファイル。これには、サンプルの Hello World ルールおよび GoodBye ルールが含まれます。
   • com.sample パッケージの src/main/java ディレクトリーにある DroolsTest.java ファイル。DroolsTest クラスを使用してルールを実行できます。
   • 実行するのに必要な JAR ファイルを含むカスタムのクラスパスとなる Drools Library ディレクトリー。

6. DRL ファイルで必要なすべてのオブジェクトを使用して、ファクトモデルを作成します。

   DroolsTest.java ファイルには、ゲッターメソッドおよびセッターメソッドを使用するサンプルの Java オブジェクト Message が含まれます。このクラスを編集するか、別の Java オブジェクトを作成します。この例では、Person クラスに、名前、苗字、時給、賃金を設定および取得するメソッドが使用されます。

   public static class Person {
   
     private String firstName;
     private String lastName;
     private Integer hourlyRate;
     private Integer wage;
   
     public String getFirstName() {
       return firstName;
     }
   
     public void setFirstName(String firstName) {
       this.firstName = firstName;
     }
   
     public String getLastName() {
       return lastName;
     }
   
     public void setLastName(String lastName) {
       this.lastName = lastName;
     }
   
     public Integer getHourlyRate() {
       return hourlyRate;
     }
   
     public void setHourlyRate(Integer hourlyRate) {
       this.hourlyRate = hourlyRate;
     }
   
     public Integer getWage(){
       return wage;
     }
   
     public void setWage(Integer wage){
       this.wage = wage;
     }
   }

7. main() メソッドをアップデートして、Java オブジェクトをルールに渡します。

   DroolsTest.java ファイルには、ナレッジベースをロードし、ファクトを挿入し、ルールを実行する main() メソッドが含まれます。次のメソッドアップデートは、Person オブジェクトをルールに渡します。

   public static final void main(String[] args) {
     try {
       // Load the knowledge base:
       KieServices ks = KieServices.Factory.get();
       KieContainer kContainer = ks.getKieClasspathContainer();
       KieSession kSession = kContainer.newKieSession("ksession-rules");
   
       // Go!
       Person p = new Person();
       p.setWage(12);
       p.setFirstName("Tom");
       p.setLastName("Summers");
       p.setHourlyRate(10);
   
       kSession.insert(p);
       kSession.fireAllRules();
     }
   
     catch (Throwable t) {
       t.printStackTrace();
     }
   }

   ナレッジベースをロードするには、KieServices インスタンスと、クラスパスベースの KieContainer を取得して、KieContainer を指定した KieSession を構築します。前の例では、kmodule.xml ファイルに定義したものと一致した ksession-rules セッションが渡されます。

8. 最低でも、ルールで使用するパッケージ仕様、データオブジェクトのインポートリスト、when 条件および then アクションが指定されたルールが 1 つ以上含まれる DRL ファイルを作成します。

   ルールファイル Sample.drl には、2 つのルール例が含まれます。このファイルを編集するか、新たに作成できます。

   package com.sample
   
   import com.sample.DroolsTest.Person;
   
   dialect "java"
   
   rule "Wage"
     when
       Person(hourlyRate * wage > 100)
       Person(name : firstName, surname : lastName)
     then
       System.out.println("Hello" + " " + name + " " + surname + "!");
       System.out.println("You are rich!");
   end

9. File → Save に移動して、ファイルを保存します。
10. プロジェクトで DRL アセットをすべて作成して保存したあと、プロジェクトフォルダーを右クリックして、Run As → Java Application を選択してプロジェクトをビルドします。プロジェクトのビルドに失敗したら、Developer Studio の下部ウィンドウの Problems タブに記載されている問題に対応し、プロジェクトビルドされるまで妥当性確認を行います。

手順

1. ルールが有効な Java オブジェクトを作成します。

   この例では、my-project ディレクトリーに Person.java ファイルが作成されます。Person クラスには、名前、苗字、時給、賃金を設定および取得するゲッターメソッドおよびセッターメソッドが含まれます。

     public class Person {
       private String firstName;
       private String lastName;
       private Integer hourlyRate;
       private Integer wage;
   
       public String getFirstName() {
         return firstName;
       }
   
       public void setFirstName(String firstName) {
         this.firstName = firstName;
       }
   
       public String getLastName() {
         return lastName;
       }
   
       public void setLastName(String lastName) {
         this.lastName = lastName;
       }
   
       public Integer getHourlyRate() {
         return hourlyRate;
       }
   
       public void setHourlyRate(Integer hourlyRate) {
         this.hourlyRate = hourlyRate;
       }
   
       public Integer getWage(){
         return wage;
       }
   
       public void setWage(Integer wage){
         this.wage = wage;
       }
     }

2. my-project ディレクトリーに .drl フォーマットのルールファイルを作成します。

   以下の Person.drl ルールでは、賃金と時給を計算し、その結果に基づいてメッセージを表示します。

   dialect "java"
   
   rule "Wage"
     when
       Person(hourlyRate * wage > 100)
       Person(name : firstName, surname : lastName)
     then
       System.out.println("Hello" + " " + name + " " + surname + "!");
       System.out.println("You are rich!");
   end

3. メインクラスを作成し、Java オブジェクトを作成したディレクトリーに保存します。メインクラスはナレッジベースをロードし、ルールを実行します。

4. メインクラスに、KIE サービス、KIE コンテナー、および KIE セッションをインポートするのに必要な import 命令文を追加します。つぎに、ナレッジベースをロードし、ファクトを挿入し、ファクトモデルをルールに渡す main() メソッドからルールを実行します。

   以下の例では、必要なインポートがリストされ、メインクラス DroolsTest.java が作成されます。

   import org.kie.api.KieServices;
   import org.kie.api.runtime.KieContainer;
   import org.kie.api.runtime.KieSession;
   
   public class DroolsTest {
     public static final void main(String[] args) {
       try {
         // Load the knowledge base:
         KieServices ks = KieServices.Factory.get();
         KieContainer kContainer = ks.getKieClasspathContainer();
         KieSession kSession = kContainer.newKieSession();
   
         // Go!
         Person p = new Person();
         p.setWage(12);
         p.setFirstName("Tom");
         p.setLastName("Summers");
         p.setHourlyRate(10);
   
         kSession.insert(p);
         kSession.fireAllRules();
       }
   
       catch (Throwable t) {
         t.printStackTrace();
       }
     }
   }

5. Red Hat カスタマーポータル から Red Hat Decision Manager 7.0 Core Engine ZIP ファイルをダウンロードし、my-project/dm-engine-jars/ で展開します。

6. my-project/META-INF ディレクトリーに、以下の内容の kmodule.xml メタデータファイルを作成します。

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

   この kmodule.xml ファイルは、ナレッジベースへのリソースを選択し、セッションを設定する記述子です。このファイルを使用すると、KIE ベースを 1 つ以上定義して設定し、特定の KIE の特定の packages から DRL ファイルを追加できます。各 KIE ベースから KIE セッションを 1 つ以上作成することもできます。

   次の例は、より高度な 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">
     <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="stateless" default="false" 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="stateful" default="false" 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 ベースを 2 つ定義します。KIE ベース KBase1 から 2 つの KIE セッションをインスタンス化し、KBase2 から 1 つの KIE セッションをインスタンス化します。ルールアセットで特定の packages が両方の KIE ベースに含まれます。この方法でパッケージを指定した場合は、指定したパッケージを反映するフォルダー構造で DRL ファイルを整理する必要があります。

7. Java オブジェクトですべての DRL アセットを作成して保存したあと、コマンドラインで my-project ディレクトリーに移動し、以下のコマンドを実行して Java ファイルを構築します。DroolsTest.java を、Java のメインクラス名に置き換えます。

   javac -classpath "./dm-engine-jars/*:." DroolsTest.java

   ビルドに失敗したら、コマンドラインのエラーメッセージに記載されている問題に対応し、エラーが表示されなくなるまで Java オブジェクトの妥当性確認を行います。

8. Java ファイルが問題なくビルトできたら、以下のコマンドを実行してルールを実行します。DroolsTest を、Java メインクラスの接頭辞に置き換えます。

   javac -classpath "./dm-engine-jars/*:." DroolsTest

9. ルールを見直して、適切に実行したことを確認し、Java ファイルで必要な変更に対応します。

手順

1. Maven アーキタイプを作成するディレクトリーに移動して、次のコマンドを実行します。

   mvn archetype:generate -DgroupId=com.sample.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

   これにより、my-app という名前のディレクトリーが、以下の構造で作成されます。

   my-app
   |-- pom.xml
   `-- src
       |-- main
       |   `-- java
       |       `-- com
       |           `-- sample
       |               `-- app
       |                   `-- App.java
       `-- test
           `-- java
               `-- com
                   `-- sample
                       `-- app
                           `-- AppTest.java

   my-app ディレクトリーには、以下の重要なコンポーネントが含まれます。

   • アプリケーションソースを保存する src/main ディレクトリー
   • テストソースを保存する src/test ディレクトリー
   • プロジェクト設定ファイル pom.xml

2. Maven アーキタイプに、ルールが有効な Java オブジェクトを作成します。

   この例では、my-app/src/main/java/com/sample/app ディレクトリーに Person.java ファイルが作成されます。Person クラスには、名前、苗字、時給、賃金を設定および取得するゲッターメソッドおよびセッターメソッドが含まれます。

   package com.sample.app;
   
     public class Person {
   
       private String firstName;
       private String lastName;
       private Integer hourlyRate;
       private Integer wage;
   
       public String getFirstName() {
         return firstName;
       }
   
       public void setFirstName(String firstName) {
         this.firstName = firstName;
       }
   
       public String getLastName() {
         return lastName;
       }
   
       public void setLastName(String lastName) {
         this.lastName = lastName;
       }
   
       public Integer getHourlyRate() {
         return hourlyRate;
       }
   
       public void setHourlyRate(Integer hourlyRate) {
         this.hourlyRate = hourlyRate;
       }
   
       public Integer getWage(){
         return wage;
       }
   
       public void setWage(Integer wage){
         this.wage = wage;
       }
     }

3. my-app/src/main/resources/rules ディレクトリーに .drl フォーマットのルールファイルを作成します。

   以下の Person.drl ルールは Person クラスをインポートし、賃金および時給の値を計算し、結果に基づいてメッセージを表示します。

   package com.sample.app;
   import com.sample.app.Person;
   
   dialect "java"
   
   rule "Wage"
     when
       Person(hourlyRate * wage > 100)
       Person(name : firstName, surname : lastName)
     then
       System.out.println("Hello " + name + " " + surname + "!");
       System.out.println("You are rich!");
   end

4. my-app/src/main/resources/META-INF ディレクトリーに、以下の内容の kmodule.xml メタデータファイルを作成します。

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

   この kmodule.xml ファイルは、ナレッジベースへのリソースを選択し、セッションを設定する記述子です。このファイルを使用すると、KIE ベースを 1 つ以上定義して設定し、特定の KIE の特定の packages から DRL ファイルを追加できます。各 KIE ベースから KIE セッションを 1 つ以上作成することもできます。

   次の例は、より高度な 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">
     <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="stateless" default="false" 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="stateful" default="false" 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 ベースを 2 つ定義します。KIE ベース KBase1 から 2 つの KIE セッションをインスタンス化し、KBase2 から 1 つの KIE セッションをインスタンス化します。ルールアセットで特定の packages が両方の KIE ベースに含まれます。この方法でパッケージを指定した場合は、指定したパッケージを反映するフォルダー構造で DRL ファイルを整理する必要があります。

5. my-app/pom.xml 設定ファイルで、アプリケーションが要求するライブラリーを指定します。Red Hat Decision Manager の依存関係と、アプリケーションの group ID、artifact ID、および version (GAV) を提供します。

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.sample.app</groupId>
   <artifactId>my-app</artifactId>
   <version>1.0.0</version>
   <repositories>
     <repository>
       <id>jboss-ga-repository</id>
       <url>http://maven.repository.redhat.com/ga/</url>
     </repository>
   </repositories>
   <dependencies>
     <dependency>
       <groupId>org.drools</groupId>
       <artifactId>drools-compiler</artifactId>
       <version>VERSION</version>
     </dependency>
     <dependency>
       <groupId>org.kie</groupId>
       <artifactId>kie-api</artifactId>
       <version>VERSION</version>
     </dependency>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>4.11</version>
       <scope>test</scope>
     </dependency>
   </dependencies>
   </project>

   Red Hat Decision Manager でサポートされる Maven アーティファクトのバージョンについては『Red Hat Decision Manager のオンプレミスインストール』を参照してください。

6. my-app/src/test/java/com/sample/app/AppTest.java の testApp メソッドを使用してルールをテストします。Maven によって、AppTest.java ファイルがデフォルトで作成されます。

7. AppTest.java ファイルで、KIE サービス、KIE コンテナー、および KIE セッションをインポートするのに必要な import 命令文を追加します。ナレッジベースをロードし、ファクトを挿入し、ファクトモデルをルールに渡す testApp() メソッドからルールを実行します。

   以下の例では、必要なインポートがリストされ、ファクトモデル DroolsTest.java が作成されました。

   import org.kie.api.KieServices;
   import org.kie.api.runtime.KieContainer;
   import org.kie.api.runtime.KieSession;
   
   public void testApp() {
   
     // Load the knowledge base:
     KieServices ks = KieServices.Factory.get();
     KieContainer kContainer = ks.getKieClasspathContainer();
     KieSession kSession = kContainer.newKieSession();
   
     // Set up the fact model:
     Person p = new Person();
     p.setWage(12);
     p.setFirstName("Tom");
     p.setLastName("Summers");
     p.setHourlyRate(10);
   
     // Insert the person into the session:
     kSession.insert(p);
   
     // Fire all rules:
     kSession.fireAllRules();
   }

8. Maven アーキタイプにすべての DRL アセットを作成して保存したあと、コマンドラインで my-app ディレクトリーに移動し、以下のコマンドを実行してファイルを作成します。

   mvn clean install

   このコマンドを最初に実行した場合は、ビルドプロセスにかかる時間が通常よりも長くなります。ビルドが完了すると、コマンドラインに結果が表示されます。

   ...
   
   Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.194 sec
   
   Results :
   
   Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   
   [INFO]
   ...
   [INFO] --------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] --------------------------------------------------------------
   [INFO] Total time: 6.393 s
   ...
   [INFO] --------------------------------------------------------------

9. ビルド結果を見直して、ビルドが適切に実行したことを確認し、ファイルのエラーに対応します。