Ajax Connector

Ajax アイコン

Ajax Connector は、外部 Web リソースと通信する Ajax サーバーとの間で非同期にメッセージを送受信するためのトランスポートチャネルを作成します。 Ajax​ は ​Asynchronous JavaScript and XML​ の頭字語であり、非同期 Web アプリケーションの作成を容易にする関連テクノロジーのクラスターです。 Ajax Connector は、インバウンドまたはアウトバウンドエンドポイントとして設定できます。

Anypoint Studio では、Ajax Connector は CometD コネクタ​と呼ばれ、Anypoint Studio にあらかじめインストールされています。

Exchange:CometD コネクタ

通常、Ajax エンドポイントは Mule フローを外部 Web ページに接続し、クラウドの任意の場所でユーザーと情報を交換できます。Web ページに接続された JavaScript クライアントはユーザー入力をリスンし、それを処理するフローに Ajax エンドポイントを介して送信します。

通常、Ajax サーバーと Ajax エンドポイントが通信に使用するチャネルは、​「Connector Configuration (コネクタ設定)」​と呼ばれるグローバル要素テンプレートを介して設定されます。

全般設定

Ajax エンドポイントの設定には通常、2 つの手順が必要です。

  1. Ajax エンドポイントを Mule フロー内のどこに配置するかを決定し、それをパレットから Mule フローを設定する一連のプロセッサーの適切な場所にドラッグします。

    1. Ajax エンドポイントをフローの最初に配置すると、​インバウンドエンドポイント​ (アプリケーションの​メッセージソース​) として機能します。

    2. Ajax Connector をフローの途中または最後に配置すると、アウトバウンドエンドポイントとして機能します。

  2. [Message Flow (メッセージフロー)] キャンバスで Ajax アイコンをダブルクリックして Ajax エンドポイントプロパティエディターを開き、そのさまざまなタブの項目に値を入力して、Ajax エンドポイント (およびそのトランスポートチャネルの定義に連動する ​[Connector Configuration (コネクタ設定)]​) を設定します。

図で示しているように、タブを設定します。

[General (一般)] タブ

Studio-ajax-gen
プロパティ 説明

Display Name (表示名)

デフォルトは一般的なエンドポイント名 (この場合は Ajax) です。​Interactive Opinion Poll Connection​ などのエンドポイントの特定のロールを反映させるには、表示名を変更する必要があります。表示名は英数字にする必要があります。

Channel (チャネル)

Ajax エンドポイントがクライアント Web ページと通信するチャネルを指定します。例: /services/echo​。

Connector Configuration (コネクタ設定)

ドロップダウンリストを使用して、このエンドポイント用に以前に設定されたコネクタ設定を選択します。このエンドポイントの種別用のコネクタ設定を作成していない場合、このウィンドウから ​[Add (追加)]​ をクリックして作成できます。以前に作成したグローバル要素を変更するには、​[Edit (編集)]​ をクリックします。

[Advanced (詳細)] タブ

Studio-ajax-outbound-adv
プロパティ 説明

Address (住所)

このエンドポイントのアドレス (​http://localhost:8081/file​ など) を入力します。

Response Timeout (応答タイムアウト)

エンドポイントが応答を待機する必要がある時間 (ミリ秒) を指定します。デフォルトは ​1000​ ミリ秒です。

Encoding (エンコード)

ドロップダウンリストから、メッセージデータに使用する文字セット。(UTF-8 など) を選択します。

Disable Transport Transformer (トランスポートトランスフォーマーを無効化)

エンドポイントのデフォルトの応答トランスポートを​使用しない​場合、このボックスをオンにします。

MIME Type (MIME タイプ)

ドロップダウンリストから、このエンドポイントでサポートされる形式の 1 つを選択します。

Cache Messages (メッセージのキャッシュ)

(アウトバウンド Ajax エンドポイントのみに適用)​ディスパッチャーがメッセージをキャッシュできるようにするには、このボックスをオンにします。メッセージは、クライアントがチャネルにサブスクライブしていない場合にのみキャッシュされます。

Message Cache Size (メッセージキャッシュサイズ)

(アウトバウンド Ajax エンドポイントのみに適用)​[Cache Messages (メッセージのキャッシュ)] を有効にしてから、キャッシュサイズを選択します。デフォルトのキャッシュサイズは 1024 です。

Connector Endpoint (コネクタエンドポイント)

ドロップダウンリストを使用して、以前に設定されたグローバルエンドポイントテンプレートを選択します (存在する場合)。このエンドポイントの種別用のグローバル要素を作成していない場合、​[Add (追加)]​ をクリックして、表示されるペインの項目に入力します。以前に作成したグローバル要素を変更するには、​[Edit (編集)]​ をクリックします。

Enable default events tracking (デフォルトイベント追跡を有効化)

このエンドポイントのデフォルト​ビジネスイベント​追跡を有効にします。

[Transformers (トランスフォーマー)] タブ

Studio-ajax-trans
項目 説明

Transformers References: Request (トランスフォーマーリファレンス: 要求)

トランスポートに送信される前に要求に適用される同期トランスフォーマーのリストを入力します。

関連情報

  • XML エディターを使用して Ajax エンドポイントのプロパティを設定する方法についての詳細は、Mule Runtime ドキュメントの​「Ajax トランスポートリファレンス」​の説明を参照してください。