第2章 従業員勤務表スターターアプリケーションの構築と実行

手順

1. Red Hat Decision Manager 7.1 の Software Downloads ページから rhdm-7.1.0-add-ons.zip ファイルをダウンロードします。
2. ダウンロードしたアーカイブを展開します。
3. アドオンアーカイブから展開した従業員勤務表の zip ファイル (rhdm-7.1.0-employee-rostering.zip) を展開します。

前提条件

1. Java 開発キットをインストールしておく必要があります。
2. Maven をインストールしておく必要があります。
3. ホストにはインターネットアクセスが必要です (外部のリポジトリーから Maven パッケージをダウンロードするため)。

手順

1. ターミナルウィンドウで、sources ディレクトリーに移動します。

2. 以下のコマンドを実行します。

   mvn clean install

   Copy to Clipboard Toggle word wrap
3. ビルドプロセスが完了するまで待ちます。

4. 以下のいずれかの方法を使用して、アプリケーションを実行します。

   1. ビルドプロセスの一部としてデプロイされた WildFly サーバーを実行します。

      1. local/appserver/wildfly-11.0.0-final/standalone/deployments サブディレクトリーで、optashift-employee-rostering-webapp-<version>.war.dodeploy ファイルを作成します。<version> は、同じディレクトリーにある既存の optashift-employee-rostering-webapp-<version>.war シンボリックリンクと同じでなければなりません。
      2. local/appserver/wildfly-11.0.0-final/bin サブディレクトリーで ./standalone.sh コマンドを実行します。
   2. 既存の WildFly または JBoss EAP サーバーに optashift-employee-rostering-webapp/target/optaweb-employee-rostering-*.war ファイルをデプロイして、アプリケーションサーバーを起動します。

   3. 以下のコマンドで、Maven を使用してサーバーを実行します。

      mvn -N wildfly:start wildfly:deploy
      mvn gwt:codeserver

      Copy to Clipboard Toggle word wrap
      注記

      Maven を使用してサーバーを起動した場合には、UI は gwt コードサーバーを使用して gwtui ソースを監視します。このような場合には、gwtui コードを変更すると、コードサーバーで自動的に変更を検出します。gwtui コードの変更には、アプリケーションの再構築は必要ありません。

      後ほど、このサーバーを停止するには、以下のコマンドを使用します。

      mvn -N wildfly:shutdown

      Copy to Clipboard Toggle word wrap
5. http://localhost:8080/gwtui/gwtui.html でアプリケーションにアクセスします。

前提条件

1. Java 開発キットをインストールしておく必要があります。
2. Maven をインストールしておく必要があります。
3. ホストにはインターネットアクセスが必要です (外部のリポジトリーから Maven パッケージをダウンロードするため)。
4. デプロイした WildFly または Red Hat JBoss EAP アプリケーション・サーバーと、MySQL または PostrgeSQL データベースサーバーが必要です。
5. データベースサーバー用に、アプリケーションサーバーで JDBC データソースを設定しておく必要があります。

手順

1. ターミナルウィンドウで、sources ディレクトリーに移動します。

2. 以下のコマンドを実行します。

   mvn clean install  -DproductizedOpenshift -Dorg.optaweb.employeerostering.persistence.datasource=<dsname> -Dorg.optaweb.employeerostering.persistence.dialect=<dialect>

   Copy to Clipboard Toggle word wrap

   上記のコマンドでは、以下の値に置き換えてください。

   • <dsname> は、アプリケーションサーバーのデータソース名に置き換え、

   • <dialect> は、データベースサーバーの種類によって以下の文字列のいずれかに置き換えます。

     • MySQL の場合は org.hibernate.dialect.MySQL5Dialect を、
     • PostgreSQL の場合は org.hibernate.dialect.PostgreSQLDialect を使用します。
3. ビルドプロセスが完了するまで待ちます。
4. optashift-employee-rostering-webapp/target/optaweb-employee-rostering-7.11.1-SNAPSHOT.war ディレクトリーをアプリケーションサーバーにデプロイして、アプリケーションサーバーを起動します。
5. http://localhost:8080/gwtui/gwtui.html でアプリケーションにアクセスします。

前提条件

1. Eclipse をインストールしておく必要があります。
2. ホストにはインターネットアクセスが必要です (外部のリポジトリーから Maven パッケージをダウンロードするため)。
3. 推奨の設定でアプリケーションを実行するには、Google Chrome をインストールしておく必要がありますが、設定を変更して別の Web ブラウザーを使用できます。

手順

1. Eclipse を起動します。
2. メインメニューから File > Import…​ を選択します。
3. Maven > Existing Maven projects ウィザードを選択します。
4. root ディレクトリーでは、アプリケーションソースの root ディレクトリーを選択します。
5. Finish をクリックします。

6. オプションで、Eclipse で多くのエラーが表示されるのを回避するには、以下を行います。

   1. アプリケーションソースの root ディレクトリーで、mvn clean install コマンドを実行して、ビルドが完了するのを待ちます。
   2. Eclipse ナビゲーションツリーで、employee-rostering-shared を右クリックして、Build Path > Configure Build Path…​ を選択します。
   3. Source タブをクリックしてから、Add Folder…​ をクリックします。
   4. employee-rostering-shared/target/generated-sources フォルダーをクリックして、OK をクリックします。
7. メインメニューから Run > External Tools > External Tools Configurations…​ を選択します。

8. Program で以下の起動設定を作成します。

   1. Chrome で OptaWeb 従業員勤務表を開く設定:

      • 名前: Open OptaWeb Employee Rostering in Chrome
      • 場所: /usr/bin/google-chrome
      • 作業ディレクトリー: ${workspace_loc:/employee-rostering}

      • 引数: --incognito http://localhost:8080/gwtui/gwtui.html

        注記

        Chrome の代わりに別のブラウザーを使用する場合には、名前、場所、引数を変更できます。

   2. コードサーバーを終了する設定:

      • 名前: Kill Code Server
      • 場所: /usr/sbin/fuser
      • 作業ディレクトリー: ${workspace_loc:/employee-rostering}
      • 引数: fuser -k 9876/tcp
9. メインメニューから Run > Run Configurations…​ を選択します。

10. Maven Build で以下の起動設定を作成します。

    1. OptaWeb 従業員勤務表のビルド:

       • 名前: OptaWeb Employee Rostering Build
       • ベースのディレクトリー: ${workspace_loc:/employee-rostering}
       • 目標: clean install
       • パラメーター: gwt:skipCompilation Value: true

    2. OptaWeb 従業員勤務表の起動コードサーバー:

       • 名前: OptaWeb Employee Rostering Start Code Server
       • ベースのディレクトリー: ${workspace_loc:/employee-rostering}
       • 目標: gwt:codeserver
       • パラメーター: gwt:skipCompilation Value: true

    3. OptaWeb 従業員勤務表の起動の Webserver:

       • 名前: OptaWeb Employee Rostering Start Webserver
       • ベースのディレクトリー: ${workspace_loc:/employee-rostering}
       • 目標: wildfly:start wildfly:deploy
       • パラメーター: gwt:skipCompilation Value: true

    4. OptaWeb Employee Rostering の停止の Webserver:

       • 名前: OptaWeb Employee Rostering Stop Webserver
       • ベースのディレクトリー: ${workspace_loc:/employee-rostering}
       • 目標: wildfly:shutdown
       • パラメーター: gwt:skipCompilation Value: true

11. Launch Group で、OptaWeb Employee Rostering Run という名前の起動グループを作成し、このグループに以下の起動を追加します。

    • Program::Kill Code Server 起動モード: 継承 起動後のアクション: 中断されるまで待機
    • Maven Build::OptaWeb Employee Rostering Stop Webserver 起動モード: 継承 起動後のアクション: 中断されるまで待機
    • Maven Build::OptaWeb Employee Rostering Build 起動モード: 継承 起動後のアクション: 中断されるまで待機
    • Maven Build::OptaWeb Employee Rostering Start Webserver 起動モード: 継承 起動後のアクション: なし
    • Maven Build::OptaWeb Employee Rostering Start Code server 起動モード: 継承 起動後のアクション: コンソールの出力を待つ (regexp): The code server is ready at
    • Program::Open OptaWeb Employee Rostering in Chrome 起動モード: 継承 起動後のアクション: なし

12. アプリケーションをビルドして実行し、すぐにアクセスするには、OptaWeb Employee Rostering Run 起動グループを実行します。次にアプリケーションを変更して、起動グループに戻り、変更をテストします。

    注記

    この方法を使用してアプリケーションを起動した場合には、UI は gwt コードサーバーを使用して gwtui ソースを監視します。gwtui コードを変更すると、コードサーバーで自動的に変更を検出します。gwtui コードの変更には、アプリケーションの再構築は必要ありません。