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

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

ローカル環境内の WS-Addressing 情報

WS-Addressing ヘッダー情報は、メッセージ・フローから可視のローカル環境ツリーに配置できます。 WS-Addressing ヘッダー情報を処理できるのは SOAP ノードだけです。

インバウンド・メッセージ

SOAP ノードによってインバウンド情報がローカル環境に配置されるのは、ノード上でアドレッシングを採用し、SOAPInputSOAPAsyncResponse、または SOAPRequestノードで「WS-Addressing ヘッダーを LocalEnvironment に配置」プロパティーを選択した場合だけです。

以下の表では、ローカル環境ツリー内にあるノード固有の WS-Addressing 情報について説明しています。

ノード 取り込まれるローカル環境プロパティー
SOAPInput LocalEnvironment.SOAP.Input.WSA.type
SOAPAsyncResponse LocalEnvironment.SOAP.Response.WSA.type
SOAPRequest LocalEnvironment.SOAP.Request.WSA.type

ここで、type はローカル環境 WS-Addressing XML スキーマのサブセクションの構造です。 WS-Addressing 仕様で定義されている WS-Addressing プロパティーとの type のマップについて詳しくは、このトピックの、ローカル環境プロパティー typeセクションを参照してください。

インバウンド・メッセージのローカル環境情報は、ユーザーご自身限定の情報です。 ノードでアドレッシングを採用し、そのノードで「WS-Addressing ヘッダーを LocalEnvironment に配置」プロパティーを選択すると、WS-Addressing 情報を表示して、フローで使用できるようになります。 WS-Addressing プロパティーは、ノードによって処理された後にローカル環境に配置されます。 WS-Addressing フォルダーおよびそのすべての子は XMLNSC パーサーの所有です。このため、XMLNSC パーサーが所有する他のツリーにエレメントを直接コピーできます。 ただし、XMLNSC パーサーが所有していないツリーにこのフォルダー (またはその任意の子) をコピーすると、ターゲット・ツリーで最初に XMLNSC パーサーを作成しない限りはツリー内の情報は破棄されることに注意してください。 例えば、InputLocalEnvironment ツリーから OutputLocalEnvironment ツリーにコピーする場合などに、こうしたことが生じ得ます。

アウトバウンド・メッセージ

アウトバウンド WS-Addressing ヘッダー情報をローカル環境に配置できますが、そうする必要があるのはノードによって自動的に生成されたデフォルトを指定変更する場合だけです。 WS-Addressing がノード上で有効な場合に限って、アウトバウンド・アドレッシング・ヘッダーが作成されます。

以下の表では、ローカル環境ツリー内にあるノード固有の WS-Addressing 情報について説明しています。これを使用して、アウトバウンド・メッセージのデフォルトを指定変更できます。

ノード 取り込まれるローカル環境プロパティー
SOAPReply LocalEnvironment.Destination.SOAP.Reply.WSA.type
SOAPRequest LocalEnvironment.Destination.SOAP.Request.WSA.type
SOAPAsyncRequest LocalEnvironment.Destination.SOAP.Request.WSA.type

ここで、type はローカル環境 WS-Addressing XML スキーマのサブセクションの構造です。 WS-Addressing 仕様で定義されている WS-Addressing プロパティーとの type のマップについて詳しくは、このトピックの、ローカル環境プロパティー typeセクションを参照してください。

アウトバウンド・メッセージのローカル環境情報を変更できます。 SOAPReplySOAPRequest、および SOAPAsyncRequest の各ノードはデフォルトのローカル環境設定を生成します。これは指定変更できます。 この表には 1 つの例外があります。SOAPAsyncRequest ノードで WS-Addressing ReplyTo アドレッシングの指定変更を試行しても無視されます。

例えば、次のコードは、SOAPRequest ノードのローカル環境で WS-Addressing 情報を設定する方法を示します。 WS-Addressing の ReplyTo.Address および FaultTo.Address の値は、改行のない単一ストリングとして入力する必要があります。
	SET OutputRoot = InputRoot;
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.To.Address = 'jms:jndi:INPUTQ';
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.ReplyTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.From.Address = 'jms:jndi:INPUTQ';
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.FaultTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.Action = 'http://WMB_BankImport/NewOperation';
	SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.MessageID = 'test:my:msg:ID:1234578';

ローカル環境プロパティー type

上記の表のローカル環境プロパティー type は、ローカル環境 XML スキーマの WS-Addressing 部分に対応します。 以下の表は、すべてのノードにおける WS-Addressing ローカル環境スキーマの対応するメッセージ・アドレッシング・プロパティー (MAP) を示しています。
エレメント 相当する WS-Addressing MAP 抽象名
To [destination endpoint]
From [source endpoint]
ReplyTo [reply endpoint]
FaultTo [fault endpoint]
Action [action]
MessageId [message id]
RelatesTo [relationship]
ReferenceParameters [reference parameters]
Version このエレメントは MAP に対応しませんが、WS-Addressing のバージョンを識別するために使用されます。 S-Addressing の 2 つの主なバージョンは、Submission および Final です。 すべてのノードで使用されるデフォルトのバージョンは Final です。 ですから、アウトバウンド・メッセージでこのエレメントを設定するのは、バージョンを Submission にする場合だけです。 着信メッセージの場合、このエレメントには、インバウンド・メッセージが使用した WS-Addressing ヘッダーのバージョンが自動的に取り込まれます。

WS-Addressing 仕様によって定義されるメッセージ・アドレッシング・プロパティーの詳細については、WS-Addressingを参照してください。

アウトバウンド WS-Addressing では、追加のローカル環境プロパティーを設定できます。

エレメント 説明
AddMustUnderstandAttribute このエレメントは、メッセージ送信前に、各 WS-Addressing ヘッダーに SOAPmustUnderstand 属性を配置します。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


概念トピック概念トピック | バージョン 8.0.0.5 | ac56600_