8.3.5 web.xmlの編集

POJOのWebサービスを開発する場合,Webサービスをデプロイするために,web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合,web.xmlの編集は不要です。

追加する要素と指定する値を次の表に示します。

表8-2 web.xmlで追加する要素と指定する値

web.xmlの要素名指定する値
web-app
├ listener
│ └ listener-class
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener
├ servlet
│ ├ servlet-nameWSServlet
│ ├ servlet-class
│ │
com.cosminexus.xml.ws.transport.http.servlet.WSServlet
│ └ load-on-startup1
└ servlet-mapping
  ├ servlet-nameWSServlet
  └ url-patternマッピングするURL

(凡例) -:指定する値はありません。


注※
Webサービス実装クラスのWebServiceアノテーションでserviceName属性を記述しているかどうかによって,指定する値が異なります。
  • serviceName属性を記述している場合
    「"/" + serviceName属性値」を指定してください(「"/" + serviceName属性値」は,serviceName属性値の先頭に「/」(スラッシュ)が付くことを示します)。
  • serviceName属性を記述していない場合
    「"/" + Webサービス実装クラスの単純名 + Service」を指定してください(「"/" + Webサービス実装クラスの単純名 + Service」は,Webサービス実装クラスの単純名の先頭に「/」(スラッシュ),末尾に「Service」が付くことを示します)。

 

指定例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5"
        xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

   <listener>
       <listener-class>com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
   </listener>

   <servlet>
       <servlet-name>WSServlet</servlet-name>
       <servlet-class>com.cosminexus.xml.ws.transport.http.servlet.WSServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
       <servlet-name>WSServlet</servlet-name>
       <url-pattern>/TestJaxWsService</url-pattern>
   </servlet-mapping>

</web-app>

web.xmlの編集の詳細は,マニュアル「アプリケーションサーバ Webサービス開発ガイド」の「3.4 web.xmlの作成」を参照してください。