スライド

http://www.w3.org/2007/Talks/0628-sfc-lecture-ws/

注意！HTTPの詳細のところは省きます

本講義の「Web Architecture」の資料を読んでください

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

文書のWeb

• 本講義の今までのテーマは文書がメーン
  • HTTPで送受信する文書
  • XMLで文書の作成
  • スキーマ言語で文書の構造の定義
  • XPath、XSLTなどで文書の処理
  • CSSで文書のスタイル
  • など

サービスのWeb

適用分野は

• 情報体系への問い合わせ、又は情報の変更
• サービスの間のつながり

Webサービスのアプローチ

• RESTのWebサービスは
  • 情報体系への問い合わせ、又は情報の変更が課題
  • 特定の技術ではなく、インターネット技術（HTTP、URIなど）の適用方法
• SOAPのWebサービスは
  • サービスとサービスをつなぐ、
    サービス指向アーキテクチャ「Service Oriented Architecture」の一例
  • SOAP、WSDL、UDDIなどの特定の技術

注意！

• Webサービスの一般的な定義はまだない
• 「RESTはWebサービスではない」という声も
• SOAPとRESTの違いは今のWebのHot Topic！

Webサービスのメリット

• 特定のOSと関係ない
• 特定のプログラム言語 と関係ない
• Webサービス提供者「provider（server）」とWebサービス要求者「requestor(client)」の多様な組み合わせができる

サービスの一例

• 部品についてのWebサービス
• サービスのオペレーション
  • 部品の情報の問い合わせ
  • 部品の注文

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

SOAPのWebサービスが利用する技術

• データはXML、データ型はXML Schema
• SOAP はメッセージのフォーマット
• HTTP などのプロトコルとの「Binding」
• Webサービスの記述「WSDL」
• Webサービス発見「UDDI」（ここでは触れない）

SOAPの基本

• Simple Object Access Protocol
• メッセージとエラー定義を含むXML文書「Envelope」
• header と body

<soap:Envelope
 xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
 soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Header> ... </soap:Header>
<soap:Body> ...
 <soap:Fault> ... </soap:Fault>
</soap:Body>
</soap:Envelope>

部品のサービスの request（document style）

• <soap:Body>の内容はユーザーが定義する、XMLスキーマによるXML文書

<soap:Envelope
 xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
<soap:Header> ... </soap:Header>
<soap:Body>
 <getPartInfo xmlns="some-ns.example.com">00345</getPartInfo>
</soap:Body>
</soap:Envelope>

部品のサービスの request（rpc style）

• Remote Procedure Call
• 主に単なる「request-response」のパターンに使用
• <soap:Body>の内容は「SOAP ENCODING」の規則に従うXML文書

<soap:Envelope
 xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
 soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
<soap:Header> ... </soap:Header>
<soap:Body>
 <getPartInfo xmlns="some-ns.example.com>
  <partID>00345</partID>
 </getPartInfo>
</soap:Body>
</soap:Envelope>

responseの一例

<soap:Body>
 <p:Part xmlns:p="http://www.parts-depot.com"   
  xmlns:xlink="http://www.w3.org/1999/xlink">
  <Part-ID>00345</Part-ID>
  <Name>Widget-A</Name>
  <Description>...</Description>
  <Specification xlink:href="http://www.parts-depot.com/parts/00345/specification"/>
  <UnitCost currency="USD">0.10</UnitCost>
  <Quantity>10</Quantity>
 </p:Part>
</soap:Body>

WSDL

• Web Services Description Language

<definitions>
 <types> ... </types>
 <message> ... </message>
 <portType> ... </portType>
 <binding> ... </binding>
</definitions>

• データ型<types>
• データ型を利用するメッセージ<message>
• メッセージなどを含み、サービスの記述<portType>
• プロトコルとのbindingの定義<binding>

WSDLの一例

<definitions>
 <types> 
  <xs:element name="getPartInfo"> ... </types>
 <message name="GetPartInfoSoap">
  <part name="parameters" element="tns:getPartInfo"/> ... </message>
 <portType name="GetPartInfoSoap> 
 <operation name="GetPartInfo">
  <input message="tns:GetPartInfoSoap"> ... </operation> ... </portType>
 <binding> ... </binding>
</definitions>

WS-*

• SOAPを拡張する標準
• 【メッセージング仕様】WS-Addressing
• 【セキュリティ】WS-Security、WS-SecureConversation、WS-SecurityPolicy、WS-Trust
• 【高信頼性】WS-ReliableMessaging
• 【トランザクション】WS-Coordination、WS-AtomicTransaction
• 【メタデータ】WS-Policy、WS-PolicyAttachment、WS-MetadataExchange

WS-Addressingの「endpoint reference(EPR)」

• サービスを識別する
• URIと追加情報

<wsa:EndpointReference xmlns:wsa="..." xmlns:example="...">
   <wsa:Address>http://www.parts-depot.com/parts/</wsa:Address>
   <wsa:ReferenceProperties>
       <example:ServiceLevel>Basic</example:ServiceLevel>
   </wsa:ReferenceProperties>
</wsa:EndpointReference>

• EPRはURIとは違い、Web Architectureに従わない！

SOAPのWebサービス

• Webサービスのツールがメーン
• ツールの会社が影響が大きい
• RESTは違う

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

RESTの趣旨

• Representational State Transfer
• Webの基本単位は「リソース」
• clientのステートがリソースの送受信で変わる

RESTの基本的な概念

• HTTP、URI、リソースとリソースのMIME typeがメーン
• SOAPよりシンプル
• 新しい技術より、Web技術の適用方法

RESTの一例、問い合わせ

部品のリストの問い合わせ

http://www.parts-depot.com/parts

部品の詳細の情報を問う

http://www.parts-depot.com/parts/00345

問い合わせの出力

 <p:Part xmlns:p="http://www.parts-depot.com"   
  xmlns:xlink="http://www.w3.org/1999/xlink">
  <Part-ID>00345</Part-ID>
  <Name>Widget-A</Name>
  <Description>...</Description>
  <Specification xlink:href="http://www.parts-depot.com/parts/00345/specification"/>
  <UnitCost currency="USD">0.10</UnitCost>
  <Quantity>10</Quantity>
 </p:Part>

RESTのURIの種類

• logical URI

http://www.parts-depot.com/parts/00345

• physical URI

http://www.parts-depot.com/parts?action=getParts&partID=00345

• logical URI と physical URIの互換性
• RESTのWebサービスが提供するのは「logical URI」だけ

RESTの特徴（まとめ）

• HTTPのPUT、POST、GET、DELETEの適用
• clientがリソースのrepresentationを引き出す「pull」アプローチ
• ステートがない
• Cacheができる
• リソースはイコールURI
• URIでリソースをつなぎ、clientのステートが変更

RESTの短所

• セキュリティがない
• 高信頼性がない
• サービスのメタデータが

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

SOAPとRESTの共同作業が可能

• 情報体系の問い合わせ、又は変更はREST
• サービスの間のつながりはSOAP
• その例は、サービスのセキュリティ性質などを表現する「Web Service Policy」

WSDLにおける「WS Policy」のメタデータ

• bindingにセキュリティが必要

<binding name="SecureBinding" ...>
  <PolicyReference URI="#secure" />...</wsdl:binding>

• 「security policy expression」の定義

<Policy wsu:Id=”secure”>
  <All>
    <ExactlyOne>
     <sp:TransportBinding>...</sp:TransportBinding>
     <sp:AsymmetricBinding>...</sp:AsymmetricBinding >
    </ExactlyOne>
  </All>
</Policy>

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

注意！

これから紹介する技術は

• 標準ではない
• Webサービスの国際化の提案

Webサービスの国際化の目的

• ロケール情報をサービスに追加する
• ロケール情報の例（繰り返し）は
  • 言語
  • 地域
  • 時間帯
  • など

SOAPのWebサービスの国際化

SOAPのheaderに国際化の情報を追加

<i18n:international>
 <tz>GMT-0300</tz>
 <i18n:locale>en-US</i18n:locale>
 <i18n:preferences>
  <ldml:measurementSystem type="metric" />
 </i18n:preferences>
</i18n:international>

ロケールの「WS Policy　expression」をWSDLに追加

RESTのサービスの国際化

• URIにロケールの情報を追加する
• HTTPのheaderにロケールの情報を追加する

概要

• 文書のWebとサービスのWebについて
• SOAPのWebサービス
• RESTのWebサービス
• SOAPとRESTの共同作業
• Webサービスの国際化

参考文献

• SOAP 1.2 Primer
• WSDL 2.0 Primer
• RESTのWebサービスについて
• Web Services Internationalization