WSDL を使用してメッセージ・フローを構成できます。
一般に、Web サービスを処理するメッセージ・フローは SOAP ノードを使用します。SOAP ノードの詳細については、WebSphere Message Broker と Web サービスを参照してください。
WSDL モードでは、SOAP ノードを構成するときには、以前にメッセージ・セット内にインポートまたは生成した WSDL (ワークベンチの「デプロイ可能 WSDL」の下に表示される WSDL) を使用します。 WSDL を SOAP ノードの上にドラッグするか、ノードで「WSDL ファイル名」プロパティーを使用して WSDL を指定できます。
SOAP ノードの動作モードを変更して、ゲートウェイ・モードで作動させることができます。 ゲートウェイ・モードでは、ノードを構成するための WSDL は必要ありません。ノードは、特定の WSDL に結合されない汎用要求/応答および片方向 SOAP メッセージを扱うからです。 詳細については、SOAP ノードでのゲートウェイ動作モードを参照してください。
WSDL を SOAP ノードにドラッグしてインポートした場合、ノードのプロパティーは WSDL の address URI のプロパティーから構成されます。SOAP ノードのトランスポート・プロパティーは、WSDL ファイルからインポートした最初のバインディングに基づいて値が設定されます。 つまり、最初にインポートしたバインディングで JMS トランスポートが記述されていれば、JMS トランスポートのプロパティーが設定され、最初にインポートしたバインディングで HTTP トランスポートが記述されていれば、HTTP トランスポートのプロパティーが設定されます。 インポートした別のバインディングを選択すれば、その選択に応じてトランスポート・プロパティーが設定されます。 選択したトランスポートに応じて、異なる portType が表示されます。
WSDL の address エレメント URI は、W3C フォーマットまたは IBM® (非推奨) フォーマットの 2 つの異なるフォーマットで存在する場合があります。 WSDL URI のフォーマットは、パーサーが SOAP のノード・プロパティーの値を取り込むために検索する WSDL プロパティーの名前に影響します。 例えば、IBM スタイルの WSDL をインポートした場合、JNDI コンテキスト・パラメーター表には値が取り込まれません。これは、IBM スタイルの WSDL が WSDL アドレス URI のこれらのプロパティーをサポートしていないからです。JNDI コンテキスト・パラメーターが W3C スタイルの WSDL で記述されている場合にのみ、表に値が取り込まれます。詳細については、JMS の WSDL URI 形式を参照してください。
サービス定義を指定する場合、エンドポイント・プロパティーは自動的に設定されますが、こうしたプロパティーを手動で設定したり指定変更したりもできます。
オプションとして、WSDL 定義は複数のファイルに分割できます。標準的な配置としては、最上位のサービス定義ファイルがバインディング・ファイルをインポートし、バインディング・ファイルはインターフェース・ファイルをインポートし、そのインターフェース・ファイルはスキーマ定義ファイルをインポートまたは組み込みます。
SOAP ノードを構成するには、自身に関する WSDL portType (論理 WSDL インターフェース) だけでは不十分です。実行時に SOAP ペイロードが十分に定義されているようにするために、特定のバインディングが必要です。
バインディングは use を定義しますが、これは document (デフォルト) または rpc が可能です。 use が document の場合には、SOAP ペイロードは WSDL で XML スキーマ・エレメントによって記述されます。use が rpc の場合、SOAP ペイロードは指定されたネームスペース内の WSDL 操作名になります。
独自のメッセージ・フローを作成する場合は、記述どおりにノードを構成してください。 しかし、WSDL 定義をメッセージ・フロー・エディターのブランク・キャンバスにドラッグしてから、特定の WSDL バインディングを選択すると、新しいスケルトン・メッセージ・フローを作成できます。また、フローのタイプ (サービス・プロバイダーまたはコンシューマー)、およびフローによって処理される操作を選択することができます。
生成されたメッセージ・フローでは、主なノードとプロパティーが構成されていますが、そのフローをデプロイする前に、構成を完成させて、その他の必要なノードを追加しなければなりません。 ウィザードを使用して新しい Web サービスを構成する方法について詳しくは、「新規 Web サービス使用法の構成」ウィザードを参照してください。
SOAPReply ノードは、SOAPInput ノードと常に一緒に使用します。 Web サービスの詳細なシナリオについては、Web サービスのシナリオを参照してください。
SOAPAsyncResponse ノードは、「固有 ID」プロパティーで関連付けた SOAPAsyncRequest ノードと常に一緒に使用します。 SOAP ノードの使用パターンについては、Web サービスのシナリオを参照してください。
Web サービス・クライアントは、Web サービスを実装したメッセージ・フローに、?wsdl 照会ストリングを付けて HTTP GET 要求を送信し、サービスのエンドポイントを提供する入力ノードの構成で使用された WSDL の記述を受信できます。 この操作を実行できるのは、JMS トランスポートではなく HTTP トランスポートを使用する入力ノードの場合に限られます。 HTTP GET 要求のプロトコルは、フローのプロトコルと一致していなければなりません。 例えば、フローで SSL を使用していれば、HTTP GET 要求を https:// で始める必要があります。
クライアントは、簡単な ?wsdl 照会を送信して操作を開始し、参照先のインポートまたはインクルードのチェーンをたどって完全な WSDL 定義を取得します。 例えば、Web サービス・エンドポイントが http://localhost:7800/test1 であれば、最初のクライアント要求は、以下のようになります。
GET http://localhost:7800/test1?wsdl
この要求からは、最上位の WSDL サービス定義が返されます。 その定義には、WSDL 定義の他のセクションのインポートが含まれている場合があります。 例えば、返された WSDL に以下の行があるとします。
<wsdl:import ... location="http://localhost:7800/test1?wsdl=wsdl0"/>
その場合、クライアントは、WSDL のそのセクションを取得するために、対応する要求を送信します。
GET http://localhost:7800/test1?wsdl=wsdl0
1 つ以上の WSDL セクションに XML スキーマ・データのインポートが含まれている場合もあります。以下に例を示します。
<xsd:import ... schemaLocation="http://localhost:7800/test1?xsd=xsd0"/>
この場合も、クライアントは、そのデータを取得するために、対応する要求を送信します。
GET http://localhost:7800/test1?xsd=xsd0
返される WSDL 定義は、ツールキットに含まれているデプロイ可能 WSDL からインライン・スキーマを外部化した定義と論理的に同等になります。 物理的には、インポートしたオリジナルの WSDL 定義とは同じでない場合もあります。 SOAPInput が特定の WSDL バインディングで構成されていても、インポートしたオリジナルの WSDL 定義に、フローで使用されない他のバインディングが含まれていれば、返される WSDL にもそれらのバインディングが含まれることになります。