WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

EndpointLookup ノード

WebSphere® Service Registry and Repository (WSRR) に保持されているサービス・エンドポイント情報を検索するには、EndpointLookup ノードを使用します。 指定した検索条件に一致するエンティティーがローカル環境に格納されます。 ノード構成によっては、SOAP 要求ノードおよび HTTP 要求ノードが使用する、Web サービスの URL の宛先も設定できます。 入力メッセージは変更されません。

目的

EndpointLookup ノードは、WSDL によって記述された WSRR サービスに関連したサービス・エンドポイント情報を検索します。 WSDL 定義は、指定されたポートで使用可能になっているインターフェース (portType とも呼ばれる) に関するサービスを定義します。 WSDL ポートは、サービスにアクセスするために必要なエンドポイント情報を定義します。 エンドポイントは、ノード・プロパティーによって定義されている検索条件に従って検索されます。また、オプションとして、実行時にローカル環境の定義によって補足または指定変更されます。 詳細については、LocalEnvironment の指定変更を参照してください。

取得されたデータは、ローカル環境のツリーに配置され、後続のノードで使用可能となります。 ノードが受信した入力メッセージは、変更されずに出力端末に伝搬されます。 さらに、EndpointLookup ノードは、「マッチ・ポリシー」プロパティーの値に応じて、後続の SOAPRequestSOAPAsyncRequest、または HTTPRequest ノードが使用する、宛先 URL を自動でセットアップできます。EndpointLookup ノードの処理を参照してください。 これは、これらのノードが使用するローカル環境のオーバーライドを設定するノードによって実行されます。

EndpointLookup ノードの処理

EndpointLookup ノードは、メッセージ・フローのノード・パレットの「Web サービス」ドロワーにあり、WebSphere Message Broker Toolkit では、次のアイコンで表されます。

EndpointLookup ノード・アイコン
EndpointLookup ノードがメッセージを受信すると、次のステップが順に実行されます。
  1. EndpointLookup ノードは、指定した検索条件を使用して、WSRR からサービス・データを検索します。
  2. 一致が 1 つ以上見つかると、EndpointLookup ノードは、これらのエンドポイントの表現をローカル環境ツリーに追加します。
    • 「マッチ・ポリシー」「1」に設定されている場合は、WSRR によってエンティティーが 1 つ返され、ローカル環境ツリーに追加されます。 照会を発行するたびに、返されるエンティティーが異なる場合があります。 さらに、取得されたエンドポイントの値は、SOAPRequestSOAPAsyncRequest、または HTTPRequest の各ノードによって使用される宛先 URL に対し、ローカル環境のオーバーライドとして設定されます。 指定した検索条件に一致するエンティティーがレジストリーに複数登録されている場合は、WSRR からどれが返されるかを決めることはできません。
    • 「マッチ・ポリシー」「すべて」に設定されている場合は、一致するすべてのエンティティーがローカル環境ツリーに追加されます。 エンティティーの順番は WSRR によって決まり、照会ごとに順番が異なる場合があります。 SOAPRequestSOAPAsyncRequest、または HTTPRequest の各ノードが使用する宛先 URL は、設定されません。 代わりに、必要なアドレスを選択し、これらの要求ノードが必要とするローカル環境設定をセットアップするために、Compute ノードをメッセージ・フローに追加する必要があります。

    入力メッセージは、未変更のまま Out ターミナルに伝搬されます。 ローカル環境ツリーは Out ターミナルに伝搬され、変換ノードによる次の処理で使用されます。 ローカル環境の出力ツリーについて詳しくは、EndpointLookup ノード出力を参照してください。

  3. 一致するものが見つからなかった場合、EndpointLookup ノードは、入力メッセージを NoMatch ターミナルに伝搬します。
  4. 処理エラーが発生した場合、(例えば、DefaultWSRR 構成可能サービス・オブジェクトで構成された WSRR サーバーに接続できない、あるいは、接続がタイムアウトするなど)、EndpointLookup ノードは、入力メッセージを未変更のまま Failure ターミナルに伝搬します。 ExceptionList にエラーの詳細が格納されます。

サンプル

このノードの使用法については、以下のサンプルを参照してください。

サンプルに関する情報は、WebSphere Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

LocalEnvironment の指定変更

RegistryLookup ノードのプロパティーは、ローカル環境の設定を使って指定変更できます。 検索条件の動的な定義を参照してください。

ターミナルおよびプロパティー

EndpointLookup ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。

EndpointLookup ノードのターミナルについては、次の表に説明されています。

ターミナル 説明
In ノードが処理するメッセージを受け入れる入力ターミナル。
Failure ノードの処理中にエラーが発生した時のメッセージのルーティング先となる出力ターミナル。
Out 一致したレジストリー・データを含む、未変更の入力メッセージおよび更新されたローカル環境の送信先となる出力ターミナル。
NoMatch 指定の検索条件に基づいて一致するエンティティーが見つからなかった場合の、入力メッセージの送信先となるターミナル。

以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。

EndpointLookup ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
ノード名 いいえ いいえ ノード・タイプ: EndpointLookup ノードの名前。
簡略説明 いいえ いいえ なし ノードの簡単な説明
詳細説明 いいえ いいえ なし メッセージ・フロー内のノードの目的を説明するテキスト

EndpointLookup ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明 mqsiapplybaroverride コマンド・プロパティー
PortType 名 いいえ はい なし WebSphere Service Registry and Repository 定義の WSDL サービスの portType を固有に識別する名前タプル。 少なくとも 1 つのプロパティーが必要です。 3 つのプロパティー値をすべてブランクにすると、保存しようとしたときにエラー・メッセージが 表示されます。 name
PortType ネーム・スペース いいえ はい なし namespace
PortType バージョン いいえ はい なし portVersion
ユーザー・プロパティー いいえ いいえ なし ユーザー定義プロパティーを照会で指定することができます。 「追加」をクリックして、ユーザー・プロパティーを追加します。 ユーザー・プロパティーとは、WSRR 内のエンティティーをカタログするために使用される追加プロパティーのことです。 「プロパティー名」 (大/小文字の区別があり、WSRR 内の追加プロパティーと一致します)、「プロパティー・タイプ」、および「プロパティー値」の各値を入力します。 「プロパティー・タイプ」は、次の値のいずれかです。
  • ストリング (デフォルト)。この場合、「プロパティー値」は、WSRR 内にある追加プロパティーの値と一致する文字ストリングになります。
  • XPATH または ESQL。この場合、「プロパティー値」は、WSRR 内にある追加プロパティーの値と一致する文字ストリングを含む、メッセージ・ツリー内のフィールドを検出する XPath 式または ESQL 式になります。

これらの「ユーザー・プロパティー」および「種別」の各プロパティーは照会で使用し、WSDL のサービス・ポートを一意的に識別します。

 
種別 いいえ いいえ なし

Web オントロジー言語 (OWL) 種別システム・プロパティー。 各種別子が、OWL 内のクラスとなり、URI (Uniform Resource Identifier) を持ちます。 レジストリーで種別を使用すれば、オブジェクトの検索が容易になり、特定のシステムに固有のカスタム・オブジェクトを分かりやすくすることができます。

「追加」をクリックし、OWL 種別の完全修飾 OWL URI を完全に入力して、「種別」を追加します。 例えば、特定のサービス・エンドポイントのライフ・サイクルの状態を定義できます。

これらの「ユーザー・プロパティー」および「種別」の各プロパティーは照会で使用し、WSDL のサービス・ポートを一意的に識別します。

 
マッチ・ポリシー はい いいえ 1 前述のプロパティーで指定した検索条件に一致するエンティティーが WSRR に複数含まれる場合があります。 「マッチ・ポリシー」「1」に設定されている場合は、一致するエンティティーが最大で 1 つ返されます。 「マッチ・ポリシー」「すべて」に設定されている場合は、一致するエンティティーすべてが返されます。 EndpointLookup ノード出力を参照してください。

「マッチ・ポリシー」「1」に設定し、一致するエンティティーを 1 つ要求すると、取得されるエンドポイントの値は、SOAPRequestSOAPAsyncRequest、または HTTPRequest の各ノードが使用する宛先 URL に対し、ローカル環境のオーバーライドとして設定されます。

 
ノードのモニター・プロパティーが、次の表に説明されています。
プロパティー M C デフォルト 説明
イベント いいえ いいえ なし ノードに対して定義したイベントが、このタブに表示されます。 デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 ノードのモニター・イベントを作成、変更、または削除するには、「追加」「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。

「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:46:01


参照トピック参照トピック | バージョン 8.0.0.5 | ac55830_