ESB ツールリファレンスガイド

1. JBoss Enterprise SOA Platform を設定するには、Window → Preferences → Server → Runtime Environments を選択します。これにより、サーバーランタイム環境を追加、削除、および編集できるサーバーランタイム環境ページが開きます。
2. Add を選択し、ランタイム環境のタイプとして JBoss Enterprise Middleware → JBoss Enterprise Application Platform 5.x Runtime を選択し、Create a new local server ボックスをチェックして Next をクリックします。
3. 次のステップでは、サーバーランタイム環境の名前を指定し、その場所を参照できます。Finish をクリックして、サーバーランタイム環境を追加します。
4. これで、SOA プラットフォームが設定されました。ESB プロジェクトを作成して実行し、設定を確認します。

手順3.1 タスク

1. JBoss Developer スタジオを起動します。
2. メインメニューから Get started with JBoss Central を選択します。
3. メニューから Software/Update を選択します。
4. SOA Tooling Plug-in を選択し、Install をクリックします。
5. インストールの詳細が正しいことを確認し、Next へをクリックしてから、もう一度 Next をクリックします。
6. 使用許諾契約を読んで同意し、Finished をクリックします。
7. JBoss Developer Studio を再起動して、インストールを完了します。

1. Window → Preferences → JBoss Tools → JBoss ESB Runtimes をクリックして、JBoss ESB ランタイムを追加、削除、編集できる JBoss ESB ランタイムページを開きます。

   図3.1 ランタイム

   

   View larger image

   
2. Add を選択して、JBoss ESB ランタイムの場所、名前、およびバージョン番号を指定できるダイアログボックスを開きます。ホームディレクトリーを JBoss AS または SOA-P として指定すると、設定を定義できます。スタンドアロン ESB ランタイムの場所を選択すると、設定は空になり、無視できます。Customize JBoss ESB Runtime jars ボックスをチェックして、ランタイムのライブラリーをカスタマイズすることもできます。
3. 新しい JBoss ESB ランタイムが設定されます。Finish をクリックして設定を終了し、保存します。JBoss ESB プロジェクトの作成時に設定を使用できます。
4. ESB ランタイムがプロジェクト用に設定されている場合、ESB ランタイムのクラスパスコンテナーページを使用して変更できます。これを行うには、Package Explorer ビューに移動し、JBoss ESB Runtime ライブラリーを右クリックします。
5. Properties を選択すると、利用可能なすべての JBoss ESB ランタイムを一覧表示するテーブルが表示されます。
6. ESB プロジェクトに設定するランタイムの 1 つを選択し、OK をクリックします。
7. ESB コンテナーでは、含まれている各 JAR のプロパティーダイアログを介して、ソースと JavaDoc の場所を設定できます。任意の JAR ファイルを右クリックし、Properties を選択します。
8. Java Source Attachment を選択し、選択した JAR ファイルの新しいソースを含む場所 (フォルダー、JAR、または zip) を選択します。これは、推奨されるオプション (ワークスペース、外部フォルダーまたはファイル) のいずれかを使用して行うことができます。パスを手動で入力することもできます。
9. Apply をクリックしてから OK をクリックします。
10. Javadoc の場所を変更するには、Javadoc Location を選択し、Javadoc によって生成されたドキュメントへの URL を指定します。Javadoc の場所には、package-list というファイルが含まれます。
11. Apply をクリックしてから OK をクリックします。

1. メインメニューバーで File → New → Project... を選択して JBoss ESB Project Creation ウィザードを開きます。(サーバーランタイムと ESB ランタイムが JBDS で定義されていることを確認してください。)
2. ダイアログボックスで ESB → ESB Project を選択します。
3. Next をクリックすると、プロジェクト名、ESB バージョン、およびターゲット JBoss ランタイムを指定する JBoss ESB プロジェクトウィザードページに移動します。たとえば、次のように指定します。 helloworld をプロジェクト名として入力し、デフォルトの JBoss ESB バージョンを受け入れます。
4. Next ボタンをクリックしてウィザードの次のステップに進み、ソースフォルダーと出力フォルダーを選択します。
5. Next ボタンをクリックして、ESB コンテンツディレクトリーを表示できる ESB ファセットのインストールウィザードページを表示します。このフォルダーには、ESB アーカイブに必要なほとんどのアーティファクトが含まれています。
6. Server Supplied ESB Runtime を使用して、ESB ライブラリーをプロジェクトに設定できます。プロジェクトにターゲットランタイムセットがあり、このランタイムに ESB ランタイムがインストールされていることを確認してください。
   注記
   JBoss SOA Platform 5.3 以降を使用している場合は、ESB 設定バージョン 1.3.1 を選択します。
7. Finish ボタンをクリックすると、デフォルトの jboss-esb.xml ファイルを含む ESB プロジェクトが作成されます。

1. 注記

   ESB プロジェクトの例を作成すると、完成したプロジェクトがどのように動作するかを観察するのに役立ちます。

   ESB プロジェクト例を作成する前に、 JBoss SOA-P ランタイムを作成します。
2. メインメニューバーで File → New → Other... を選択し、新しいダイアログで Examples → JBoss Tools → Project Examples をクリックします。
3. Next ボタンをクリックすると、リストから ESB プロジェクトの例を選択できるウィザードページが表示されます。
4. すべての ESB サンプルには 2 つのプロジェクトがあります。1 つは ESB プロジェクトで、もう 1 つは ESB プロジェクトのテストに使用される Java プロジェクトです。以下は、すぐに使える例のリストです。各例には、SOA-P サーバーにデプロイされる ESB アプリケーションと、Java アプリケーションとして実行され、デプロイされた ESB アプリケーションと対話するテストクライアントが含まれています。
5. • JBoss ESB HelloWorld の例 - 基本的な ESB コンポーネントを実行し、ESB ランタイムが適切に設定されていることを証明するために必要な最小限のファイルを示します。
   • JBoss ESB HelloWorld アクションの例 - 単一の設定から複数のアクション呼び出しを使用する方法を示します。1 つの Action クラスを使用して複数のメソッド呼び出しを行うか、複数の Action クラスを使用できます。
   • JBoss ESB HelloWorld ファイルアクションの例 - JBoss ESB のファイルゲートウェイ機能の使用方法を示します。特定の拡張子を持つ特定のディレクトリーで見つかったファイルは、処理のためのアクションとともに JMS キューに送信されます。
   • JBoss ESB Web サービスの consumer1 の例 - ESB アクションで JSR181 Web サービスを使用する方法を示します。
   • JBoss ESB Web サービスプロデューサーの例 - SOAPProcessor アクションを使用して JBossESB に JSR181 Web サービスエンドポイントをデプロイする方法を示します。
   • JBoss ESB Smooks CSV -> XML Example - コンマ区切り値 (CSV) ファイルを XML に変換する方法を示します。
   • JBoss ESB Smooks XML -> POJO Example - XML ファイルを Java POJO に変換することで単純な変換を実行する Smooks の使用方法を示します。
   • JBoss ESB Smooks XML -> XML date-manipulation Example - JBoss ESB 内でメッセージ変換を手動で定義および適用する方法を示します。
   • JBoss ESB Smooks XML -> XML Example - JBoss ESB 内でメッセージ変換を手動で定義および適用する方法の非常に基本的な例。非常に単純な XSLT を SampleOrder.xml メッセージに適用し、前後の XML をコンソールに出力します。
6. 関連する ESB プロジェクトの例を選択し、Finish ボタンをクリックします。ESB アプリケーションプロジェクトとテストクライアントプロジェクトが作成されます。

   図3.2 HelloWorld の例

   

   View larger image

   
7. ESB プロジェクトをデプロイし、テストクラスをローカル Java アプリケーションとして実行して、コンソールビューでテスト結果を確認します。

1. ESB プロジェクトをデプロイする前に、Window → Show View → Other → Server → Servers を選択してサーバービューを開きます。
2. サーバービューに ESB ランタイムがインストールされた JBoss サーバーを作成し、起動します。
3. 新しい JBoss サーバーを右クリックし、Add and Remove Projects を選択して、デプロイする ESB プロジェクトを開いているダイアログに追加します。
4. Finish ボタンをクリックして、プロジェクトをサーバーに追加します。ESB プロジェクトを Project Explorer ビューからサーバーにドラッグすることもできます。

1. ESB プロジェクトを JBoss サーバーモジュールリストに追加した後、JBoss サーバーを右クリックし、Publish を選択して、サーバー上でプロジェクトを発行します。デプロイ結果はコンソールビューで確認できます。
2. Run および Debug オプションは ESB プロジェクトで機能し、ユーザーが指定したサーバーの (再) デプロイを引き起こします。
   フィンガータッチボタンをクリックして、サーバーを再起動せずにプロジェクトをすばやく再起動することもできます。

3. エクスポート中

   さらに、ESB プロジェクトを .esb アーカイブとしてデプロイできます。プロジェクトを右クリックし、Export を選択します。
   ESB → ESB File を選択し、Next をクリックします。
   ESB プロジェクトをファイルシステムにエクスポートします。宛先とターゲットランタイムを選択し、アーカイブに適切な設定を行います。最後に、Finish をクリックします。
4. プロジェクトが .esb アーカイブとしてデプロイされました。

1. ESB ファセットが有効になっているプロジェクトを開きます。選択したプロジェクトのメインメニューバーまたはコンテキストメニューで File → New → Other... を選択し、新しいダイアログで ESB → ESB File をクリックします。
2. Next ボタンをクリックすると、フォルダー、名前、およびバージョンを指定するウィザードページが表示されます。たとえば、名前として jboss-esb.xml を選択し、選択したプロジェクトフォルダーとデフォルトバージョンを受け入れます。
   注記
   SOA-P バージョン 5.3 の場合、ESB バージョンは 4.11 で、ESB ファイルスキーマバージョンは 1.3.1 です。古い SOA-P サーバーリリースを使用している場合は、古い ESB ファイルスキーマバージョンもサポートされます。
3. デフォルトでは、選択したプロジェクトのフォルダーにファイルが作成されます。保存先のフォルダーを変更する場合は、Browse をクリックして別の保存先を選択します。
4. Finish をクリックしてファイルを生成します。

1. ESB または Javaプロジェクトを開きます。
2. メインメニューまたはコンテキストプロジェクトメニューから File → New → Other を選択します。次に、新しいダイアログで ESB → ESB Action をクリックします。
3. Next をクリックすると、 New ESB Action クラス名を指定するウィザードが開きます。パッケージを設定したり、インターフェイスを追加したりすることもできます。
4. JBoss ESB 4.9 では、アクションアノテーションの新しいセットが導入されました。アクションアノテーションの新しいセットは、インターフェイスと抽象クラスの実装の複雑さを隠し、ConfigTree タイプを処理することで、クリーンな ESB アクションの実装を簡単に作成できるようにします。これらのアノテーションを使用する場合は、タイプ As annotated POJO を確認してください。それ以外の場合は、タイプ As AbstractActionPipelineProcessor implementation を確認してください。
   アノテーションは次のとおりです。
   • @Process
   • @ConfigProperty
   • @Initialize
   • @Destroy
   • @BodyParam
   • @PropertyParam
   • @AttachmentParam
   • @OnSucess
   • @OnException
5. Finish をクリックして、 ESB Action クラスを作成します。このクラスは ESB Editor ウィザードで利用できるようになります。

1. JBoss ESB エディターには、ツリーとソースの 2 つのビューがあります。エディターの下部にある Source タブを選択してツリービューからソースビューに簡単に切り替え、ソースビューで作業することができます。

   図4.1 ソースビュー

   

   View larger image

   
2. どちらのビューも、アウトラインビューと完全に統合されています。アウトラインビューには、ESB ファイルのツリー構造が表示されます。アウトラインビューで任意の要素を選択すると、ツリー/ソースエディターの同じ場所にジャンプするため、アウトラインビューでソースコードをナビゲートできます。
3. 両方のビューは互いに同期されているため、一方のビューで行われた変更は、すぐにもう一方のビューに反映されます。
4. エディターのツリービューには、すべての ESB アーティファクトがツリー形式で表示されます。任意のノードを選択すると、右側に表示されるそのプロパティーを表示および編集できます。一部のプロパティーは、関連するエディターへのリンクとして表されます。

   図4.2 ツリー表示

   

   View larger image

   
5. 他のファイル (Drools、Groovy、Smooks など) を参照する ESB アクションを編集する場合、フィールドのラベルは、そのファイルの適切なエディターを起動するためのリンクに変わります。
6. 一部のアーティファクト操作の追加、編集、または削除は、ツリービューで直接実行できます。任意のノードを右クリックし、コンテキストメニューで使用可能なアクションの 1 つを選択します。
7. 同じ方法で、または右側にある 追加、編集、および 削除 ボタンのあるフォームを使用して、プロバイダーのチャネルとプロパティーを追加できます。
8. さらに、サービスとその新しいリスナーを追加できます。この方法でフィルターを追加することもできます。

1. 新しいカスタムアクションを ESB XML ファイルに追加するには、JBoss ESB エディターのツリービューに移動します。
2. Services ノードの下の Actions ノードを選択し、右クリックして New → Custom Action を選択します。
   または、 editor の左側にある Add... ボタンをクリックします。
3. ESB アクションウィザードが表示されます。名前と Java クラスを指定します。必要に応じて、アクションのプロセスを指定できます。
4. アクションを作成すると、Actions ノードの下のツリービューに表示されます。左側の Form editor でプレビューと設定の編集ができます。