For specifying strict in the webserver.container.jaxws.webservice.no_webxml.enabled property to include web.xml in the WAR file, or for specifying none, create web.xml in such a way so that the following conditions are fulfilled:

• Version
  The web.xml version must be 2.5 or later.
  
• Listener
  Include the following listener elements in the web-app element:
  

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

• Servlet
  Include the following servlet elements in the web-app element:
  

  <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
  Code the servlet-mapping element under the web-app element and include the same number of url-pattern elements as the number of Web Service Implementation Classes or Provider Implementation Classes.
  The following is a coding example of servlet-mapping element:
  

  <servlet-mapping> <servlet-name>CosminexusJaxwsServlet</servlet-name> <url-pattern>"/"+Service name of Web Service 1</url-pattern> <url-pattern>"/"+Service name of Web Service 2</url-pattern> ... <url-pattern>"/"+Service name of Web Service n</url-pattern> </servlet-mapping>

  For "/" + Service name of Web Service 1 in the url-pattern element, code a string with / (slash) added as a prefix to the following values:
  
  • Value of serviceName attribute of the javax.jws.WebService annotation of the Web Service Implementation Class
  • Values of the serviceName attribute of the javax.xml.ws.WebServiceProvider annotation for the Provider Implementation Class
    

    Reference note

    To include cosminexus-jaxws.xml in a WAR file

    Code a value for the url-pattern attribute of the endpoint element corresponding to the Web Service Implementation Class or the Provider Implementation Class of cosminexus-jaxws.xml. For cosminexus-jaxws.xml, see 10.3 Customization using cosminexus-jaxws.xml.

• Other elements
  You can code any other element. To include the servlet, listener, and JSP created in the WAR file, specify the definition in web.xml appropriately.
  

An example of web.xml is as follows:

<?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>/TestJaxWsService</url-pattern>
 </servlet-mapping>
 <session-config>
 <session-timeout>60</session-timeout>
 </session-config>
</web-app>

When creating web.xml of version 2.5, specify 2.5 in the version attribute of the web-app element and specify http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd as the second location information in the xsd:schemaLocation attribute.

The above example is based on the assumption that the value of the following attributes is TestJaxWsService:

• The serviceName attribute of the javax.jws.WebService annotation for the Web Service Implementation Class
• The serviceName attribute of the javax.xml.ws.WebServiceProvider annotation for the Provider Implementation Class

At this time, add / (slash) and code the value of the url-pattern element as /TestJaxWsService.

Reference note

To include cosminexus-jaxws.xml in a WAR file

If a value for the url-pattern attribute of the endpoint element that corresponds to the Web Service Implementation Class or the Provider Implementation Class is /TestJaxWsService, specify the coding as described in the example.

With the JAX-WS functionality of Cosminexus, if you do not specify strict or lax in the webserver.container.jaxws.webservice.no_webxml.enabled property to include web.xml in the WAR file, the processing will be performed considering that the web.xml with the following contents exist while invoking Web Services:

<?xml version="1.0" encoding="UTF-8"?>
<!-- code the web-app element-->
 <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>"/"+Service name of Web Service 1</url-pattern>
 <url-pattern>"/"+Service name of Web Service 2</url-pattern>
 :
 <url-pattern>"/"+Service name of Web Service n</url-pattern>
 </servlet-mapping>
 <session-config>
 <session-timeout>60</session-timeout>
 </session-config>
</web-app>

For "/" + Service name of Web Service 1, a string is defined with / (slash) that is added as a prefix to values of the following attributes:

• A value of the serviceName attribute of the javax.jws.WebService annotation for the Web Service Implementation Class.
• A value of the serviceName attribute of the javax.xml.ws.WebServiceProvider annotation for the Provider Implementation Class

The operations for all the Web Service Implementation Classes or the Provider Implementation Classes stored in the WAR file will be performed assuming that the url-pattern element exists.

When you specify lax in the webserver.container.jaxws.webservice.no_webxml.enabled property to include web.xml in a WAR file, and if the contents of the section 3.4(1) Definitions required for executing Web Services are not coded correctly in web.xml, invoke Web Services considering that the web.xml with the above contents exist, in the same way as you would consider when web.xml is not included. Note that the web.xml file that is considered in such cases will have the above mentioned contents excluding the contents of the session-config element.

Note

• The web.xml file that the JAX-WS engine considers need not be actually generated within the WAR file. This assumption is only applicable when invoking Web Services.

Example:

The attribute files that can be acquired with the cjgetappprop command do not include the information related to web.xml. Also, when specifying lax in the webserver.container.jaxws.webservice.no_webxml.enabled property and including web.xml with invalid contents in a WAR file, the information that is actually included in web.xml can only be acquired.

• When specifying lax in the webserver.container.jaxws.webservice.no_webxml.enabled property and including web.xml with invalid contents in a WAR file, the contents of the web.xml file that the JAX-WS engine considers while invoking the Web Services are not necessarily be coded in the actual web.xml.
• When specifying lax in the webserver.container.jaxws.webservice.no_webxml.enabled property, include web.xml defining all the contents of the section 3.4(1) Definitions required for executing Web Services in a WAR file. If web.xml with only partial contents is included in the WAR file, the operation cannot be guaranteed.