8.3.5 web.xmlの編集
POJOのWebサービスを開発する場合,Webサービスをデプロイするために,web.xmlにWebサービスとして動作するための設定を追加します。EJBのWebサービスを開発する場合,web.xmlの編集は不要です。
追加する要素と指定する値を次の表に示します。
web.xmlの要素名 |
指定する値 |
---|---|
web-app |
− |
├ listener |
− |
│ └ listener-class │ |
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener |
├ servlet |
− |
│ ├ servlet-name |
WSServlet |
│ ├ servlet-class │ │ |
com.cosminexus.xml.ws.transport.http.servlet.WSServlet |
│ └ load-on-startup |
1 |
└ servlet-mapping |
− |
├ servlet-name |
WSServlet |
└ 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の作成」を参照してください。