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}")

    @Produces("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 resource-path-prefix="/restv1"/>

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

<resteasy:application

     scan-providers="false"

     scan-resources="false"

     use-builtin-providers="true">



     <resteasy:resource-class-names>

         <value>org.foo.MyCustomerResource</value>

         <value>org.foo.MyOrderResource</value>

         <value>org.foo.MyStatelessEJBImplementation</value>

     </resteasy:resource-class-names>



     <resteasy:provider-class-names>

         <value>org.foo.MyFancyProvider</value>

     </resteasy:provider-class-names>



 </resteasy:application>

<resteasy:application>



    <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>

@Name("customerResource")

@Path("/customer")

public class MyCustomerResource {


    @In

    CustomerDAO customerDAO;


    @GET

    @Path("/{customerId}")

    @Produces("text/plain")

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

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

    }


}

@Path("/customer")

public interface MyCustomerResource {


    @GET

    @Path("/{customerId}")

    @Produces("text/plain")

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


}

@Name("customerResource")

@Scope(ScopeType.STATELESS)

public class MyCustomerResourceBean implements MyCustomerResource {


    @In

    CustomerDAO customerDAO;


    public String getCustomer(int id) {

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

    }


}

<resteasy:application destroy-session-after-request="false"/>

<web:authentication-filter url-pattern="/seam/resource/rest/*" auth-type="basic"/>

<filter>

    <filter-name>Seam Filter</filter-name>

    <filter-class>org.jboss.seam.servlet.SeamFilter</filter-class>

</filter>



<filter-mapping>

    <filter-name>Seam Filter</filter-name>

    <url-pattern>/*</url-pattern>

</filter-mapping>

<exception class="java.lang.UnsupportedOperationException">

    <http-error error-code="501">

        <message>The requested operation is not supported</message>

    </http-error>

</exception>

<exception class="my.CustomException" log="false">

    <http-error error-code="503">

        <message>Service not available: #{org.jboss.seam.handledException.message}</message>

    </http-error>

</exception>

import org.jboss.seam.resteasy.testfwk.ResourceSeamTest;

import org.jboss.seam.resteasy.testfwk.MockHttpServletResponse;

import org.jboss.seam.resteasy.testfwk.MockHttpServletRequest;


public class MyTest extends ResourceSeamTest {


   @Override

   public Map<String, Object> getDefaultHeaders()

   {

      return new HashMap<String, Object>()

      {{

            put("Accept", "text/plain");

      }};

   }


   @Test

   public void test() throws Exception

   {

      new ResourceRequest(Method.GET, "/my/relative/uri)

      {


         @Override

         protected void prepareRequest(MockHttpServletRequest request)

         {

            request.addQueryParameter("foo", "123");

            request.addHeader("Accept-Language", "en_US, de");

         }


         @Override

         protected void onResponse(MockHttpServletResponse response)

         {

            assert response.getStatus() == 200;

            assert response.getContentAsString().equals("foobar");

         }


      }.run();

   }


}