index

JAX-WS : Comment l'utiliser dans un Tomcat

Contenu du war

Par exemple, voici un exemple d'un fichier war (remarquez les fichiers wsdl et xsd):
WEB-INF/classes/hello/HelloIF.class          SEI
WEB-INF/classes/hello/HelloImpl.class        Endpoint
WEB-INF/sun-jaxws.xml                        JAX-WS RI deployment descriptor
WEB-INF/web.xml                              Web deployment descriptor
WEB-INF/wsdl/HelloService.wsdl               WSDL
WEB-INF/wsdl/schema.xsd                      WSDL imports this Schema
	

Le fichier sun-jaxws.xml

L'élément <endpoints> contient un ou plus <endpoint> . Chaque "endpoint" représente un port dans le WSDL et il contient toutes les informations nécessaires : class, servlet, url-pattern, WSDL, services, Qnames.
Voici un fichier sun-jaxws.xml pour un simple service HelloWorld .

<?xml version="1.0" encoding="UTF-8"?>

<endpoints xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime" version="2.0">
<endpoint
name="MyHello"
implementation="hello.HelloImpl"
url-pattern="/hello"/>
</endpoints>

Le Fichier web.xml

Voici un simple fichier web.xml pour un service HelloWorld.

Remarquez le listener et le servlet.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/j2ee/dtds/web-app_2_3.dtd">

<web-app>
<listener>
<listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
</listener>
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/hello</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>60</session-timeout>
</session-config>
</web-app>

Remarquez l'emplacement des wsdl et des shémas dans le directory WEB-INF/wsdl:

annotation @WebService

Les classes doivent avoir les annotations @WebServiceProvider qui peuvent également définir les wsdl, service, port aussi bien que dans sun-jaxws.xml.