第2章 環境の設定

このチュートリアルでは、Fuse Integration プロジェクトを作成するプロセスについて説明します。プロジェクトには、初期ルートとデフォルトの CamelContext が含まれています。ルートは、メッセージが通過するプロセッサーのチェーンです。CamelContext は、ルートを設定するためのコンテキストを定義し、エンドポイント (メッセージソースとターゲット) 間のメッセージエクスチェンジに使用するポリシーを指定する単一のルーティングルールベースです。

他のチュートリアルに従う前に、このチュートリアルを完了する必要があります。

ゴール

このチュートリアルでは、次のタスクを完了します。

  • Fuse Integration プロジェクトを作成する
  • プロジェクトのテストメッセージ (XML ファイル) をダウンロードします
  • テストメッセージを表示する

始める前に

Fuse Integration プロジェクトを設定する前に、Fuse Tooling を使用して Red Hat CodeReady Studio をインストールする必要があります。CodeReady Studio のインストール方法は、Red Hat customer portal にアクセスして、プラットフォームのインストールガイドを参照してください。

次の手順を実行する前に10章プロジェクトを Red Hat Fuse に公開するチュートリアルでは、Java8 をインストールする必要があります。

Fuse Integration プロジェクトの作成

  1. Red Hat CodeReady Studio を開きます。

    CodeReady Studio を初めて起動すると、JBoss パースペクティブで開きます。

    起動時の JBoss パースペクティブ

    それ以外の場合は、前の CodeReady Studio セッションで使用していたパースペクティブで開きます。

  2. メニューから、FileNewFuse Integration Project を選択して、New Fuse Integration Project ウィザードを開きます。

    新規プロジェクトウィザード
  3. Project Name フィールドに ZooOrderApp を入力します。

    Use default workspace location オプションをオンのままにします。

  4. Next をクリックして、Select a Target Runtime ページを開きます。

    ターゲットランタイムページの選択
  5. デプロイメントプラットフォームとしてStandalone を選択します。
  6. Karaf/Fuse on Karaf を選択し、ランタイムに選択されているNone selected を受け入れます。

    注記

    後でランタイムを追加します。10章プロジェクトを Red Hat Fuse に公開するチュートリアル。

  7. デフォルトの Apache Camel version を受け入れます。

    入力されたターゲットランタイムページの選択
  8. Next をクリックして Advanced Project Setup ページを開き、Empty - Blueprint DSL テンプレートを選択します。

    高度なプロジェクト設定
  9. Finish をクリックします。

    Fuse Tooling は、Maven リポジトリーから、プロジェクトのビルドに必要なすべてのファイルのダウンロードを開始し、新しいプロジェクトを Project Explorer ビューに追加します。

    CodeReady Studio がまだ Fuse Integration パースペクティブを表示していない場合は、今すぐ切り替えるかどうかを尋ねられます。

    tutSwitchToFIP
  10. Yes をクリックします。

    新しい ZooOrderApp プロジェクトが Fuse Integration パースペクティブで開きます。

    tutEmptyProjectOpen

    ZooOrderApp プロジェクトには、ルートを作成して実行するために必要なすべてのファイルが含まれています。

    • ZooOrderApp/pom.xml — Maven プロジェクトファイル。

      生成された blueprint.xml および pom.xml ファイル
    • ZooOrderApp/src/main/resources/OSGI-INF/blueprint/blueprint.xml — Camel ルーティングコンテキストと初期の空のルートが含まれる Blueprint XML ファイル。
  11. メインのルーティングコンテキストを表示するには、Editor ビューで blueprint.xml ファイルを開き、Source タブをクリックします。

    tutRouteSource

ID 値を表示するためのコンポーネントラベルの設定

デザインキャンバスに配置するパターンとコンポーネントのラベルが、Tooling チュートリアルに示されているラベルと同じであることを確認するには、次の手順に従います。

  1. エディター設定ページを開きます。

    • Linux および Windows マシンでは、WindowsPreferencesFuse ToolingEditor を選択します。
    • OS X では、CodeReady StudioPreferencesFuse ToolingEditor を選択します。
  2. Use ID values for all component labels オプションをオンにします。

    エディター設定:ID 値オプションの使用
  3. Apply and Close をクリックします。

プロジェクトのテストメッセージをダウンロードする

サンプルの XML メッセージファイルが提供されているので、Tooling チュートリアルを実行しながら ZooOrderApp プロジェクトをテストできます。メッセージには、動物園の動物の注文情報が含まれています。たとえば、シカゴ動物園の 5 頭のウォンバットの注文。

提供されたテストメッセージ (XML ファイル) をダウンロードしてプロジェクトにコピーするには:

  1. CodeReady Studio Project Explorer ビューで、テストメッセージを含むフォルダーを作成します。

    1. ZooOrderApp/src フォルダーを右クリックし、NewFolder を選択します。New Folder ウィザードが開きます。
    2. Folder namedata と入力します。
    3. Finish をクリックします。
  2. こちら をクリックして、提供される Tooling チュートリアルのリソース Fuse-tooling-tutorials-jbds-10.3.zip ファイルの場所に対して Web ブラウザーを開きます。

    Fuse-tooling-tutorials-jbds-10.3.zip ファイルを、ZooOrderApp プロジェクトのワークスペースの外部にある便利な場所にダウンロードし、展開します。1章Fuse Tooling チュートリアルについてで説明されているように、2 つのフォルダーが含まれています。

  3. messages フォルダーから、6 つの XML ファイルを ZooOrderApp プロジェクトの src/data フォルダーにコピーします。

    プロジェクトのデータフォルダー内のメッセージファイル
    注記

    XML ファイルの Warning icon は無視しても問題はありません。

テストメッセージの表示

各 XML メッセージファイルには、動物園 (お客様) からの大量の動物の注文が含まれています。たとえば、message1.xml ファイルには、ブルックリン動物園からの 12 頭のウォンバットの注文が含まれています。

Editor ビューで任意のメッセージ XML ファイルを開いて、コンテンツを調べることができます。

  1. Project Explorer ビューで、メッセージファイルを右クリックします。
  2. ポップアップメニューから Open を選択します。
  3. Source タブをクリックします。

    XML ファイルが Editor ビューで開きます。

    たとえば、message1.xml ファイルの内容には、Brooklyn 動物園からの 12 頭のウォンバットに関する注文が表示されます。

    <?xml version="1.0" encoding="UTF-8"?>
    
    <order>
      <customer>
        <name>Bronx Zoo</name>
        <city>Bronx NY</city>
        <country>USA</country>
      </customer>
      <orderline>
        <animal>wombat</animal>
        <quantity>12</quantity>
      </orderline>
    </order>
注記

新しく作成した message1.xml ファイルの最初の行の Warning icon を無視しても問題はありません。ドキュメントが参照する文法の制約 (DTD または XML スキーマ) がないことを示しています。

次の表に、6 つのメッセージファイルすべての内容の概要を示します。

表2.1 提供されたテストメッセージ

msg#<name><city><country><animal><quantity>

1

ブロンクス動物園

ブロンクス NY

USA

ウォンバット

12

2

サンディエゴ動物園

カリフォルニア州サンディエゴ

USA

キリン

3

3

シーライフセンター

ミュンヘン

ドイツ

ペンギン

15

4

Berlin Zoo

ベルリン

ドイツ

エミュー

6

5

フィラデルフィア動物園

フィラペルフィア PA

USA

キリン

2

6

セントルイス動物園

セントルイス MO

USA

ペンギン

10

次のステップ

CodeReady Studio プロジェクトを設定したので、次の手順 3章ルートの定義XML メッセージを処理するルートを定義するチュートリアルに進むことができます。