Web サービス記述言語

Web サービス記述言語
ファイル名拡張子	.wsdl
インターネットメディアの種類	アプリケーション/wsdl+xml
開発者	ワールドワイドウェブコンソーシアム
含まれるもの	テキスト
標準	2.0 推奨事項

Web サービス記述言語( WSDL / ˈ w ɪ z d əl / )は、 Web サービスが提供する機能を記述するために使用されるXMLベースのインターフェイス記述言語です。^[^要出典^{]この頭字語は、Web サービスの特定の WSDL 記述 (}WSDL ファイルとも呼ばれます) にも使用され、サービスの呼び出し方法、サービスが期待するパラメーター、およびサービスが返すデータ構造について、機械可読な記述を提供します。したがって、その目的は、プログラミング言語の型署名の目的とほぼ同じです。

2007 年に W3C 勧告となった WSDL の最新バージョンは WSDL 2.0 です。頭字語の意味は、バージョン 1.1 の「D」が「定義」を表していたものから変更されました。

説明

WSDL は、サービスをネットワークエンドポイント、つまりポートのコレクションとして記述します。WSDL 仕様では、この目的のためにドキュメントのXML 形式を提供しています。ポートとメッセージの抽象的な定義は、具体的な使用法やインスタンスから分離されているため、これらの定義を再利用できます。ポートは、ネットワークアドレスを再利用可能なバインディングに関連付けることで定義され、ポートのコレクションはサービスを定義します。メッセージは、交換されるデータの抽象的な記述であり、ポートタイプは、サポートされている操作の抽象的なコレクションです。特定のポートタイプの具体的なプロトコルとデータ形式の仕様は、再利用可能なバインディングを構成し、そこで操作とメッセージが具体的なネットワークプロトコルとメッセージ形式にバインドされます。このように、WSDL は Web サービスへのパブリックインターフェイスを記述します。

WSDL は、インターネット経由で Web サービスを提供するために、SOAPおよびXML スキーマと組み合わせて使用されることがよくあります。Web サービスに接続するクライアントプログラムは、WSDL ファイルを読み取って、サーバー上で使用できる操作を判断できます。使用される特別なデータ型は、XML スキーマの形式で WSDL ファイルに埋め込まれます。クライアントは、たとえば HTTP経由の XML を使用して、SOAP を使用して WSDL ファイルにリストされている操作の 1 つを実際に呼び出すことができます。

仕様の現在のバージョンは2.0です。バージョン1.1はW3Cによって承認されていませんが、バージョン2.0はW3C勧告です。^[1] WSDL 1.2はWSDL 1.1と大幅に異なるため、WSDL 2.0に改名されました。すべてのHTTPリクエストメソッド（バージョン1.1のGETとPOSTだけでなく）へのバインディングを受け入れることにより、WSDL 2.0仕様はRESTful Webサービスのサポートが向上し、実装がはるかに簡単になりました。^[2]^{[3]ただし、Webサービス用の}ソフトウェア開発キットでは、この仕様のサポートがまだ不十分で、多くの場合、WSDL 1.1用のツールしか提供されていません。^{[更新が必要]}^{[引用が必要]}たとえば、ビジネスプロセス実行言語（BPEL）のバージョン2.0は、WSDL 1.1のみをサポートしています。

WSDLファイルの例

<?xml version="1.0" encoding="UTF-8"?> 
<description xmlns= "http://www.w3.org/ns/wsdl" xmlns:tns= "http://www.tmsws.com/wsdl20sample" xmlns:whttp= "http://schemas.xmlsoap.org/wsdl/http/" xmlns:wsoap= "http://schemas.xmlsoap.org/wsdl/soap/" targetNamespace= "http://www.tmsws.com/wsdl20sample" >  
              
             
             
             

<documentation>
    これはサンプルのWSDL 2.0ドキュメント です。</documentation>      


<!-- 抽象型 --> 
<types> <xs:schema xmlns:xs= "http://www.w3.org/2001/XMLSchema" xmlns= "http://www.tmsws.com/wsdl20sample" targetNamespace= "http://www.example.com/wsdl20sample" > <xs:element name= "request" > ... </xs:element> <xs:element name= "response" > ... </xs:element> </xs:schema> </types>   
       
                
                
                 
            
            
      
   

<!-- 抽象インターフェース --> 
<インターフェース名= "Interface1" > <障害名= "Error1"要素= "tns:response" /> <操作名= "Get"パターン= "http://www.w3.org/ns/wsdl/in-out" > <入力メッセージラベル= "In"要素= "tns:request" /> <出力メッセージラベル= "Out"要素= "tns:response" /> </操作> </インターフェース>    
        
        
           
           
      
   

<!-- HTTP 経由の具体的なバインディング --> 
<binding name= "HttpBinding" interface= "tns:Interface1" type= "http://www.w3.org/ns/wsdl/http" > <operation ref= "tns:Get" whttp:method= "GET" /> </binding> <!-- SOAP を使用した具体的なバインディング --> <binding name= "SoapBinding" interface= "tns:Interface1" type= "http://www.w3.org/ns/wsdl/soap" wsoap:protocol= "http://www.w3.org/2003/05/soap/bindings/HTTP/" wsoap:mepDefault= "http://www.w3.org/2003/05/soap/mep/request-response" > <operation ref= "tns:Get" /> </binding>      
            
        
   
   

      
             
            
            
        
   

<!-- 両方のバインディングのエンドポイントを提供する Web サービス --> 
<service name= "Service1" interface= "tns:Interface1" > <endpoint name= "HttpEndpoint" binding= "tns:HttpBinding" address= "http://www.example.com/rest/" /> <endpoint name= "SoapEndpoint" binding= "tns:SoapBinding" address= "http://www.example.com/soap/" /> </service> </description>

歴史

WSDL 1.0 (2000 年 9 月) は、IBM、Microsoft、およびAribaによって、SOAP ツールキットの Web サービスを記述するために開発されました。これは、IBM の NASSSL (Network Application Service Specific Language) と Microsoft の SDL (Service Description Language) という 2 つのサービス記述言語を組み合わせて構築されました。

2001 年 3 月に公開された WSDL 1.1 は、WSDL 1.0 の正式版です。1.0 と 1.1 の間に大きな変更は加えられていません。

WSDL 1.2 (2003 年 6 月) は W3C の作業草案でしたが、WSDL 2.0 になりました。W3C によると、WSDL 1.2 は開発者にとって以前のバージョンよりも簡単で柔軟性があります。WSDL 1.2 は相互運用性のない機能の削除を試みており、HTTP 1.1 バインディングもより適切に定義しています。WSDL 1.2 はほとんどの SOAP サーバー/ベンダーではサポートされていませんでした。

WSDL 2.0 は 2007 年 6 月に W3C 勧告になりました。WSDL 1.2 は WSDL 1.1 と大幅に異なるため、WSDL 2.0 に名前が変更されました。変更点は次のとおりです。

記述言語にさらなるセマンティクスを追加
削除されたメッセージ構造
演算子のオーバーロードはサポートされていません
PortTypes がインターフェースに名前変更されました
ポートがエンドポイントに名前変更されました

サブセットWSDL

サブセットWSDL（SWSDL）^[4]は、元のWSDLのサブセット操作を含むWSDLです。開発者はSWSDLを使用してサブセットサービスにアクセスし、Webサービスコードのサブセットを処理できます。サブセットWSDLは、Webサービスのテストとトップダウン開発に使用できます。サブセットWSDLを使用してサブセットサービスにアクセスし、Webサービスをスライスできます。サブセットサービスは、SWSDLを使用してレイヤーに分類できます。SWSDLは、Webサービスの分析、テスト、トップダウン開発に使用されます。AWSCM ^[5]は、WSDLファイル内のサブセット操作を識別してサブセットWSDLを構築できるツールです。

セキュリティに関する考慮事項

WSDLファイルはWebサービスを記述するためのXMLベースの仕様であるため、攻撃を受けやすい。^[6] これらのファイルの脆弱性を軽減するために、生成されたWSDLファイルへのアクセスを制限し、WSDL定義に適切なアクセス制限を設定し、Webサービスで不要な定義を避けることが推奨される。

参照

参考文献

^ 「Web サービス定義言語 (WSDL) バージョン 2.0 パート 1: コア言語」。2007 年 6 月 27 日閲覧。
^ 「Web サービス定義言語 (WSDL) バージョン 2.0 パート 2: 補助機能」。
^ 「WITW WSDL 2.0 HTTP バインディング」。2012 年 6 月 20 日時点のオリジナルよりアーカイブ。2007 年 9 月 20 日閲覧。
^ Chaturvedi, Animesh (2014)。分析のためにサブセットサービスにアクセスするためのサブセット WSDL。2014 IEEE 6th International Conference on Cloud Computing Technology and Science。p. 688。doi :10.1109/ CloudCom.2014.149。ISBN 978-1-4799-4093-6。
^ Chaturvedi, Animesh (2014).自動 Web サービス変更管理 AWSCM - ツール。2014 IEEE 第 6 回国際クラウドコンピューティング技術および科学会議。p. 715。doi :10.1109/ CloudCom.2014.144。ISBN 978-1-4799-4093-6。
^ 「WSDL 開示」。2017年 5 月 31 日閲覧。

外部リンク

WSDL 1.0 仕様
WSDL 1.1 仕様
WSDL 2.0 仕様
- パート 0: 入門 (最新バージョン)
- パート 1: コア (最新バージョン)
- パート 2: 補助語 (最新バージョン)
Web サービス記述ワーキンググループ
XMLプロトコルアクティビティ
JSR-110: WSDL 用 Java API
JSR 172: Java ME Web サービス仕様
オンライン WSDL バリデーター
WSDL Java バインディングは、XMLBeans および JAXB のWayback Machineで 2009-04-11 にアーカイブされています。
RELAX-WS: RELAX NG Compact Syntax に基づくシンプルな Web サービス定義言語
Kevin Liu. WSDL 2.0 の概要。アクセス日: 2010 年 4 月 20 日。

[1] 「Web サービス定義言語 (WSDL) バージョン 2.0 パート 1: コア言語」。2007 年 6 月 27 日閲覧。

[2] 「Web サービス定義言語 (WSDL) バージョン 2.0 パート 2: 補助機能」。

[3] 「WITW WSDL 2.0 HTTP バインディング」。2012 年 6 月 20 日時点のオリジナルよりアーカイブ。2007 年 9 月 20 日閲覧。

[SWSDL-4] ^ Chaturvedi, Animesh (2014)。分析のためにサブセットサービスにアクセスするためのサブセット WSDL。2014 IEEE 6th International Conference on Cloud Computing Technology and Science。p. 688。doi :10.1109/ CloudCom.2014.149。ISBN 978-1-4799-4093-6。

[AWSCM-5] ^ Chaturvedi, Animesh (2014).自動 Web サービス変更管理 AWSCM - ツール。2014 IEEE 第 6 回国際クラウドコンピューティング技術および科学会議。p. 715。doi :10.1109/ CloudCom.2014.144。ISBN 978-1-4799-4093-6。

[6] 「WSDL 開示」。2017年 5 月 31 日閲覧。