WSDL ドキュメント


WSDL ドキュメントは単なるシンプルな XML ドキュメントです。

それは、ある Web サービスを記述する一連の定義を含みます。


WSDL ドキュメント構造

WSDL ドキュメントは、これらの主要な要素を使用して Web サービスを記述します:

要素 定義
<portType> Web サービスが実行する操作
<message> Web サービスが使用するメッセージ
<types> Web サービスが使用するデータ型
<binding> Web サービスが使用する通信プロトコル

WSDL ドキュメントの主要な構造は次のようになります:

WSDL ドキュメント例

<definitions> <types> data type definitions........ </types> <message> definition of the data being communicated.... </message> <portType> set of operations...... </portType> <binding> protocol and data format specification.... </binding> </definitions>

WSDL ドキュメントは、拡張要素などの他の要素と、複数の Web サービスの定義を単一の WSDL ドキュメントにまとめる service 要素を含むことができます。


WSDL ポート

<portType>要素は最も重要な WSDL 要素です。

それは、Web サービス、実行可能な操作、および関連するメッセージを記述できます。

<portType> 要素は、従来のプログラミング言語における関数ライブラリ(またはモジュール、クラス)に例えることができます。


WSDL メッセージ

<message>要素は操作のデータ要素を定義します。

各メッセージは 1 つ以上のパート(部品)で構成されます。これらのパートは、従来のプログラミング言語における関数呼び出しのパラメーターに例えることができます。


WSDL types

<types>要素は、Web サービスが使用するデータ型を定義します。

最大限のプラットフォーム中立性を実現するため、WSDL は XML Schema 構文を使用してデータ型を定義します。


WSDL Bindings

<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 を持つ関数です。

その他の拡張