Cosminexus アプリケーションサーバ V8 Webサービス開発の手引
ここでは,POJOのWebサービスで使用するWARファイルに含まれるweb.xmlについて説明します。
web.xmlを作成する場合,ファイル名称は"web.xml"とし,WARファイルを構成するWEB-INFディレクトリの直下に格納します。web.xmlの格納が必須かどうかは,J2EEサーバ用ユーザプロパティファイル(usrconf.properties)のwebserver.container.jaxws.webservice.no_webxml.enabledプロパティの設定値によって異なります。
次に,Webサービスの実行に必要な定義,web.xmlの例,およびweb.xmlをWARファイルに含めない場合の動作について説明します。
webserver.container.jaxws.webservice.no_webxml.enabledプロパティに"strict"を設定してweb.xmlをWARファイルに含める場合,または"none"を設定した場合,web.xmlは,次に示す条件を満たすように作成してください。
<listener>
<listener-class>
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
|
<servlet>
<description>Endpoint servlet for Cosminexus JAX-WS</description>
<display-name>Endpoint_servlet_for_Cosminexus_JAX_WS</display-name>
<servlet-name>CosminexusJaxwsServlet</servlet-name>
<servlet-class>
com.cosminexus.xml.ws.transport.http.servlet.WSServlet
</servlet-class>
</servlet>
|
<servlet-mapping>
<servlet-name>CosminexusJaxwsServlet</servlet-name>
<url-pattern>" / "+Webサービス1のサービス名</url-pattern>
<url-pattern>" / "+Webサービス2のサービス名</url-pattern>
:
<url-pattern>" / "+Webサービスnのサービス名</url-pattern>
</servlet-mapping>
|
web.xmlの例を次に示します。
<?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">
<description>Sample web service "fromwsdl"</description>
<display-name>Sample_web_service_fromwsdl</display-name>
<listener>
<listener-class>
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
<servlet>
<description>Endpoint servlet for Cosminexus JAX-WS</description>
<display-name>Endpoint_servlet_for_Cosminexus_JAX_WS</display-name>
<servlet-name>CosminexusJaxwsServlet</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>CosminexusJaxwsServlet</servlet-name>
<url-pattern>/TestJaxWsService</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
</web-app>
|
この例では,次の属性の値が「TestJaxWsService」であることを想定しています。
このとき,url-pattern要素の値は「/」(スラッシュ)を付けて「/TestJaxWsService」と記述します。
CosminexusのJAX-WS機能では,webserver.container.jaxws.webservice.no_webxml.enabledプロパティに"strict",または"lax"を設定してweb.xmlをWARファイルに含めない場合,Webサービス呼び出し時に次に示す内容のweb.xmlがあるものとして処理されます。
<?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">
<description>Cosminexus JAX-WS Default web.xml</description>
<display-name>Cosminexus_JAX_WS_Default_web_xml</display-name>
<listener>
<listener-class>
com.cosminexus.xml.ws.transport.http.servlet.WSServletContextListener
</listener-class>
</listener>
<servlet>
<description>Endpoint servlet for Cosminexus JAX-WS</description>
<display-name>Endpoint_servlet_for_Cosminexus_JAX_WS</display-name>
<servlet-name>CosminexusJaxwsServlet</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>CosminexusJaxwsServlet</servlet-name>
<url-pattern>"/"+Webサービス1のサービス名</url-pattern>
<url-pattern>"/"+Webサービス2のサービス名</url-pattern>
:
<url-pattern>"/"+Webサービスnのサービス名</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
</web-app>
|
url-pattern要素の「" / "+Webサービス1のサービス名」は,次の属性の値に,プレフィクスとして「/」(スラッシュ)を付けた文字列が定義されます。
WARファイル内に格納したすべてのWebサービス実装クラスまたはプロバイダ実装クラスについて,url-pattern要素があるかのように動作します。
webserver.container.jaxws.webservice.no_webxml.enabledプロパティに"lax"を設定してweb.xmlをWARファイルに含める場合でも,「3.4(1) Webサービスの実行に必要な定義」の内容が正しくweb.xmlに記述されていないときは,web.xmlが含まれない場合と同様に,上記に示す内容のweb.xmlがあるものと仮定してWebサービスを呼び出します。なお,このとき仮定されるweb.xmlは,上記の内容からsession-config要素以下を除いた内容です。
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.