第59章 ワークアイテムハンドラーのプロジェクト作成

手順

1. コマンドラインを開き、workitem-home などのワークアイテムハンドラーをビルドするディレクトリーを作成します。

   $ mkdir workitem-home

2. Maven settings.xml ファイルを確認して、Red Hat Maven リポジトリーがリポジトリー一覧に含まれていることを確認します。

   注記

   Maven の設定は、本書の対象外となります。

   たとえば、オンラインの Red Hat Maven リポジトリーを Maven settings.xml ファイルに追加します。

   <settings>
     <profiles>
       <profile>
         <id>my-profile</id>
         <activation>
           <activeByDefault>true</activeByDefault>
         </activation>
         <repositories>
           <repository>
             <id>redhat-ga</id>
             <url>http://maven.repository.redhat.com/ga/</url>
             <snapshots>
               <enabled>false</enabled>
             </snapshots>
             <releases>
               <enabled>true</enabled>
             </releases>
           </repository>
           ...
         </repositories>
       </profile>
     </profiles>
     ...
   </settings>

3. Red Hat ライブラリーバージョンを検索して、以下のタスクの 1 つを実行します。

   • オンラインでライブラリーのバージョンを検索する場合には、What is the mapping between Red Hat Process Automation Manager and the Maven library version? を参照してください。
   • オフラインでライブラリーのバージョンを検索するには、business-central.war/META-INF/MANIFEST.MF の Implementation-Version か、kie-server.war/META-INF/MANIFEST.MF の Implementation-Version を確認してください。

4. workitem-home ディレクトリーで、以下のコマンドを実行します。

   $ mvn archetype:generate \
   -DarchetypeGroupId=org.jbpm \
   -DarchetypeArtifactId=jbpm-workitems-archetype \
   -DarchetypeVersion=<redhat-library-version> \
   -Dversion=1.0.0-SNAPSHOT \
   -DgroupId=com.redhat \
   -DartifactId=myworkitem \
   -DclassPrefix=MyWorkItem

   表59.1 パラメーターの説明

   パラメーター	説明
   -DarchetypeGroupId	アーキタイプ固有となるため、変更しないようにしてください。
   -DarchetypeArtifactId	アーキタイプ固有となるため、変更しないようにしてください。
   -DarchetypeVersion	Maven が jbpm-workitems-archetype アーティファクトをダウンロードしようとすると、検索される Red Hat ライブラリーのバージョン
   -Dversion	特定のプロジェクトのバージョン。たとえば、1.0.0-SNAPSHOT です。
   -DgroupId	特定のプロジェクトの Maven グループ。たとえば、com.redhat です。
   -DartifactId	特定のプロジェクトの Maven ID。たとえば、myworkitem です。
   -DclassPrefix	簡単に特定できるように Maven がクラスを生成したときに、Java クラスの最初に追加される文字列。たとえば、MyWorkItem です。

   myworkitem ディレクトリーは、workitem-home ディレクトリーで作成されます。以下に例を示します。

   assembly/
     assembly.xml
   src/
     main/
       java/
         com/
           redhat/
             MyWorkItemWorkItemHandler.java
       repository/
       resources/
     test/
       java/
         com/
           redhat/
             MyWorkItemWorkItemHandlerTest.java
             MyWorkItemWorkItemIntegrationTest.java
       resources/
         com/
           redhat/
   pom.xml

5. pom.xml ファイルに対するワークアイテムハンドラーが必要とする Maven の依存関係を追加します。

6. このプロジェクトのデプロイ可能な JAR を作成するには、pom.xml ファイルが配置されている親プロジェクトのフォルダーで、以下のコマンドを実行します。

   $ mvn clean package

   複数のファイルが target/ ディレクトリーに作成されます。このディレクトリーには主に以下の 2 つのファイルが含まれます。

   表59.2 ファイルの説明

   パラメーター	説明
   myworkitems-<version>.jar	Red Hat Process Automation Manager に直接デプロイする時に使用します。
   myworkitems-<version>.zip	サービスリポジトリーを使用するデプロイメントに使用します。