メッセージ・フロー内のノードを構成することにより、サポートされる 1 つ以上のプログラミング・インターフェースを使用してこれらのノードの動作をカスタマイズできます。
メッセージ・フローにおけるメッセージ形式の変換には、以下のオプションのいずれかを使用できます。
- マッピング
- WebSphere® Message Broker Toolkit の
メッセージ・マッピング・エディターは、メッセージをビジュアル表示するグラフィカル・インターフェースです。 このエディターを使用して、以下の操作を実行できます。
- ソース・メッセージからターゲット・メッセージへフィールドをドラッグする
- データベースからメッセージ構造にデータをマップする
- 関数を適用する
マッピングは、DataDelete、DataInsert、DataUpdate、Mapping、および Warehouse ノードで使用できます。
このオプションは、行う変換が複雑でない場合、またはプログラミング言語を使用したくない場合に使用します。
- ESQL
- ESQL を使用して、メッセージとデータベース表の両方のデータを操作します。
ESQL は、WebSphere Message Broker の固有のプログラミング言語であり、SQL が基盤になっています。 ESQL ステートメントをコーディングすることにより、メッセージ・フィールドとデータベース内容を作成、参照、更新できます。 ESQL には、複雑な変換を実現するために使用できるステートメントと関数が豊富に揃っています。
ESQL は、Compute、Database、および Filter ノードで使用できます。
このオプションは、行う変換が複雑であり、かつメッセージ・フローの設計者がプロシージャー型プログラミング言語に精通している場合に使用します。
- Java
- Java プログラミング言語を使用して、メッセージをルーティングまたは変換します。 XPath を使用してメッセージ・フィールドを作成、参照、更新できます。 JDBC を使用してデータベース表にアクセスすることもできます。
Java は JavaCompute ノードでのみ使用できます。
このオプションは、メッセージ・フローの設計者が Java プログラミング言語に精通している場合に使用します。
- XSL スタイル・シート
- 標準 XSL スタイル・シートを使用して、XML メッセージをブローカーがサポートする他の形式に変換します。
XSL は XSLTransform ノードでのみ使用できます。
このオプションは、メッセージ・フローが XML メッセージを処理し、かつメッセージ・フローの設計者が XSL スタイル・シートに精通している場合に使用します。
- PHP
- PHP プログラミング言語を使用して、メッセージをルーティングまたは変換します。
PHP を使用してメッセージ・フィールドを作成、参照、更新できます。
PHP は PHPCompute ノードでのみ使用できます。
このオプションは、メッセージ・フローの設計者が PHP スクリプトとプログラミング言語に精通している場合に使用します。
メッセージ・フローとノードを構成するときに、ワークスペースに保管される一連のファイルを作成します。
作成されるファイルは、以下のタイプです。
- メッセージ・フロー定義ファイル <message_flow_name>.msgflow。
このファイルは必須であり、自動的に作成されます。 このファイルには、メッセージ・フローの特性と内容についての詳細 (例えば、含まれるノードとプロモートされるプロパティー) が含まれます。
- 1 つ以上のメッセージ・マッピング・ファイル <message_flow_name><_nodename>.msgmap。
メッセージ・マッピング・エディターを使用するメッセージ・フローでは、各ノードごとに固有ファイルが必要になります。 このファイルは、マッピングを使用してカスタマイズ可能なノードがメッセージ・フローに 1 つ以上含まれている場合のみ必要です。 このファイルを自分で作成することも、またはノードに対して特定のアクションを要求することにより
作成されるようにすることもできます。
入力値が出力値にマップされる方法を指定することにより、以下の組み込みノードをカスタマイズすることができます。
| ノード |
使用法 |
| DataDelete ノード |
このノードは、出力メッセージを作成せずにデータベース表から 1 つ以上の行を削除するために使用します。 |
| DataInsert ノード |
このノードは、出力メッセージを作成せずにデータベース表に 1 つ以上の行を挿入するために使用します。 |
| DataUpdate ノード |
このノードは、出力メッセージを作成せずにデータベース表の 1 つ以上の行を更新するために使用します。 |
| Mapping ノード |
このノードは、出力メッセージを構成し、入力メッセージから変更したかデータベースから取得した新しい情報を取り込むために使用します。 Mapping ノードを使用して、データベース表の行を更新、挿入、または削除することもできます。 |
| Warehouse ノード |
このノードは、出力メッセージを作成せずにデータベース表にメッセージの全部または一部を格納するために使用します。 |
組み込み ESQL 関数およびステートメントを使用して、メッセージ・マッピングを定義することもできますし、独自の ESQL 関数を使用することもできます。
また、Extract ノードは、マッピングを使用して、入力メッセージの内容のサブセットを含む出力メッセージを作成します。
ただし Extract ノードは、WebSphere Message
Broker バージョン 6.0 およびそれ以降のリリースでは使用すべきではなくなりました。 Extract ノードのあるメッセージ・フローは WebSphere Message
Broker バージョン 6.0 でも引き続き有効ですが、メッセージ・フローを再設計して Extract ノードを Mapping ノードに置き換え、新しい機能拡張を利用できるようにしてください。
- 1 つ以上の ESQL リソース・ファイル <message_flow_name>.esql。
ESQL ファイルが必要となるのは、ESQL モジュールを使用してカスタマイズしなければならないノードがメッセージ・フローに 1 つ以上含まれる場合、またはメッセージ・マッピングによって呼び出される関数がメッセージ・フローに含まれる場合のみです。 このファイルを自分で作成することも、またはノードに対して特定のアクションを要求することにより
作成されるようにすることもできます。
組み込み ESQL ステートメントや関数、およびユーザー定義関数を使用する、フリー・フォームの ESQL ステートメントを作成することにより、以下の組み込みノードをカスタマイズすることができます。
- 1 つ以上の Java プログラミング・ファイル <message_flow_name>.java。 Java ファイルが必要となるのは、メッセージ・フローに JavaCompute ノードが 1 つ以上含まれる場合のみです。 このファイルを自分で作成することも、またはノードに対して特定のアクションを要求することにより
作成されるようにすることもできます。
- 1 つ以上の XSL スタイルシート <message_flow_name>.xslt。
XSLT ファイルが必要となるのは、メッセージ・フローに XSLTransform ノードが 1 つ以上含まれる場合のみです。
このファイルを自分で作成することも、またはノードに対して特定のアクションを要求することにより
作成されるようにすることもできます。
- 1 つ以上の PHP スクリプト <message_flow_name>.php。
PHP スクリプト・ファイルが必要となるのは、メッセージ・フローに PHPCompute ノードが 1 つ以上含まれる場合のみです。
このファイルを自分で作成することも、またはノードに対して特定のアクションを要求することにより
作成されるようにすることもできます。
メッセージ・フロー・プロジェクトに他のファイルを組み込むことにより、それをメッセージ・フローとともにブローカーにデプロイできます。 ブローカーはこれらの特別ファイルを保管しますが、それを処理することはありません。
これらの変換オプションをサポートするファイルを作成してその内容を作成する方法についての詳細は、メッセージの変換と拡充を参照してください。