ESB Muleプログラマーズの手引き

このページはまだ作成中です。説明が不足しているところや、リンクが切れているところがあります。

始めに

この手引きは、ESB Muleを利用してアプリケーションを効率よく開発するための、手順や実践方法に付いて説明します。

前提条件

このガイドは、ESB Mule, ESB, J2EEの知識があることを前提とします。

ESB Muleに詳しくない場合は、ESB Muleの紹介を参照にしてください。

プログラミング・モデル

プログラミング・モデルをよりよく理解するためと、何を書く必要があり、何を制御することができるのかを分かるには、メッセージを処理するコンポーネントを知ることが最短です。

入力（inbound）メッセージ・フロー・ステージ

入力メッセージ・フローは、トランスポートにメッセージを受信するのを引きかねにして実行されます（例えば、データベースに行が書き込まれた場合やソケットにデータが書き込まれた場合）。ESB Muleトランスポート・プロバイダはデータを受信し、ESB Muleメッセージに包み変えます。入力ルータ（inbound router）は入力メッセージにルーティング・ロジックを適用します（例：Idem potency, 順序制御,バッチ等）。

MuleMessageの作成 ESB MuleMessageは受信したデータの本文を「ペイロード」とし、メッセージ・ヘッダやメタ情報（例：ファイル・トランスポートのファイル名）等の他情報から作成されます。例えば、HttpリクエストのContent-TypeはMuleMessage.getStringProperty("Content-Type", null)で取得でき、JMSPriorityのようなJMSヘッダはMuleMessage.getIntProperty("JMSPriority")で取得することができます。 もし、SOAPやメール・トランスポートのように添付がある場合は、MuleMessageに添付されます。

エンドポイント

エンドポイントはトランスポートからメッセージを受信するのに使われます。エンドポイントはESB Muleがどのようにしてデータを受信して変換するかを定義する構成オブジェクトです。エンドポイントには、エンドポイント・アドレス、トランスポートに特化した構成情報、トランザクション、フィルタなどを設定することができます。エンドポイントの詳細に付いてはESB Muleエンドポインを参照にしてください。

受信ルータ（inbound router）

受信ルータ（inbound router）は、コンポーネントのイベントの受信フローを制御します。受信メッセージのシーケンス番号を再設定をしたり、集約やフィルタすることができます。例えば[IdempotentReceiver]は既に受信したメッセージの再受信を防止します。[CorrelationResequencer]は関連（correlated）イベントを保留し、送信された順序でコンポーネントに引渡します。

コンポーネント・フロー・ステージ

コンポーネントのフローはMuleMessageがモデル（Model：サービス・コンテナ）に渡されたときから開始します。メッセージはサービス（Service）・オブジェクトに渡されますが、渡される前にインターセプタやトランスフォーマーを介すようにメッセージ・フローを設定することができます。

インターセプタ(受信)

インターセプタはサービス・コンポーネントへ送信されたメッセージを傍受します。メッセージの流れを監視したりイベントをトリガーすることができます（例：リクエストにサービスを起動するための権限認証を行う認証インターセプタを作成することができます）。

受信（inbound）トランスフォーマ

受信トランスフォーマは、受信メッセージをトランスポート形式からサービス・コンポーネントが扱える形式に変換します。トランスフォーマはデータ構造変更を行う場合に使うます（例：データ型／形式の変換）。[トランスフォーマ]を連鎖することもできます。

複雑なトランスフォメーション データ項目の追加やデータ一覧の参照等のように外部データ・ソースの参照等を行う高度な変換はトランスフォーマではなく、サービス・コンポーネントで行うことを推奨します。

サービスの呼出し

サービスとはビジネス・ロジックです。サービスはPOJO, EJB, リモート・オブジェクト, その他のオブジェクトで作成することができます。サービス・コンポーネントはESB Muleモデル（Model）でインスタント化することもでき、SpringFramework, Hivemind, JNDI, Pico, Plexusのような外部コンテナで生成・管理することもできます。

サービスの起動

TODO

Callableインタフェースの実装

詳細に付いてはコンポーネントの書き方を参照してください。

インターセプタ (送信)

サービスに設定されたインターセプタがEnvelopeインターセプタ（[org.mule.interceptors.EnvelopeInterceptor]を継承 ）の場合は、コンポーネントの処理が終了した後に after() メソッドが呼ばれます。

送信（outbound）フローステージ

送信メッセージ・フローはサービスから結果メッセージ（サービスを実行した結果）が出力されると開始されます。結果メッセージが無い場合、又は送信ルータ（outbound router）が設定されていない場合は、省略されます。

送信ルータ(outbound router)

送信ルータ（outbound router）は、メッセージを次にどこに行くかを制御します。ESB Muleは
エンタープライズ統合パターンに掲載されているパターンとその他に見たルーティング・パターンを含む標準[送信ルータ]を提供しています。送信ルータ（outbound router）はコンテンツ・バース, Itinerary（ルーティング・スリップ）、動的、ヘッダーとその組み合わせに基づきルーティングを行うことができます。ESB Muleは標準で[MessageSplitting], [Multicasting]とコンテンツ・ベース・ルーティング用のルータを用意しています。

出力トランスフォーマ

TODO

エンドポイント (出力)

送信ルータ（outbound-router）のロジックによっては、イベントが発生されるエンドポイントは０又は数個ある場合があります。

TODO

メッセージとイベント

TODO

UMOEventContext

TODO