WSDL（Web Services Description Language）

WSDL（Web Services Description Language）とは、Webサービスがどんな機能を持ち、何を渡せば何が返ってくるのか、どこに接続すればよいのかを、XMLで書き表すための言語です。主にSOAPを使ったWebサービスの「取扱説明書」として使われ、「ウィズダル」と読まれることもあります。

現実世界に例えると、WSDLは役所の窓口に置かれた、申請書の書き方と提出先をまとめた案内書のようなものです。どの用紙に何を書き、どの窓口に出せば何が受け取れるかが書かれているので、初めての人でも迷わず手続きできます。

WSDL図解

※画像をクリックすると拡大表示します。

なぜ説明書が必要なのか

生まれた理由です。Webサービスを呼び出すには、機能の名前や、送るデータの項目と型、返ってくる内容などを、提供する側と使う側で正確にそろえる必要があります。人が読む文書だけでは、読み違いが起きやすくなります。そこで、コンピューターが読み取れる形で取り決めを書き表すために、WSDLが作られました。

SOAPと組で使われる

関係の深い技術です。WSDLは、XMLで要求と応答をやり取りするSOAPのWebサービスと組み合わせて使われることがほとんどです。SOAPがやり取りする電文の書き方を決め、WSDLはそのサービスで何ができるかを説明するという役割分担になっています。どちらもXMLで書かれる点が共通しています。

書かれている主な内容

WSDLの中身です。1つのWSDLには、サービスを使うために必要な情報が、いくつかの部分に分けて書かれています。主な部分は次のとおりです。

プログラムを自動で作れる

最大の利点です。開発の道具にWSDLを読み込ませると、サービスを呼び出すためのプログラムの部品を自動で作ることができます。使う側は、相手のサービスの機能を、手元の関数を呼ぶような感覚で使えるようになります。取り決めを手作業で写し取る必要がないため、間違いが減り、開発の手間も大きく省けます。

取り決めを先に決める作り方

設計の進め方です。まずWSDLで取り決めを書き、それをもとに提供する側と使う側がそれぞれ開発を進める方法を「契約優先」と呼びます。異なる会社や組織がつながるシステムでは、先に取り決めを固めておくことで、互いに相手を待たずに作業を進められ、つなぎ込みのときの食い違いも減らせます。

版による違い

規格の歴史です。WSDLには、2001年に公開された1.1と、2007年に正式な規格となった2.0があります。2.0では構成が整理されましたが、実際には1.1のほうが広く使われ続けました。既存のシステムで目にするWSDLの多くは、1.1の形式で書かれています。

RESTの時代の説明書

その後の流れです。Web APIの主流がSOAPから、より軽いREST APIへ移るにつれて、WSDLを新しく書く機会は少なくなりました。現在、REST APIの取り決めを書き表すには、「OpenAPI」という形式が広く使われています。機械が読める説明書から部品を作るという考え方は、形を変えて受け継がれています。

今も知っておく意味

現在の位置づけです。金融機関や行政、企業の基幹システムなど、SOAPのWebサービスが今も動いている現場では、WSDLは欠かせない資料です。こうしたシステムとつなぐ仕事では、WSDLを受け取って部品を作ることから作業が始まります。読み方の基本を知っておくと、つなぎ込みの作業がぐっと楽になります。

あわせて知っておきたい用語

• SOAP：
  XMLで要求と応答をやり取りする、Webサービスの取り決めです。
• XML：
  タグで意味を示しながらデータを表す記述形式です。
• Webサービス：
  ネットワーク越しに、ほかのプログラムへ機能を提供する仕組みです。
• REST API：
  URLとHTTPの作法に沿ってやり取りする方式です。