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

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

メッセージ・セット: WSDL の生成

ファイルおよび他のオブジェクトは、WSDL 生成プログラムによって作成されます。

このトピックは、メッセージ・モデルを入れるためにメッセージ・セットを使用している場合のみに関係があります。 アプリケーションまたはライブラリーを使用している場合、WSDL エディターを使用して新しい WSDL ファイルを作成できます。

生成されるファイル

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

ファイル ファイル名 ファイル拡張子 WSDL <definitions> エレメントの名前属性の値
サービス・ファイル (単一ファイル形式) Message_Set wsdl <Definition Name>
サービス・ファイル (複数ファイル形式) Message_SetService wsdl <Definition Name>Service
バインディング・ファイル Message_SetBinding 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 定義に適用されます。

エレメント 属性
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_SetPortType
binding name
  • "Message_SetSOAP_HTTP_ Binding"
  • "Message_SetSOAP_JMS_ Binding"
soap:binding style ウィザードで設定されている Style の値。

以下の値は個々の WSDL 操作にそれぞれ適用されます。

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

メッセージ・セット

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

したがって、開発時 (例えば、SOAP ノードの構成時) にブローカー中で使用する WSDL はメッセージ・セットと統合され、通常のスキーマ (xsd) ファイルではなくブローカー・メッセージ定義 (mxsd) を参照します。 この WSDL をデプロイ可能 WSDL と呼び、WebSphere® Message Broker Toolkit中のカテゴリー 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 ツリーの定義。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

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

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


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