10.3.2　cosminexus-jaxws.xmlの書式

(1)　jaxwsdd:endpoints要素（cosminexus-jaxws.xml）

jaxwsdd:endpoints要素は，cosminexus-jaxws.xmlのルート要素です。属性は持ちません。

ページの先頭へ

(2)　jaxwsdd:endpoint要素（cosminexus-jaxws.xml）

jaxwsdd:endpoint要素には，URLと，Webサービス実装クラスまたはプロバイダ実装クラスのマッピングを記述します。1個のjaxwsdd:endpoint要素に1個のマッピングを記述します。Webサービスが複数のポートを持つような場合（一つのWebサービスが複数のURLで提供される場合）や，同じWARファイル内に複数のWebサービスがある場合は，ポートやWebサービスに対応した数のjaxwsdd:endpoint要素を記述する必要があります。

jaxwsdd:endpoint要素の属性の一覧を次の表に示します。

表10‒4　jaxwsdd:endpoint要素の属性一覧

項番	属性名	必須	説明
1	name	○	jaxwsdd:endpoint要素を区別するための名前を指定します。
2	implementation	○	Webサービス実装クラスまたはプロバイダ実装クラスを指定します。
3	port	×	Webサービス実装クラスまたはプロバイダ実装クラスと対応づけるポートを指定します。javax.jws.WebServiceアノテーション，またはjavax.xml.ws.WebServiceProviderアノテーションの設定よりも優先されます。一つのWebサービス実装クラスまたはプロバイダ実装クラスを複数のURLにマッピングする場合に指定します。
4	url-pattern	○	Webサービス実装クラスまたはプロバイダ実装クラスと対応づけるURLを指定します。web.xmlのurl-pattern要素と対応しています。

ページの先頭へ

(3)　cosminexus-jaxws.xml使用時の設定例

次のWebサービスに対応したDDの記述例を示します。

表10‒5　Webサービス実装クラスと対応するURLの例

項番	Webサービス実装クラス	URL
1	com.sample.AddNumbersImplA	/test1
2	com.sample.AddNumbersImplB	/test2，/test3

web.xmlの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0" 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_3_0.xsd">
  <description>Sample web service &quot;fromwsdl&quot;</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>/test1</url-pattern>
    <url-pattern>/test2</url-pattern>
    <url-pattern>/test3</url-pattern>
  </servlet-mapping>
</web-app>

バージョン2.5のweb.xmlを作成する場合は，web-app要素のversion属性を"2.5"に，xsd:schemaLocation属性の二つ目のロケーション情報を"http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"にしてください。

cosminexus-jaxws.xmlの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<endpoints xmlns='http://java.sun.com/xml/ns/jax-ws/ri/runtime'>
    <endpoint
        name="test1"
        implementation="com.sample.AddNumbersImplA"
        url-pattern="/test1"
    />
    <endpoint
        name="test2"
        implementation="com.sample.AddNumbersImplB"
        url-pattern="/test2"
        port="{http://sample.com}port1"
    />
    <endpoint
        name="test3"
        implementation="com.sample.AddNumbersImplB"
        url-pattern="/test3"
        port="{http://sample.com}port2"
    />
</endpoints>

バージョン2.5のweb.xmlを作成する場合は，web-app要素のversion属性を"2.5"に，xsd:schemaLocation属性の二つ目のロケーション情報を"http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"にしてください。

ページの先頭へ