WSDL ドキュメント
WSDLドキュメントは単なるXMLドキュメントに過ぎません。
これは特定のウェブサービスを描述する定義のセットを含んでいます。
WSDLドキュメント構造
WSDLドキュメントは、これらの主要な要素を使用して特定のウェブサービスを記述します:
要素 | 定義 |
---|---|
<portType> | ウェブサービスが実行する操作 |
<message> | ウェブサービスが使用するメッセージ |
<types> | ウェブサービスが使用するデータ型 |
<binding> | ウェブサービスが使用する通信プロトコル |
WSDLドキュメントの主要な構造は以下のようになります:
<definitions> <types> データ型の定義... </types> <message> メッセージの定義... </message> <portType> ポートの定義... </portType> <binding> バインディングの定義... </binding> </definitions>
WSDLドキュメントには、extension要素やservice要素など、他の要素を含むことができます。このservice要素は、複数のウェブサービスの定義を1つのWSDLドキュメントにまとめることができます。
完全な文法の概要については、以下のURLにアクセスしてください WSDL 语法 このセクション。
WSDL ポート
<portType> 要素は最も重要なWSDL要素です。
ウェブサービス、実行可能な操作、および関連するメッセージを記述できます。
<portType>要素は、伝統的なプログラミング言語のライブラリ(またはモジュール、またはクラス)に例えられます。
WSDL メッセージ
<message> 操作のデータ要素を定義する要素です。
各メッセージは1つまたは複数の部品で構成されています。これらの部品は、伝統的なプログラミング言語の関数呼び出しの引数に例えられます。
WSDLのデータ型
<types> ウェブサービスが使用するデータ型を定義する要素です。
最大限のプラットフォームの中立性を確保するために、WSDLはXMLスキーマ文法を使用してデータ型を定義します。
WSDL バインディング
<binding> 各ポートにメッセージの形式とプロトコルの詳細を定義します。
WSDL インスタンス
これは某个 WSDL ドキュメントの簡略化された部分です:
<message name="getTermRequest"> <part name="term" type="xs:string"/> </message> <message name="getTermResponse"> <part name="value" type="xs:string"/> </message> <portType name="glossaryTerms"> <operation name="getTerm"> <input message="getTermRequest"/> <output message="getTermResponse"/> </operation> </portType>
この例では、<portType> 要素は「glossaryTerms」を特定のポートの名前、「getTerm」を特定の操作の名前を持っています。
操作「getTerm」は「getTermRequest」と呼ばれる入力メッセージ、および「getTermResponse」と呼ばれる出力メッセージ。
<message> 要素は各メッセージを定義するコンポーネントおよび関連するデータタイプです。
伝統的なプログラミングと比較して、glossaryTerms はライブラリであり、「getTerm」は「getTermRequest」入力パラメータと「getTermResponse」返却パラメータを持つ関数です。