WSDL の生成

このトピックでは、WSDL 生成プログラムによって作成されるオブジェクトを定義します。

生成されるファイル

以下の表に、デフォルトのファイルおよび定義エレメント名が示されています。 <Message Set> は、提供されたメッセージ・セット名で、<Definition Name> は、ウィザードによって送信請求される提供された定義名です。

変更の始まり
表 1. WSDL ファイル名規則
ファイル ファイル名 ファイル拡張子 WSDL <definitions> エレメントの名前属性の値
サービス・ファイル (単一ファイル形式) <Message Set> wsdl <Definition Name>
サービス・ファイル (複数ファイル形式) <Message Set>Service wsdl <Definition Name>Service
バインディング・ファイル <Message Set>Binding wsdl <Definition Name>Binding
インターフェース・ファイル <Message Set> wsdl <Definition Name>
変更の終わり

変更の始まり'Deployable WSDL' が生成される場合は、追加の XML スキーマ (xsd) ファイルは生成されず、WSDL は直接ブローカー・メッセージ定義 (mxsd) ファイルを参照します。生成されない場合は、'inline schema' を選択していなければ、別個の XML スキーマ (xsd) ファイルが生成されます。変更の終わり

レポート・ファイル

WSDL 生成プログラムは、生成操作の結果をレポート・ファイルに追加し、発生したエラーがあればリストします。 ファイル名は次のとおりです。

<Message Set>.wsdlgen.report.txt

WSDL の内容

以下の表は、生成された WSDL で設定されるエレメント / 属性の値を示しています。 エレメントは、従来の配列の WSDL 文書で出現するとおりに、上から順に説明されます。 WSDL 定義の <schema> セクションは、ブローカー・メッセージ定義に直接対応するため、ここには示されません。

エレメント名は WSDL 1.1 ネーム・スペースからですが、WSDL SOAP ネーム・スペースで接頭部に soap: が付いているものは除きます。 Operation エレメントは binding セクションと portType セクションの両方にあるため、必要に応じて operation で修飾されます (例えば、portType / operation)。

以下の値は、全体として WSDL 定義に適用されます。

表 2. WSDL オブジェクト
エレメント 属性
definitions xmlns ネーム・スペース接頭部を割り当てます。
変更の始まりdefinitions変更の終わり 変更の始まりtargetNamespace変更の終わり 変更の始まりこれはウィザードによって送信請求される WSDL ネーム・スペースで、デフォルトは http://tempuri.org/<Message Set> です。変更の終わり
変更の始まりmessage変更の終わり 変更の始まりname変更の終わり 変更の始まり<operation>_<role>。ここで、<operation> は操作名で、<role> は、in、out、または fault です。変更の終わり
part name ブローカー・メッセージの名前。Stylerpc に設定されている場合、本体部分は type 属性を使用して定義されます。そうでない場合、本体部分は element 属性を使用して定義されます。
変更の始まりportType変更の終わり 変更の始まりname変更の終わり 変更の始まり<Message Set>PortType変更の終わり
binding name
  • ”<Message Set>SOAP_HTTP_ Binding”
  • ”<Message Set>SOAP_JMS_ Binding”
変更の始まりsoap:binding変更の終わり 変更の始まりstyle変更の終わり 変更の始まりウィザードで設定されている Style の値。変更の終わり

変更の始まり以下の値は個々の WSDL 操作にそれぞれ適用されます。変更の終わり

表 3. WSDL <operation> オブジェクト
エレメント 属性
operation name ウィザードで指定されている操作の名前。
soap:operation style ウィザードで設定されている Style の値。
input、output、fault name <operation>_<role>。ここで、<operation> は操作名で、<role> は、Input、Output、または Fault です。
soap:body ネーム・スペース
  • Stylerpc に設定されている場合、対応するブローカー・メッセージのネーム・スペースになります。
  • Styledocument に設定されている場合、属性は生成されません。
soap:header、soap:fault、soap:body use これは literal に設定されます。
変更の始まり

メッセージ・セット

メッセージ・セットは、多数の重要なブローカー・フィーチャーの基礎を提供します。その中には、開発時のマッピング・サポートとコード完了や、実行時の妥当性検査が含まれます。

したがって、開発時 (例えば、SOAP ノードの構成時) にブローカー中で使用する WSDL はメッセージ・セットと統合され、通常のスキーマ (xsd) ファイルではなくブローカー・メッセージ定義 (mxsd) を参照します。この WSDL をデプロイ可能 WSDL と呼び、ワークベンチ中のカテゴリー Deployable WSDL の下に表示されます。

デプロイ可能 WSDL は、WSDL の宛先ディレクトリーとして Message Set Folder (Message Set Project の直接の子) を指定すると生成されます。

指定しないと、正規の WSDL ファイルが生成され、要求された場合は別個の XML スキーマ (xsd) ファイルも生成されます。正規の WSDL は、SOAP ノードの構成には使用できませんが、.NET などの外部アプリケーションで使用するには適しています。

メッセージ・フロー中で使用するデプロイ可能 WSDL を生成すると想定すると、 通常フローはこの WSDL によって記述される実行時 SOAP メッセージを構文解析して妥当性検査できる必要があります。したがって、WSDL 生成プログラムは、追加の定義をメッセージ・セットに追加します。
  • RPC スタイルの WSDL の場合、WSDL 操作自体に関する追加定義がメッセージ・セットに追加されます。
  • WSDL で使用される SOAP エンベロープのバージョンの場合、mxsd ファイルが追加されます。このファイルは soapenv11.mxsd または soapenv12.mxsd になります。
  • 主に ESQL コンテンツ・アシストおよびマッピング・エディターで使用する場合、SOAP_Domain_Msg ツリーの定義。
変更の終わり
関連概念
メッセージのモデル化
メッセージ・モデル
関連タスク
メッセージ・モデルの開発
メッセージ定義ファイルの処理
メッセージ・モデル・オブジェクトの処理
メッセージ・セットからの WSDL 定義の生成
関連資料
メッセージ・モデルの参照情報
メッセージ・モデル・オブジェクトのプロパティー
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:43:23

ad15761_