第3章 Fuse on JBoss EAP の使用

本章では、Fuse on JBoss EAP を紹介し、JBoss EAP コンテナーで初めて Fuse アプリケーションをインストール、開発、およびビルドする方法を説明します。

以下を参照してください。

3.1. Fuse on JBoss EAP

Eclipse Foundation の Jakarta EE の技術 (旧名称 Java EE) をベースとした JBoss Enterprise Application Platform (EAP) は、当初はエンタープライズアプリケーション開発のユースケースに対応するために作成されました。JBoss EAP は、サービスおよび標準化された Java API (永続性、メッセージング、セキュリティーなど) を実装する明確に定義されたパターンを特徴としています。近年ではディペンデンシーインジェクション (依存性の注入) の CDI の導入や、エンタープライズ Java Bean の簡素化されたアノテーションの導入により、この技術はより軽量化されました。

このコンテナー技術の特徴は次のとおりです。

  • 特にスタンドアロンモードでの実行に適しています。
  • 事前設定された多くの標準サービス (永続性、メッセージング、セキュリティーなど) をそのまま使用できます。
  • 通常、アプリケーション WAR は小型および軽量です (多くの依存関係はコンテナーに事前インストールされているため)。
  • 標準化された後方互換性のある Java API。

3.2. Fuse on JBoss EAP のインストール

Red Hat カスタマーポータルから Fuse 7.4 on JBoss EAP の標準インストールパッケージをダウンロードできます。このパッケージは JBoss EAP コンテナーの標準アセンブリーをインストールし、完全な Fuse テクノロジースタックを提供します。

前提条件

手順

  1. 次のように、シェルプロンプトから JBoss EAP インストーラーを実行します。 

    java -jar DOWNLOAD_LOCATION/jboss-eap-7.2.0-installer.jar

  2. インストール中、以下を行います。

    1. 契約条件に同意します。
    2. JBoss EAP ランタイムのインストールパス EAP_INSTALL を選択します。
    3. 管理ユーザーを作成し、後で必要になる管理ユーザーのクレデンシャル情報を注意して書き留めておきます。
    4. 残りの画面では、デフォルト設定を使用できます。
  3. シェルプロンプトを開き、EAP_INSTALL ディレクトリーに移動します。

  4. EAP_INSTALL ディレクトリーから JBoss EAP 7.2 Update 01 を適用します。以下に例を示します。 

    bin/jboss-cli.sh "patch apply jboss-eap-7.2.1-patch.zip"

  5. EAP_INSTALL ディレクトリーから、以下のように Fuse on EAP のインストーラーを実行します。 

    java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.4.0.jar

  6. 以下のように、CodeReady Studio インストーラーを実行します。 

    java -jar DOWNLOAD_LOCATION/codereadystudio-12.12.0.GA-installer-standalone.jar

  7. インストール中、以下を行います。

    1. 契約条件に同意します。
    2. インストールパスを選択します。
    3. Java 8 JVM を選択します。
    4. Select Platforms and Servers ステップで、Add をクリックして EAP_INSTALL ディレクトリーの場所を確認し、JBoss EAP ランタイムを設定します。
    5. Select Additional Features to Install で Red Hat Fuse Tooling を選択します。
  8. CodeReady Studio が起動します。Searching for runtimes ダイアログが表示されたら OK をクリックして JBoss EAP ランタイムを作成します。

  9. (任意手順): コマンドラインから Apache Maven を使用するには、Maven をインストールおよび設定する必要があります。

    注記

    CodeReady Studio のみを使用する場合、CodeReady Studio にはMaven が事前インストールおよび設定されているため、厳密的には Maven をインストールする必要はありません。しかし、コマンドラインから Maven を呼び出す場合は、インストールを行う必要があります。

3.3. JBoss EAP で最初の Fuse アプリケーションをビルド

次の手順は、JBoss EAP で初めて Fuse アプリケーションをビルドする場合に便利です。

前提条件

手順

  1. CodeReady Studio で以下のように新しいプロジェクトを作成します。

    1. File→New→Fuse Integration Project と選択します。
    2. Project Name フィールドに eap-camel を入力します。
    3. Next をクリックします。

    4. Select a Target Environment ペインで以下の設定を選択します。

      • Standalone をデプロイメントプラットフォームとして選択します。
      • Wildfly/Fuse on EAP をランタイム環境として選択し、Runtime (optional) ドロップダウンメニューを使用してJBoss EAP 7.x Runtime サーバーをターゲットランタイムとして選択します。
    5. ターゲットランタイムの選択後、Camel Version が自動的に選択され、フィールドがグレーアウトされます。
    6. Next をクリックします。
    7. Advanced Project Setup ペーンで Spring Bean - Spring DSL テンプレートを選択します。

    8. Finish をクリックします。

      重要

      CodeReady Studio で初めて Fuse プロジェクトをビルドする場合、ウィザードがプロジェクトの生成を完了するまで 数分 かかることがあります。これは、リモート Maven リポジトリーから依存関係をダウンロードするためです。プロジェクトがバックグラウンドでビルドされている間は、ウィザードを中断したり、CodeReady Studio を閉じたりしないでください。

    9. 関連する Fuse Integration パースペクティブを開くように要求された場合は、Yes をクリックします。
    10. CodeReady Studio が必要なアーティファクトをダウンロードし、バックグラウンドでプロジェクトをビルドする間待機します。

  2. 以下のように、プロジェクトをサーバーにデプロイします。

    1. サーバーが起動していない場合は、Servers ビュー (Fuse Integration パースペクティブの左下隅) で Red Hat JBoss EAP 7.2 Runtime サーバーを選択し、緑色の矢印をクリックして起動します。

    2. Console ビューに以下のようなメッセージが表示されるまで待機します。 

      14:47:07,283 INFO  [org.jboss.as] (Controller Boot Thread) WFLYSRV0025: JBoss EAP 7.2.0.GA (WildFly Core 6.0.11.Final-redhat-00001) started in 13948ms - Started 495 of 680 services (326 services are lazy, passive or on-demand)
    3. サーバーが起動した後、Servers ビューに切り替え、サーバーを右クリックしてコンテキストメニューで Add and Remove を選択します。
    4. Add and Remove ダイアログで eap-camel プロジェクトを選択し、Add > をクリックします。
    5. Finish をクリックします。

  3. 以下のように、プロジェクトが動作していることを確認します。

    1. URL http://localhost:8080/camel-test-spring?name=Kermit に移動し、eap-camel プロジェクトで実行されているサービスにアクセスします。
    2. ブラウザーウインドウには、Hello Kermit が応答として表示されるはずです。

  4. 以下のようにプロジェクトをアンデプロイします。

    1. Servers ビューで Red Hat JBoss EAP 7.2 Runtime サーバーを選択します。
    2. サーバーを右クリックし、コンテキストメニューで Add and Remove を選択します。
    3. Add and Remove ダイアログで eap-camel プロジェクトを選択し、< Remove をクリックします。
    4. Finish をクリックします。