Red Hat Decision Managerのルール実行環境をSpringBootで素早く構築してルールアプリを動かしてみる(前編)


Red Hat Decision Managerは、Javaで実装されたオープンソースのルールエンジン製品です。
ルールエンジンとは、データを渡すと、あらかじめ定義されたルールに基づいて効率よく各種判定および処理を実行してくれるものです。

データオブジェクト(JavaのPOJO)とルール定義(専用言語によるスクリプト、またはExcelで定義)を作成すれば、ルールは直ぐに実行することができますが、
ここでは、SpringBootを使って、ルール実行環境を簡単に作る方法を紹介します。

前提環境

  • JDK1.8以上
  • Maven3.x

JavaとMavenはあらかじめ必要です。なければインストールください。

以下、2部構成です。構築するところまでが、この記事(前編)で、ルールアプリを作成して動かすところは後編を参照ください。

前編 Spring BootでKieServerを動かす(10分程度で完了)
後編 ルールアプリを作成しKieServer上で実行する(30分程度かかるかな)

(前編) Spring BootでKieServerを動かす

KieServer(Decision Serverとか、Execution Serverとか呼び名がいろいろあるので注意)とは、REST APIでルールを実行できるサーバアプリです。
JBoss EAPや、Weblogicを立てて、そこにKieServerをデプロイして動作させることももちろん可能ですが、ここではSpringBootスターターを使ってKieServerを素早くあげちゃいましょう。
この手順は、製品マニュアルにも出ています。

KieServer on Spring Bootを取得

製品マニュアルにも書いてありますが、ここ(https://start.jbpm.org)からダウンロードすると、KieServer on Spring Bootがダウンロードできます。

  1. Configure your business Application を選択
  2. Decision Management を選択
  3. Package Name、Application Name、Versionを選択(名前は好きなものでOK。Versionは、Enterprise xxを選択してください。Versionは後から変更できます。)
  4. Business Assets、Data Models、Serviceを選択し、「Generate business Application」をクリック

KieServer on Sprint BootがZip形式でダウンロードされます。

ダウンロードしたZipを解凍すると、3つのプロジェクトが確認できます。business-appication部分は、自分で指定したApplication Nameになっています。

KieServerを起動

起動スクリプトが含まれていますので、それを実行するとKieServerが起動しますが、その前にいくつか作業をします。

settings.xmlに製品リポジトリを追加

Maven Repositoryを追加設定しましょう。
自分の環境で参照している、settings.xmlファイルを開き、以下を追記します。(pom.xmlに追記でももちろん可)
これにより、Red Hatの製品版のリポジトリが参照先として追加されます。

<repository>
  <id>jboss-enterprise-repository-group</id>
  <name>Red Hat JBoss Enterprise Maven Repository</name>
  <url>https://maven.repository.redhat.com/ga/</url>
  <layout>default</layout>
  <releases>
    <updatePolicy>never</updatePolicy>
  </releases>
  <snapshots>
    <updatePolicy>daily</updatePolicy>
  </snapshots>
</repository>
<pluginRepository>
  <id>jboss-enterprise-repository-group</id>
  <name>Red Hat JBoss Enterprise Maven Repository</name>
  <url>https://maven.repository.redhat.com/ga/</url>
  <layout>default</layout>
  <releases>
    <updatePolicy>never</updatePolicy>
  </releases>
  <snapshots>
    <updatePolicy>daily</updatePolicy>
  </snapshots>
</pluginRepository>

Swaggerの有効化

後ほど、SwaggerUI使う予定なので、SwaggerドキュメントとUIを有効にしておきましょう。

1.<business-application>/<business-application>-service/pom.xml ファイルを開きます。
2.以下の依存関係を追加して、このファイルを保存します。

    <dependency>
      <groupId>org.apache.cxf</groupId>
      <artifactId>cxf-rt-rs-service-description-swagger</artifactId>
      <version>3.1.11</version>
    </dependency>
    <dependency>
      <groupId>io.swagger</groupId>
      <artifactId>swagger-jaxrs</artifactId>
      <version>1.5.15</version>
      <exclusions>
        <exclusion>
          <groupId>javax.ws.rs</groupId>
          <artifactId>jsr311-api</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>org.webjars</groupId>
      <artifactId>swagger-ui</artifactId>
      <version>2.2.10</version>
    </dependency>

3.テキストエディターで <business-application>/<business-application>-service/src/main/resources/application.properties ファイルを開きます。
4.以下の行を application.properties ファイルに追加します。

kieserver.swagger.enabled=true

ビルドして実行する

起動スクリプトがついているので、それを使います。

$ cd <business-application>/<business-application>-service
$ ./launch.sh clean install

Windows環境の方は、./launch.bat clean install

ビルドが始まり、やがてそれが成功すると(初回は、必要なjarをたくさんダウンロードしてくるので、時間がかかります)、SpringBootが起動し、KieServerが起動します。

(中略)

(中略)

起動確認

起動後、以下URLにアクセスすると、HTMLファイルが表示されます。

http://localhost:8090/

ルールは何も実装していないので、アプリケーションの中身はほぼ空なので、ここではこのページが表示されることを確認するだけです。
止めるときは、Ctrl+C です。

SwaggerUI確認

SwaggerUIも確認してみましょう。以下URLにアクセスして、SwaggerUIが表示されることを確認します。
user/userログイン出来ます。

http://localhost:8090/rest/api-docs?url=http://localhost:8090/rest/swagger.json

ここから、ルールの実行などをテストすることが可能です。
SwaggerUIを使わなくても、curl等でルール実行は可能です。

さて、ここまでで、KieServerが準備できました。するっといけば、10分くらいで出来たはずです。

続きは後編にて。

Red Hat Decision Managerのルール実行環境をSpringBootで素早く構築してルールアプリを動かしてみる(後編)