付録D.5　サービスの詳細インターフェースを検討する

これまでに検討した仕様を踏まえて，各サービスのオペレーションのメッセージ構造を決定します。具体的には，「付録D.2(2)　概要WSDLを作成する」で作成した概要WSDLにメッセージ構造の宣言を追加します。

各サービスの要求メッセージと応答メッセージには，次の表に示す情報が必要になるため，これを概要WSDLのメッセージ宣言に反映（ルート要素の下に宣言を追加）します。

表D‒9　サービスの要求／応答メッセージに必要な情報

項番	サービス名	メッセージ	必要な情報
			名前	型	説明
1	在庫引当サービス	reserveItemRequest	ItemName	xsd:string	在庫引当する商品の名前
			Quantity	xsd:int	在庫引当する個数
		reserveItemResponse	ReservationNumber	xsd:string	引当番号
2	配送手配サービス	deliverItemRequest	ReservationNumber	xsd:string	配送手配する引当番号
		deliverItemResponse	DeliveryNumber	xsd:string	配送番号
3	商品手配ビジネスプロセス	arrangeItemRequest	ItemName	xsd:string	手配する商品の名前
			Quantity	xsd:int	手配する商品の個数
		arrangeItemResponse	DeliveryNumber	xsd:string	配送番号

在庫引当サービスを例にWSDL（InventoryManagementService.wsdl）の定義例を次に示します。WSDL中の太字は，追記した内容を表します。

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions
      targetNamespace="http://sample/InventoryManagementService"
      xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:ims="http://sample/InventoryManagementService">
 
   <wsdl:types>
      <xsd:schema
            targetNamespace="http://sample/InventoryManagementService"
            elementFormDefault="qualified">
         <xsd:element name="reserveItem">
            <xsd:complexType>
               <xsd:sequence>
                  <xsd:element name="ItemName" type="xsd:string" />
                  <xsd:element name="Quantity" type="xsd:int" />
               </xsd:sequence>
            </xsd:complexType>
         </xsd:element>
         <xsd:element name="reserveItemResponse">
            <xsd:complexType>
               <xsd:sequence>
                  <xsd:element name="ReservationNumber" type="xsd:string" />
               </xsd:sequence>
            </xsd:complexType>
         </xsd:element>
      </xsd:schema>
   </wsdl:types>
 
   <wsdl:message name="reserveItemRequest">
      <wsdl:part name="parameters" element="ims:reserveItem" />
   </wsdl:message>
 
   <wsdl:message name="reserveItemResponse">
      <wsdl:part name="parameters" element="ims:reserveItemResponse" />
   </wsdl:message>
 
   <wsdl:portType name="InventoryManager">
      <wsdl:operation name="reserveItem">
         <wsdl:input message="ims:reserveItemRequest" name="reserveItemRequest" />
         <wsdl:output message="ims:reserveItemResponse" name="reserveItemResponse" />
      </wsdl:operation>
   </wsdl:portType>
 
   <wsdl:binding name="InventoryManagerSoapBinding" type="ims:InventoryManager">
      <soap:binding style="document"
            transport="http://schemas.xmlsoap.org/soap/http" />
      <wsdl:operation name="reserveItem">
         <soap:operation soapAction="" />
         <wsdl:input name="reserveItemRequest">
            <soap:body use="literal" />
         </wsdl:input>
      <wsdl:output name="reserveItemResponse">
            <soap:body use="literal" />
         </wsdl:output>
      </wsdl:operation>
   </wsdl:binding>
 
   <wsdl:service name="InventoryManagementService">
      <wsdl:port binding="ims:InventoryManagerSoapBinding" name="InventoryManager">
         <soap:address location="http://localhost/InventoryManagementServiceWeb/services/InventoryManager" />
      </wsdl:port>
   </wsdl:service>
</wsdl:definitions>

詳細インターフェースを記載したWSDLは，サンプルプログラムに同梱されています。サンプルプログラムの格納場所については，マニュアル「サービスプラットフォーム ファーストステップガイド」の「付録A　サービス部品のサンプルプログラムのファイル構成」を参照してください。

ページの先頭へ