SeamとJBossWSを統合することで、標準のJEE のWebサービスにたいして、対話型Webサービスにも対応したSeamのコンテキストフレームワークを十分に活用することができます。本章では、Seam環境でWebサービスが動作するのに必要な手順を説明します。

<jaxws-config xmlns="urn:jboss:jaxws-config:2.0" 

              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

              xmlns:javaee="http://java.sun.com/xml/ns/javaee"

              xsi:schemaLocation="urn:jboss:jaxws-config:2.0 jaxws-config_2_0.xsd">

   <endpoint-config>

      <config-name

>Seam WebService Endpoint</config-name>

      <pre-handler-chains>

         <javaee:handler-chain>

            <javaee:protocol-bindings

>##SOAP11_HTTP</javaee:protocol-bindings>

            <javaee:handler>

               <javaee:handler-name

>SOAP Request Handler</javaee:handler-name>

               <javaee:handler-class

>org.jboss.seam.webservice.SOAPRequestHandler</javaee:handler-class>

            </javaee:handler>

         </javaee:handler-chain>

      </pre-handler-chains>

   </endpoint-config>

</jaxws-config

>

24.2. 対話型Webサービス

では、Webサービス要求間でどのように対話が伝播されているのでしょう？ Seamでは、SOAP要求と応答メッセージの両方でSOAPヘッダー要素を使い、そのconversation IDをコンシューマからサービスへ、またサービスからコンシューマへと伝えています。以下はconversation IDを含むWebサービスの要求の一例です。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 

    xmlns:seam="http://seambay.example.seam.jboss.org/">

  <soapenv:Header>

    <seam:conversationId xmlns:seam='http://www.jboss.org/seam/webservice'

>2</seam:conversationId>

  </soapenv:Header>

  <soapenv:Body>

    <seam:confirmAuction/>

  </soapenv:Body>

</soapenv:Envelope

>    

    

上記のSOAPメッセージで見られるように、SOAPヘッダー内にその要求のためのconversation ID（ここでは2）を持つconversationId要素があります。残念ながら、Webサービスを使うクライアントは多種多様で、なおかつさまざまな言語で記述されているため、ひとつの対話のスコープ内で使われると想定されるconversation IDの伝播をどのように実装するかは、個々のWebサービス間の開発者次第です。

ここで重要なのは、 conversationIdヘッダー要素はhttp://www.jboss.org/seam/webserviceの名前空間に適したものでなければいけません。そうでなければ、Seamはその要求からconversation IDを読み取ることができなくなってしまいます。上記の要求メッセージに対する応答の一例を以下に示します。

<env:Envelope xmlns:env='http://schemas.xmlsoap.org/soap/envelope/'>

  <env:Header>

    <seam:conversationId xmlns:seam='http://www.jboss.org/seam/webservice'

>2</seam:conversationId>

  </env:Header>

  <env:Body>

    <confirmAuctionResponse xmlns="http://seambay.example.seam.jboss.org/"/>

  </env:Body>

</env:Envelope

>    

    

ここにあるように、応答メッセージには要求と同じconversationId要素が含まれています。

24.2.1. 推奨される方法

Webサービスは、ステートレスセッションBeanもしくはPOJOとして実装する必要があります。このため、対話型Webサービスでは、対話型SeamコンポーネントのファサードとしてそのWebサービスが動作することが望ましいでしょう。

ステートレスセッションBeanで記述されたWebサービスの場合、@Nameを指定してSeamコンポーネントにすることも可能です。こうすることで、Seamのバイジェクション等の機能がWebサービスのクラスで使えるようになります。

@Stateless

@WebService(name = "AuctionService", serviceName = "AuctionService")

public class AuctionService implements AuctionServiceRemote

{

   @WebMethod

   public boolean login(String username, String password)

   {

      Identity.instance().setUsername(username);

      Identity.instance().setPassword(password);

      Identity.instance().login();

      return Identity.instance().isLoggedIn();

   }


   // snip

}

   @WebMethod

   public void createAuction(String title, String description, int categoryId)

   {

      AuctionAction action = (AuctionAction) Component.getInstance(AuctionAction.class, true);

      action.createAuction();

      action.setDetails(title, description, categoryId);

   }

   @Begin

   public void createAuction()

   {

      auction = new Auction();

      auction.setAccount(authenticatedAccount);

      auction.setStatus(Auction.STATUS_UNLISTED);        

      durationDays = DEFAULT_AUCTION_DURATION;

   }

@Path("/customer")

public class MyCustomerResource {


    @GET

    @Path("/{customerId}")

    @ProduceMime("text/plain")

    public String getCustomer(@PathParam("customerId") int id) {

         return ...;

    }


}

<components

   xmlns="http://jboss.com/products/seam/components"

   xmlns:resteasy="http://jboss.com/products/seam/resteasy"

   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

   xsi:schemaLocation=

     http://jboss.com/products/seam/resteasy

         http://jboss.com/products/seam/resteasy-2.1.xsd

     http://jboss.com/products/seam/components

         http://jboss.com/products/seam/components-2.1.xsd"

>

<resteasy:application-config resource-path-prefix="/restv1"/>

<resteasy:application-config strip-seam-resource-path="false"/>

<resteasy:application-config

     scan-providers="false"

     scan-resources="false"

     use-builtin-providers="true">



     <resteasy:resource-class-names>

         <value

>org.foo.MyCustomerResource</value>

         <value

>org.foo.MyOrderResource</value>

     </resteasy:resource-class-names>



     <resteasy:provider-class-names>

         <value

>org.foo.MyFancyProvider</value>

     </resteasy:provider-class-names>



 </resteasy:application-config

>

<resteasy:application-config>



    <resteasy:media-type-mappings>

       <key

>txt</key

><value

>text/plain</value>

    </resteasy:media-type-mappings>



    <resteasy:language-mappings>

       <key

>deutsch</key

><value

>de-DE</value>

    </resteasy:language-mappings>



</resteasy:application-config

>

@Name("customerResource")

@Path("/customer")

public class MyCustomerResource {


    @In

    CustomerDAO customerDAO;


    @GET

    @Path("/{customerId}")

    @ProduceMime("text/plain")

    public String getCustomer(@PathParam("customerId") int id) {

         return customerDAO.find(id).getName();

    }


}