SOA – Web Services

Développer avec Java : JAX-WS

Mickaël BARON - 2010

[Link] ou [Link]
 Licence

Creative Commons
Contrat Paternité
Partage des Conditions Initiales à l'Identique
2.0 France
[Link]

[Link]

JAX-WS - M. Baron - Page 2

 Plan du cours

Généralités JAX-WS

Développement serveur

Bottom -> Up

Top -> Down

Développement client

Annotations

Handler
[Link]

Java 6 et EJB (client et serveur)

JAX-WS « in Actions » : Web Services eBay

Tutoriels avec Netbeans 6.8 JAX-WS - M. Baron - Page 3
 Déroulement du cours

Pédagogie du cours

Illustration avec de nombreux exemples qui sont disponibles à
l’adresse TODO

Des bulles d’aide tout au long du cours

Survol des principaux concepts en évitant une présentation
exhaustive

Logiciels utilisés

Navigateur Web, Netbeans 6.8, Tomcat 6, Glassfish 3, Maven 2

Pré-requis
[Link]

Ceci est une astuce

Schema XML, WSDL, SOAP, JAXB

Remerciements Ceci est une alerte

HowHigH JAX-WS - M. Baron - Page 4

 Ressources

Billets issus de Blog

[Link]/alexismp/entry/metro_boulot_dodo

[Link]/documentation/[Link]

[Link]/search/label/jax-ws

Articles

[Link]/ws/StackComparison

[Link]/developerworks/webservices/library/ws-jsrart

[Link]/developer/technicalArticles/J2SE/jax_ws_2/

[Link]/gmazza/entry/adding_jax_ws_handlers_to

[Link]/2008/09/using-jax-ws-handlers_25.html
[Link]

Cours

[Link]/webservices/docs/1.6/tutorial/doc/[Link]

[Link]/webservices/[Link]
JAX-WS - M. Baron - Page 5
 Ressources : Bibliothèque

Java SOA Cookbook

Auteur : Eben Hewitt

Éditeur : Oreilly

Edition : Mars 2009 - 752 pages - ISBN : 0596520727

Java Web Services : Up and Running

Auteur : Martin Kalin

Éditeur : Oreilly

Edition : Février 2009 - 316 pages - ISBN : 059652112X

Les Cahiers du Programmeur : Java EE 5

[Link]

Auteur : Antonio Goncalves

Éditeur : Eyrolles

Edition : Août 2008 - 351 pages - ISBN : 2212123639
JAX-WS - M. Baron - Page 6
 Généralités - Développement de Web Services

Nous nous intéressons dans ce cours au développement des

services Web

Côté Serveur : code pour le traitement du service Web

Côté Client : code qui permet d’appeler un service Web

La majorité des langages de programmation orientés Web
supportent le développement de services Web

Java, PHP, C#, C++, …

Nous nous limitons au langage Java dans ce cours

Différents frameworks de développement de Services Web

JAX-WS Specification Sun ([Link])
[Link]

AXIS 1 et 2 Apache ([Link]/axis et [Link]/axis2)

CXF Apache ([Link])

XFire Codehaus ([Link])

JBossWS JBoss ([Link]/jbossws) JAX-WS - M. Baron - Page 7
 Généralités JAX-WS

JAX-WS est l’acronyme Java API for XML Web Services

JAX-WS est à la fois un standard et une implémentation

La version courante est JAX-WS 2.0, précédemment JAX-WS

s’appelait JAX-RPC

JAX-WS s’appuie sur un ensemble de JSR

JSR 224 : JAX-WS

[Link]

JSR 181 : Web Services Metadata

JSR 222 : JAXB

JSR 250 : Common Annotations

JAX-WS - M. Baron - Page 8
 Généralités JAX-WS

L’implémentation de référence est fournie par METRO

appelée également JAX-WS RI (Reference Implementation)

Site projet Metro : [Link]

WSIT (Web Services Interoperability Technologies) est un

complément pour gérer les Web Services avancés (WS-*)

Site projet WSIT : [Link]

L’implémentation JAX-WS est intégrée nativement à la JRE

depuis la version 6
[Link]

Il est possible de développer des Web Services en dehors

d’un serveur d’application en mode autonome (étudié à la
fin de ce support de cours)
JAX-WS - M. Baron - Page 9
 Généralités JAX-WS

Développement de
clients dans des Description

Approche Top / Down

langages différents du Web
Service
Document WSDL

WSDL
JAVA

Servlet JAX-WS
PHP SOAP

Approche Bottom / Up
.NET Serveur
Web Conteneur Java
Classes JAVA annotées
[Link]

implémentant le
Web Service

Utilisation du Web
Service par envoie /
Couche Cliente
réception de messages Couche Serveur
SOAP
JAX-WS - M. Baron - Page 10
 Généralités JAX-WS

Le développement de Web Services avec JAX-WS est basé

sur des POJO (Plain Old Java Object)

Les fonctionnalités de base pour le développement de Web

Services avec JAX-WS requiert simplement l’utilisation
d’annotations Java

Par conséquent aucun fichier de déploiement n’est requis

Toutefois, les fonctionnalités avancées (appels asynchrones)

[Link]

nécessitent d’utiliser une API

JAX-WS permet d’assurer l’indépendance du protocole

(SOAP) et du transport (HTTP) JAX-WS - M. Baron - Page 11
 Développement Serveur : généralités

Deux façons pour développer un Web Service avec JAX-WS

Approche Top / Down (à partir d’un document WSDL)

Génération des différentes classes Java (JAXB et squelette du Web
Service) en utilisant l’outil wsimport

Compléter le squelette de classe de l’implémentation

Compiler, déployer et tester

Approche Bottom / Up (à partir d’un POJO)

[Link]

Créer et annoter un POJO

Compiler, déployer et tester

Le document WSDL est automatiquement généré

JAX-WS - M. Baron - Page 12
 Développement Serveur : Bottom / Up

WSDL 1
UnMarshall

Servlet JAXB
Marshall
SOAP

Serveur
Web
1
Classes Java décrivant
Request / Response

Approche Bottom / Up
JAX-WS
Conteneur Java

Classes JAVA annotées

[Link]

implémentant le
Web Service

Légende
Couche Serveur
Générer implicitement
1
par l’outil WSGEN
JAX-WS - M. Baron - Page 13
 Développement Serveur : Bottom / Up

L’approche Bottom / Up consiste à démarrer le développe-

ment à partir d’une classe Java (POJO)

Ajouter l’annotation @WebService

Déployer l’application sur un serveur d’application (ou via
directement Java SE 6)

Le document WSDL est généré automatiquement en
respectant les valeurs par défauts

URL du WSDL : [Link]
[Link]

Toutes les méthodes du POJO sont des opérations du Web

Service

La surcharge de méthodes n’est pas supportée
JAX-WS - M. Baron - Page 14
 Développement Serveur : Bottom / Up

Exemple : Implémentation du Web Service HelloWorld

Le package fait parti intégrante
de la JRE 6

Deux opérations sont définies

package [Link]; dans la classe HelloWorldService
import [Link];

@WebService
public class HelloWorldService {
L’opération makeHelloWorld
public String makeHelloWorld(String value) { contenant un message input et
return "Hello World to " + value;
} un message output
public String simpleHelloWorld() {
return "Hello World to everybody";
}
[Link]

L’opération simpleHelloWorld
contenant un message output
uniquement
[Link] du projet
HelloWorldQuietWebService

JAX-WS - M. Baron - Page 15

 Développement Serveur : Bottom / Up

Exemple (suite) : Implémentation du Web Service HelloWorld

[Link]

Document WSDL du
Web Service développé

JAX-WS - M. Baron - Page 16

 Développement Serveur : Bottom / Up

Exemple : Paramétrer le Web Service HelloWorld

package [Link];

@WebService(name="HelloWorld",targetNamespace="[Link]
@SOAPBinding(style=[Link], use=[Link])
public interface HelloWorldService {
Utilisation d’une interface pour
définir les paramètres du Web
@WebMethod(operationName="makeHelloWorld")
@WebResult(name="helloWorldResult")
Service
public String makeHelloWorld(
@WebParam(name = "value")String value);

@WebMethod(operationName="simpleHelloWorld") [Link] du projet

@WebResult(name="helloWorldResult")
public String simpleHelloWorld(); HelloWorldWebService
}
package [Link];

@WebService(endpointInterface="[Link]",
serviceName="HelloWorld", portName="HelloWorldPort")
public class HelloWorldServiceImpl implements HelloWorldService {

public String makeHelloWorld(String value) {

[Link]

return "Hello World to " + value;

}

public String simpleHelloWorld() {

}
return "Hello World to everybody";
Classe qui fournit
} l’implémentation du Web Service
[Link] du projet
HelloWorldWebService JAX-WS - M. Baron - Page 17
 Développement Serveur : Bottom / Up

Exemple (bis) : Paramétrer le Web Service HelloWorld

package [Link];

@WebService(name="HelloWorld",targetNamespace="[Link]
@SOAPBinding(style=[Link], use=[Link])
public interface HelloWorldService {
Utilisation d’une interface pour
définir les paramètres du Web
@WebMethod(operationName="makeHelloWorld")
@WebResult(name="helloWorldResult")
Service
public String makeHelloWorld(
@WebParam(name = "value")String value);

@WebMethod(operationName="simpleHelloWorld") [Link] du projet

@WebResult(name="helloWorldResult")
public String simpleHelloWorld(); HelloWorldWebService
}
package [Link];

@WebService(endpointInterface="[Link]",
serviceName="HelloWorld", portName="HelloWorldPort")
public class HelloWorldServiceImpl {
Pas nécessaire d’indiquer
public String makeHelloWorld(String value) {
[Link]

return "Hello World to " + value; l’implémentation puisqu’elle

} est précisée dans l’annotation
public String simpleHelloWorld() { (vérification à l’exécution)
return "Hello World to everybody";
}
} Classe qui fournit
[Link] du projet l’implémentation du Web Service
HelloWorldWebService JAX-WS - M. Baron - Page 18
 Développement Serveur : Bottom / Up

Comme indiqué précédemment, la JRE 6 fournit des API et

des outils pour manipuler des Web Services

L’outil wsgen génère des artifacts (JAXB, WSDL) à partir de
classes Java annotées via JAX-WS

L’utilisation de cet outil n’est pas obligatoire puisque cette
génération est implicite lors de l’exécution

Exemples d’utilisation
wsgen –cp . [Link] –keep

Génère les classes Java annotées JAXB

[Link]

(marshall et unmarshall)

wsgen –cp . [Link] –keep -wsdl

Nécessite la dépendance vers la Génère le document WSDL

bibliothèque [Link]
JAX-WS - M. Baron - Page 19
 Développement Serveur : Bottom / Up

Exemple : wsgen avec Maven 2

<project ...>
...
<dependencies>
<dependency>
<groupId>[Link]</groupId>
Implémentation JAX-WS
<artifactId>jaxws-rt</artifactId>
<version>2.1.7</version>
</dependency>
</dependencies>
Plug-in à utiliser pour la
<build><plugins><plugin> génération des artifacts
<groupId>[Link]</groupId>
<artifactId>jaxws-maven-plugin</artifactId>
<executions><execution>
<goals><goal>wsgen</goal></goals>
<configuration>
<sei>[Link]</sei>
<genWsdl>true</genWsdl>
<keep>true</keep>
</configuration>
</execution></executions>
Demande génération des
</plugin></plugins></build> ressources par rapport à la
<repositories>
<repository> classe HelloWorldService
<id>[Link]</id>
<name>[Link] Repository for Maven 1</name>
<url>[Link] Nécessaire pour le
[Link]

<layout>legacy</layout>
</repository> téléchargement des
<repository>
<id>[Link]</id> dépendances
<name>[Link] Repository for Maven 2</name>
<url>[Link]
</repository>
</repositories>
</project>

[Link] du projet
HelloWorldQuietWebService JAX-WS - M. Baron - Page 20
 Développement Serveur : Bottom / Up

Un Web Service est déployé dans une application Web (un

Web Service par application Web)

Différentes catégories de serveur d’application pour gérer les
Web Services avec JAX-WS

Conteneur respectant JSR 109 (Implementing Entreprise Web Services)

La gestion du Web Service est transparente et maintenue par le
serveur d’application

Exemple : Glassfish

[Link]

Conteneur nécessitant une gestion par Servlet
[Link]

Nécessite une configuration explicite du Web Service

Exemple : Tomcat

Note : un composant additionnel se propose de fournir le support
JSR 109 ([Link]
JAX-WS - M. Baron - Page 21
 Développement Serveur : Bottom / Up

Dans le cas d’un conteneur dont la gestion du Web Service

est gérée par une Servlet

[Link] : précise la Servlet assurant la gestion

[Link] : utilisé pour effectuer une relation entre le contexte de
l’application et la classe du Web Service

Structure d’une application Web fournissant un Web Service
*.html, *.jsp, ... Respecter scrupuleusement la
hiérarchie des répertoires et
le nom des fichiers
[Link]
WEB-INF
[Link]
Fichiers pour la présentation
[Link]

classes *.class
Fichiers de configuration

Classes des Web Services

*.jar, *.class
lib Bibliothèques tiers
JAX-WS - M. Baron - Page 22
 Développement Serveur : Bottom / Up

Exemple : Tomcat et le fichier de configuration [Link]

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

<web-app version="2.4" xmlns="[Link]

xmlns:xsi="[Link]
xsi:schemaLocation="[Link] [Link]
<description>HelloWorld</description>
<display-name>HelloWorld</display-name>
<listener>
<listener-class>[Link]</listener-class>
</listener>
<servlet> Servlet assurant la gestion du
<description>JAX-WS endpoint - helloworld</description>
<display-name>helloworld</display-name>
Web Service
<servlet-name>helloworld</servlet-name>
<servlet-class>[Link]</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>helloworld</servlet-name>
<url-pattern>/helloworld</url-pattern>
[Link]

</servlet-mapping>
<session-config>
<session-timeout>60</session-timeout> La Servlet est accessible
</session-config>
</web-app> via cette URL

[Link] du projet
HelloWorldWebService JAX-WS - M. Baron - Page 23
 Développement Serveur : Bottom / Up

Exemple : Tomcat et le fichier de configuration [Link]

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

<endpoints xmlns='[Link] version='2.0'>

<endpoint
name='helloworld'
implementation='[Link]'
url-pattern='/helloworld'/>
</endpoints>

[Link] du projet Relation entre la classe

HelloWorldWebService implémentant le Web Service et
la Servlet assurant sa gestion
[Link]

Le fichier [Link] est également

utilisé pour ajouter des informations
supplémentaires (wsdl, binding, …)

JAX-WS - M. Baron - Page 24

 Développement Serveur : Top / Down

Document WSDL
décrivant le Web Service

Approche Top / Down

à implémenter

2
Classes Java décrivant
Request / Response

~ Proxy du
WSDL 1 WebService
UnMarshall
2
Interface Java
Servlet JAXB du PortType
Marshall
SOAP
[Link]

JAX-WS
Serveur Conteneur Java
Web
Classes JAVA
Cette classe décrit le
Légende annotées
traitement du Web Service
implémentant le
Générer implicitement Web Service
1
par l’outil WSGEN
Générer explicitement
2 Couche Serveur
par l’outil WSIMPORT JAX-WS - M. Baron - Page 25
 Développement Serveur : Top / Down

L’approche Top / Down consiste à démarrer le développe-

ment à partir d’un document WSDL

Le document WSDL est accessible via une URL ou via un
fichier physique

Utilisation explicite de l’outil wsimport pour la génération du
squelette du Web Service

Génération des classes liées à JAXB

Génération des interfaces WS (interface décrivant le PortType)

Création d’un POJO annotée @WebService en précisant
[Link]

l’emplacement de l’interface du portType (Proxy)

Déployer l’application sur un serveur d’application

Le reste du processus de développement est identique à
celui de l’approche Bottom / Up JAX-WS - M. Baron - Page 26
 Développement Serveur : Top / Down

Exemple : Développer le Web Service Notebook à partir

du document WSDL
<?xml version="1.0" encoding="UTF-8"?>
<definitions ...>
<types>...</types>
<portType name="Notebook">
<operation name="addPersonWithComplexType">
<input message="tns:addPersonWithComplexType"/>
<output message="tns:addPersonWithComplexTypeResponse"/>
</operation>
<operation name="getPersonByName">
<input message="tns:getPersonByName"/>
<output message="tns:getPersonByNameResponse"/>
</operation>
WSDL utilisé pour
<operation name="getPersons"> générer le
<input message="tns:getPersons"/>
<output message="tns:getPersonsResponse"/> squelette du Web
</operation> Service
<operation name="addPersonWithSimpleType">
<input message="tns:addPersonWithSimpleType"/>
</operation>
[Link]

</portType>
<binding name="NoteBookPortBinding" type="tns:Notebook">...</binding>
<service name="Notebook">...</service>
</definitions>

Document WSDL issu du Web

Service Notebook (Projet
NotebookWebService)
JAX-WS - M. Baron - Page 27
 Développement Serveur : Top / Down

Exemple (suite) : Développer le Web Service Notebook à

partir du document WSDL
Pour chaque type défini dans le
WSDL une classe Java (JAXB) est
générée
Classes Java
Générées

L’interface Notebook
définit la classe Java
annotée avec JAX-WS

@WebService(name = "Notebook", targetNamespace = "[Link]

@XmlSeeAlso({[Link]})
public interface Notebook {
[Link]

@WebMethod
@WebResult(name = "addPersonWithComplexTypeResult", targetNamespace = "")
@RequestWrapper(localName = "addPersonWithComplexType", targetNamespace = "[Link]
className = "[Link]")
@ResponseWrapper(localName = "addPersonWithComplexTypeResponse", targetNamespace = "[Link]
className = "[Link]")
public boolean addPersonWithComplexType(
@WebParam(name = "newPerson", targetNamespace = "")Person newPerson);

...
} Interface [Link] du projet
NotebookWebServiceFromWSDL
JAX-WS - M. Baron - Page 28
 Développement Serveur : Top / Down

Exemple (suite) : Développer le Web Service Notebook à

partir du document WSDL
@WebService(endpointInterface = "[Link]")
public class NotebookServiceImpl {
public boolean addPersonWithComplexType(Person newPerson) {
...
L’utilisation du mot clé implémentation
}
return true; n’est pas obligatoire, l’annotation se
charge d’effectuer cette relation
public Person getPersonByName(String name) {
Person current = new Person();
[Link](name);
[Link]("1976");
[Link]("17 Square Mickael BARON");
return current;
}

public List<Person> getPersons() { Implémentation du traitement

Person first = new Person();
[Link]("Ken BLOCK");
du Web Service (Non généré
[Link]("1967");
[Link]("United States");
à développer)
Person second = new Person();
[Link]("Colin MCRAE");
[Link]("1968");
[Link]("Scotland");
[Link]

List<Person> tabPerson = new ArrayList<Person>();

[Link](first);
[Link](second);
return tabPerson;
[Link] du projet
} NotebookWebServiceFromWSDL
public void addPersonWithSimpleType(String name, String address, String birthyear) {
[Link]("Name : " + name + " Address : " + address + " birthyear : " + birthyear);
}
}

JAX-WS - M. Baron - Page 29

 Développement Serveur : Top / Down

Exemple : wsimport avec Maven 2

<project ...>
...
<dependencies>
<dependency> Plug-in à utiliser pour la
<groupId>[Link]</groupId>
<artifactId>jaxws-rt</artifactId> génération des classes Java
<version>2.1.7</version>
</dependency>
</dependencies>
<build><plugins><plugin>
<groupId>[Link]</groupId>
<artifactId>jaxws-maven-plugin</artifactId>
<executions> <execution>
Le fichier WSDL se trouve
<goals><goal>wsimport</goal></goals>
<configuration>
physiquement dans un
<wsdlDirectory>${basedir}/src/wsdl</wsdlDirectory> répertoire WSDL (peut se
<genWsdl>true</genWsdl>
<keep>true</keep> trouver sur le réseau
<packageName>[Link]</packageName>
</configuration> également)
</execution> </executions>
</plugin></plugins></build>
<repositories>
<repository>
<id>[Link]</id>
<name>[Link] Repository for Maven 1</name>
[Link]

<url>[Link]
<layout>legacy</layout> Package par défaut des
</repository>
<repository> classes générées
<id>[Link]</id>
<name>[Link] Repository for Maven 2</name>
<url>[Link]
</repository>
</repositories>
</project>

[Link] du projet
NotebookWebServiceFromWSDL JAX-WS - M. Baron - Page 30
 Développement Client Java

JVM Java Client Description

du Web
Service
1
Classes Java
décrivant JAXB
Request / Response
WSDL

UnMarshall Marshall Servlet

1
Interface Java Classe Java du SOAP
du PortType Service
1
JAX-WS Serveur
Web Conteneur Java

Cette classe s’occupe

d’effectuer la transformation Utilisation du Web Service
objet / xml et d’envoyer les par envoie / réception de
[Link]

paquets SOAP
messages SOAP

Cette classe décrit le

programme qui appel le
Légende Web Service

Générer explicitement Couche Cliente Couche Serveur

1
par l’outil WSIMPORT
JAX-WS - M. Baron - Page 31
 Développement Client Java

Le développement du client consiste à appeler des opérations

du Web Service à partir d’un programme Java

Le client peut être une application développée

Java SE (Swing, Eclipse RCP)

Java EE avec les EJB (JSP, Servlet, …) (voir section EJB)

Possibilité de générer des appels aux Web Services de

[Link]

manière synchrone et asynchrone

Le développeur ne manipule que du code Java, le code XML

est caché (JAXB) JAX-WS - M. Baron - Page 32
 Développement Client Java

Le développement du client suit une procédure similaire à

l’approche Top / Down où le point de départ est le document
WSDL (via une URL ou via un fichier physique)

Utilisation explicite de l’outil wsimport pour la génération du

squelette du Web Service

Génération des classes liées à JAXB

Génération de classes Web Service (PortType et Service)

[Link]

Création d’une instance de la classe Service

Récupération d’un port via get<ServiceName>Port()

Invocation des opérations JAX-WS - M. Baron - Page 33

 Développement Client Java

Exemple : Développer un client Java (Synchrone) pour le

Web Service Notebook

Pour chaque type défini dans le

WSDL une classe Java (JAXB) est
générée
Classes Java
Générées

La classe Service s’occupe de gérer

les appels distants au Web Service
[Link]

Le résultat de la génération est identique à

la génération effectuée pour l’approche
Top / Down

JAX-WS - M. Baron - Page 34

 Développement Client Java

Exemple (suite) : Développer un client Java (Synchrone)

pour le Web Service Notebook
Création d’une instance de la
classe Service

public class NotebookClient {

public static void main(String[] args) {
Notebook_Service notebook_Service = new Notebook_Service();
Notebook noteBookPort = notebook_Service.getNoteBookPort();
Récupération d’un
Person refPerson = new Person();
[Link]("Baron Mickael");
port via
[Link]("Poitiers"); getNoteBookPort()
[Link]("1976");

boolean addPersonWithComplexType = [Link](refPerson);

[Link](addPersonWithComplexType);
}
}
[Link]

Appel de l’opération du Web Service

[Link] du projet
NotebookWebServiceClient

JAX-WS - M. Baron - Page 35

 Développement Client Java

Exemple (suite) : Développer un client Java (Synchrone)

pour le Web Service Notebook
@WebService(endpointInterface = "[Link]")
public class NotebookServiceImpl {
public boolean addPersonWithComplexType(Person newPerson) {
[Link]("Starting process ...");
Le traitement du Web
try {
[Link](5000);
Service peut prendre un
} catch (InterruptedException e) { certain temps
[Link]();
}

[Link]("Name : " + [Link]() + " Address : " + [Link]() +

" birthyear : " + [Link]());

return true;
}
...
}
[Link]

Dans le cas où le temps de

[Link] du projet réponse d’un Web Service est
NotebookWebService particulièrement long, prévoir
un appel asynchrone
JAX-WS - M. Baron - Page 36
 Développement Client Java

Si le temps de réponse de l’appel à une opération d’un Web

Service est long, prévoir un appel asynchrone

JAX-WS permet d’appeler des Web Services en mode

asynchrone si l’information est précisée dans le binding

Lors de la génération des fichiers classes (via wsimport)

fournir un fichier binding suivant

[Link]

<?xml version="1.0" encoding="ISO-8859-1"?>

<bindings wsdlLocation="[Link]
xmlns="[Link]
<enableAsyncMapping>true</enableAsyncMapping>
</bindings>

JAX-WS - M. Baron - Page 37

 Développement Client Java

Exemple : Développer un client Java (Asynchrone) pour le

Web Service Notebook
public class NotebookAsyncClient {
public static void main(String[] args) {
Notebook_Service notebook_Service = new Notebook_Service();
Notebook noteBookPort = notebook_Service.getNoteBookPort();

Person refPerson = new Person();

Des méthodes spécifiques au mode
[Link]("Baron Mickael"); asynchrone sont générées
[Link]("Poitiers");
[Link]("1976");

[Link](refPerson, new AsyncHandler<AddPersonWithComplexTypeResponse>() {

public void handleResponse(Response<AddPersonWithComplexTypeResponse> res) {
if (![Link]() && [Link]()) {
try {
AddPersonWithComplexTypeResponse value = [Link]();
[Link]([Link]());
} catch (Exception e) {
[Link]();
}
}
} Déclenché quand le traitement
}
); de l’opération sera terminé
[Link]

try {
[Link](10000);
} catch (InterruptedException e) {
[Link]();
}
[Link]("Terminé");
Pour éviter de terminer le
} programme
}

[Link] du projet
NotebookWebServiceAsyncClient JAX-WS - M. Baron - Page 38
 Annotations : généralités

JAX-WS repose sur l’utilisation massive d’annotations pour

la configuration d’un Web Service

JSR utilisées (JSR 224, 222, 181 et 250)

Les principales annotations sont les suivantes

@WebService : POJO implémentant un Web Service

@WebMethod : Paramétrer une opération

@WebParam : Paramétrer un message

@WebResult : Paramétrer un message de sortie

@WebFault : Paramétrer un message fault
[Link]

A noter que seule l’utilisation de l’annotation @WebService

est nécessaire (utilisation de valeurs par défaut)

Nous détaillerons chacune des annotations de manière à
découvrir les paramètres disponibles JAX-WS - M. Baron - Page 39
 Annotations : @WebService

Annote une classe Java pour définir l’implémentation du

Web Service

Annote une interface Java pour définir la description du
Web Service

Attributs de l’annotation @WebService

String name : nom du Web Service

String endpointInterface : nom de l’interface décrivant le Web Service

String portName : nom du port
[Link]

String serviceName : nom du service du Web Service

String targetNamespace : le namespace du Web Service

String wsdlLocation : l’emplacement du WSDL décrivant le Web
Service JAX-WS - M. Baron - Page 40
 Annotations : @WebMethod

Annote une méthode d’une classe Java exposée comme une

opération du Web Service

Attributs de l’annotation : @WebMethod

String action : l’action de l’opération. Dans le cas d’un binding SOAP,

cela détermine la valeur de l’action SOAP

boolean exclude : précise que la méthode ne doit pas être exposée

[Link]

comme une opération. Ne pas utiliser dans une interface Java

String operationName : précise le nom de l’attribut name défini dans

l’élément operation du document WSDL

JAX-WS - M. Baron - Page 41
 Annotations : @WebParam

Décrit la relation entre un paramètre d’entrée d’une métho-

de et un message part d’une opération

Attributs de l’annotation

boolean header : précise si le paramètre doit être transmis dans
l’en-tête du message (true) ou dans le corps (false)

[Link] mode : précise le type d’accès au paramètre (IN,

OUT ou INOUT)
[Link]

String name : nom du paramètre

String partName : le nom du wsdl:part représentant ce paramètre

String targetNamespace : l’espace de nommage de ce paramètre

JAX-WS - M. Baron - Page 42
 Annotations : @WebResult

Décrit la relation entre le paramètre de sortie d’une métho-

de et un message part d’une opération

Attributs de l’annotation

boolean header : précise si le paramètre de sortie doit être transmis

dans l’en-tête du message (true) ou dans le corps (false)

String name : nom du paramètre de sortie

String partName : le nom du wsdl:part représentant ce paramètre de

[Link]

sortie

String targetNamespace : l’espace de nommage de ce paramètre de

sortie JAX-WS - M. Baron - Page 43

 Handler : généralités

Les « handlers » sont des intercepteurs permettant de

réaliser des traitements lors de la réception et l’émission de
messages

Lors de la réception ils sont déclenchés avant l’appel à une opération

Lors de l’émission ils sont déclenchés après l’appel à une opération

Un « hander » est disponible dans la couche JAX-WS et par
conséquent autant sur la partie cliente que celle du serveur

Quand l’utiliser ?

Pour filtrer les appels aux opérations d’un Web Service

Pour l’écriture des logs
[Link]

Deux types de « handlers »

Handlers liés au protocole de transport (ex : SOAP)

Handlers liés au contenu transféré appelé logical handlers qui est
indépendant du protocole JAX-WS - M. Baron - Page 44
 Handler : généralités

JAX-WS définit l’interface Handler contenant les principales

méthodes

boolean handleMessage(C context) : invoquée lors des messages
entrants et sortants. Si false est retourné le processus est arrêté

boolean handleFault(C context) : invoquée lors des messages en
erreur (fault)

Le type générique C hérite de MessageContext qui est une

Map contenant un ensemble de propriétés

MESSAGE_OUTBOUND_PROPERTY : pour savoir s’il s’agit de messages
entrants ou sortants
[Link]

HTTP_REQUEST_HEADERS : pour récupérer l’en-tête HTTP de la

réquête

WSDL_OPERATION : nom de l’opération WSDL

WSDL_SERVICE : nom du service WSDL JAX-WS - M. Baron - Page 45
 Handler : généralités

Deux sous interfaces à handler sont proposées pour décrire

chaque type de « handler »

SOAPHandler a un accès sur l’intégralité du message
SOAP incluant les en-têtes

LogicalHandler pour une indépendance du protocole de
transport et un accès sur le contenu du message

SOAP En-tête SOAP

MessageContext (header facultatif)
Logical
SOAP Message
[Link]

MessageContext
Corps du message SOAP
(body) Logical Message

Enveloppe SOAP

JAX-WS - M. Baron - Page 46

 Handler : côté Serveur

Développement d’une classe Java qui implémente soit

l’interface SOAPHandler soit LogicalHandler

Définir un fichier de correspondance ([Link]) qui

précise les classes implémentant les handlers

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

<handler-chains xmlns="[Link]
<handler-chain>
<handler>
<handler-name>NOM DU HANDLER</handler-name>
<handler-class>CLASSE DU HANDLER</handler-class>
</handler>
</handler-chain>
[Link]

</handler-chains>

Ajouter l’annotation @HandlerChain sur le POJO du Web

Service
JAX-WS - M. Baron - Page 47
 Handler : côté Serveur

Exemple : Ajouter un handler de type SOAPHandler sur le

Web Service Notebook
public class SOAPLoggingHandler implements SOAPHandler<SOAPMessageContext> {

private static PrintStream out = [Link];

public Set<QName> getHeaders() { return null; }

public void close(MessageContext context) { }

public boolean handleMessage(SOAPMessageContext smc) {

logToSystemOut(smc);
return true;
}
public boolean handleFault(SOAPMessageContext smc) {
logToSystemOut(smc);
return true;
}

private void logToSystemOut(SOAPMessageContext smc) {

Boolean outboundProperty = (Boolean) [Link](MessageContext.MESSAGE_OUTBOUND_PROPERTY);
if ([Link]()) {
[Link]("\nOutgoing message from web service provider:");
} else {
[Link]("\nIncoming message to web service provider:");
}
[Link]

SOAPMessage message = [Link]();

try {
[Link](out);
[Link]("");
} catch (Exception e) {
[Link]("Exception in handler: " + e);
}
}
}

[Link] du projet
NotebookWebServiceWithSOAPHandler JAX-WS - M. Baron - Page 48
 Handler : côté Serveur

Exemple (suite) : Ajouter un handler de type SOAPHandler

sur le Web Service Notebook
<?xml version="1.0" encoding="UTF-8"?>
<handler-chains xmlns="[Link] [Link] du projet
<handler-chain>
<handler>
NotebookWebServiceWithSOAPHandler
<handler-name>[Link]</handler-name>
<handler-class>[Link]</handler-class>
</handler>
</handler-chain>
</handler-chains>

@WebService(endpointInterface = "[Link]")
@HandlerChain(file = "[Link]")
public class NotebookServiceImpl {
public boolean addPersonWithComplexType(Person newPerson) {
...
}

public Person getPersonByName(String name) {

...
}
[Link]

public List<Person> getPersons() {

...
}

public void addPersonWithSimpleType(String name, String address, String birthyear) {

...
}
}

[Link] du projet
NotebookWebServiceWithSOAPHandler JAX-WS - M. Baron - Page 49
 Handler : côté Serveur

Exemple (suite) : Ajouter un handler de type SOAPHandler

sur le Web Service Notebook
Les messages entrants et sortants
sont affichés avec la structure de
l’enveloppe SOAP
[Link]

JAX-WS - M. Baron - Page 50

 Handler : côté Client

Exemple : Ajouter un handler de type SOAPHandler sur le

client du Web Service Notebook
public class SOAPLoggingHandler implements SOAPHandler<SOAPMessageContext> {

private static PrintStream out = [Link];

public Set<QName> getHeaders() { return null; }

public void close(MessageContext context) { }

public boolean handleMessage(SOAPMessageContext smc) {

logToSystemOut(smc);
return true;
}
public boolean handleFault(SOAPMessageContext smc) {
logToSystemOut(smc);
return true;
}

private void logToSystemOut(SOAPMessageContext smc) {

Boolean outboundProperty = (Boolean) [Link](MessageContext.MESSAGE_OUTBOUND_PROPERTY);
if ([Link]()) {
[Link]("\nOutgoing message from web service client:");
} else {
[Link]("\nIncoming message to web service client:");
}
[Link]

SOAPMessage message = [Link]();

try {
[Link](out);
[Link]("");
} catch (Exception e) {
[Link]("Exception in handler: " + e);
}
}
}

[Link] du projet
NotebookWebServiceClientWithSOAPHandler JAX-WS - M. Baron - Page 51
 Handler : côté Client

Exemple (suite) : Ajouter un handler de type SOAPHandler

sur le client du Web Service Notebook
public class NotebookClient {
public static void main(String[] args) {
Notebook_Service notebook_Service = new Notebook_Service();
Notebook noteBookPort = notebook_Service.getNoteBookPort();

List<Handler> myHandler = new ArrayList<Handler>();

[Link](new SOAPLoggingHandler());

((BindingProvider)noteBookPort).getBinding().setHandlerChain(myHandler);

Person refPerson = new Person();

[Link]("Baron Mickael");
[Link]("Poitiers");
[Link]("1976");
boolean addPersonWithComplexType = [Link](refPerson);
[Link](addPersonWithComplexType);
}
}

[Link] du projet
[Link]

NotebookWebServiceClientWithSOAPHandler

JAX-WS - M. Baron - Page 52

 Web Service avec Java 6 : généralités

Précédemment nous avons vu comment développer un

client pour appeler un Web Service

Le développement serveur est possible directement à partir
de Java SE 6 puisqu’il intègre un serveur Web embarqué

Inutile de gérer un serveur Web (Tomcat, Glassfish)

Le déploiement est immédiat

Les deux approches (Top / Down et Bottom / Up) sont

applicables à ce mode de développement

Usages
[Link]

Fournir des Web Service à une application type client lourd

Pour les tests unitaires, fournir des Mock de Web Services

A noter que le développement du client reste similaire à ce
qui a été présenté précédemment JAX-WS - M. Baron - Page 53
 Web Service avec Java 6 : serveur

Développer une classe Java implémentant le Web Service

(ou à partir d’un WSDL et en utilisant wsimport)

Ajouter l’annotation @WebService

Créer explicitement une instance du POJO

Publier le Web Service par l’intermédiaire de la méthode
Endpoint [Link](String adresse, Object implementor)

Le document WSDL est généré automatiquement à

l’exécution de l’application
[Link]

URL du WSDL : [Link]

Toutes les méthodes du POJO sont des opérations du Web
Service JAX-WS - M. Baron - Page 54
 Web Service avec Java 6 : serveur

La méthode publish est utilisée pour démarrer la publication

du Web Service

String adresse : adresse de déploiement du Web Service depuis le

serveur Web embarqué ([Link]

Object implementor : instance de l’implémentation du Web Service

Différentes méthodes proposées par la classe Endpoint (type

[Link]

de retour de la méthode publish)

boolean isPublished() : vérifie si le service est en publication

void stop() : arrête la publication du Web Service

JAX-WS - M. Baron - Page 55
 Web Service avec Java 6 : serveur

Exemple : Publier le web service Notebook à partir de

Java SE 6
@WebService(name="Notebook",targetNamespace="[Link]
@SOAPBinding(style=[Link],use=[Link])
public interface NotebookService {
@WebMethod(operationName="addPersonWithComplexType")
@WebResult(name="addPersonWithComplexTypeResult")
public boolean addPersonWithComplexType(
@WebParam(name = "newPerson")Person newPerson);
...
}

Interface [Link] du projet

NotebookWebServiceFromJavaSE

@WebService(endpointInterface="[Link]",
serviceName="Notebook",
portName="NoteBookPort")
public class NotebookServiceImpl implements NotebookService {
@Override
[Link]

public boolean addPersonWithComplexType(Person newPerson) { ... }

@Override
public Person getPersonByName(String name) { ... }
@Override
public Person[] getPersons() { ... }
@Override
public void addPersonWithSimpleType(String name, String address, String birthyear) { ... }
}

Classe [Link] du projet

NotebookWebServiceFromJavaSE JAX-WS - M. Baron - Page 56
 Web Service avec Java 6 : serveur

Exemple (suite) : Publier le web service Notebook à partir de

Java SE 6
public class NotebookServicePublish extends JFrame {
private Endpoint publish;
public NotebookServicePublish() {
final JButton startPublish = new JButton();
[Link]("Start Publish");
final JButton stopPublish = new JButton();
[Link]("Stop Publish");

[Link](new ActionListener() {
public void actionPerformed(ActionEvent e) {
NotebookService current = new NotebookServiceImpl();
publish = [Link]("[Link] current);
[Link](false);
[Link](true);
} Utilisée pour publier le Web
});
Service
[Link](new ActionListener() {
public void actionPerformed(ActionEvent e) {
[Link]();
[Link]

[Link](false);
[Link](true);
} Utilisée arrêter la publication
});
du Web Service
...
}
public static void main(String[] args) {
new NotebookServicePublish();
}
} Classe [Link] du projet
NotebookWebServiceFromJavaSE JAX-WS - M. Baron - Page 57
 Web Service avec les EJB : généralités

A partir d’un EJB Session, il est possible de définir le POJO

associé comme étant un Web Service

Pour rappel, l’appel à un EJB Session passe obligatoirement
par un client écrit en Java

Les avantages à transformer en EJB Session en Web Service

Caractéristiques des EJBs (transactions, sécurité, scalabilité, …)

Plus grande hétérogénéité, le client n’est pas forcément écrit en Java

Réutilisabilité du code
[Link]

Modularité (avec les annotations JAX-WS possibilité de masquer les

méthodes qui ne doivent pas être découvertes)

Nécessite d’avoir un conteneur EJB pour le déploiement

Glassfish, OpenEJB, … JAX-WS - M. Baron - Page 58
 Web Service avec les EJB : serveur

Partir d’une classe Java définissant un EJB Session (statefull

ou stateless)

Ajouter l’annotation @WebService

Déployer l’application sur un serveur d’application ayant le
support EJB (Glassfish par exemple)

Le conteneur EJB s’occupe de la gestion du Web Service,
aucune Servlet n’est nécessaire

Le document WSDL est généré automatiquement en
[Link]

respectant les valeurs par défauts

URL du WSDL : [Link]

Toutes les méthodes de l’EJB sont par défaut des opérations

du Web Service JAX-WS - M. Baron - Page 59
 Web Service avec les EJB : serveur

Exemple : Définir un EJB Stateless comme étant un Web

Service Seule l’annotation @Stateless a été ajoutée
@Stateless
@WebService(endpointInterface = "[Link]")
public class NotebookServiceImpl {
public boolean addPersonWithComplexType(Person newPerson) {
...
return true;
}

public Person getPersonByName(String name) {

Person current = new Person();
[Link](name);
[Link]("1976");
[Link]("17 Square Mickael BARON");
return current;
} Le reste du code est le même
public List<Person> getPersons() { que dans les exemples
Person first = new Person();
... précédents
Person second = new Person();
...

List<Person> tabPerson = new ArrayList<Person>();

[Link]

[Link](first);
[Link](second);
return tabPerson;
}

public void addPersonWithSimpleType(String name, String address, String birthyear) {

[Link]("Name : " + name + " Address : " + address + " birthyear : " + birthyear);
}
}

Classe [Link] du projet

NotebookWebServiceFromEJB JAX-WS - M. Baron - Page 60
 Web Service avec les EJB : client

Le développement du client est similaire au client développé

précédemment où le point de départ est le document
WSDL (via une URL ou via un fichier physique)

Utilisation explicite de l’outil wsimport pour la génération du
squelette du Web Service

Génération des classes liées à JAXB

Génération de classes Web Service (PortType et Service)

Injecter un @WebServiceReference pour récupérer une

[Link]

instance du Service à partir du conteneur EJB

Récupération d’un port via get<ServiceName>Port()

Invocation des opérations JAX-WS - M. Baron - Page 61
 Web Service avec les EJB : client

Exemple : appel d’un Web Service à partir d’une Servlet

public class NotebookWebServiceFromEJBClientServlet extends HttpServlet {

@WebServiceRef(wsdlLocation = "[Link]
private Notebook_Service service;

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

[Link]("text/html;charset=UTF-8");
PrintWriter out = [Link](); La référence à
try {
[Link]("<html>");
Notebook_Service est donnée
[Link]("<head>");
par le conteneur EJB
[Link]("<title>Servlet NotebookWebServiceFromEJBClientServlet</title>");
[Link]("</head>");
[Link]("<body>");
[Link]("<h1>Servlet NotebookWebServiceFromEJBClientServlet at " + [Link]() + "</h1>");

try {
Notebook port = [Link]();
Person newPerson = new Person();
[Link]("BARON Mickael");
[Link]("Poitiers");
[Link]("1976");
boolean result = [Link](newPerson);
[Link]("<div>Result = " + result + "</div>");
} catch (Exception ex) {
[Link]

[Link]();
}
[Link]("</body>");
[Link]("</html>");
} finally {
[Link]();
}
}
}

Classe NotebookWebServiceFromEJBClientServlet
du projet NotebookWebServiceFromEJBClient JAX-WS - M. Baron - Page 62
 JAX-WS « in actions » : Web Services eBay

eBay fournit via son programme eBay developers program

un accès à ses services via des Web Services

[Link]

[Link]

[Link]

[Link]

L’utilisation de ces Web Services est soumis à une inscription

pour obtenir une clé d’autorisation

[Link]
[Link]

Nous montrons à partir de JAX-WS comment générer un

client d’accès au service de recherche d’eBay

Le code du client est fortement inspiré de

[Link]
JAX-WS - M. Baron - Page 63
 JAX-WS « in actions » : Web Services eBay

Utilisation de l’outil wsimport

[Link]

Utilisation du paramètre extension de l’outil wsimport

Génération des artifacts du Web Service

Génération des classes liées à JAXB (51 classes)

Génération de classes Web Service (2 classes)

Création d’une instance de la classe FindingService

Récupération d’un port getFindingServiceSOAP12PortHttp()
[Link]

Renseigner dans l’en-tête HTTP les informations de protocole

et d’autorisation

Préparer le paramètre de l’opération findItemsAdvanced

Invocation de l’opération JAX-WS - M. Baron - Page 64
 JAX-WS « in actions » : Web Services eBay

Exemple : création d’un client pour Web Service eBay

public class EBAYFindingserviceClient {
public static void main (String[] args) {
String strBaseURL = "[Link]
FindingService service = new FindingService();
FindingServicePortType port = service.getFindingServiceSOAP12PortHttp();

BindingProvider bp = (BindingProvider) port;

List<Handler> myHandler = new ArrayList<Handler>();
[Link](new SOAPLoggingHandler()); Création et paramétrage du
Web Service
[Link]().setHandlerChain(myHandler);

Map<String, Object> requestProperties = [Link]();

Map<String, List<String>> httpHeaders = new HashMap<String, List<String>>();
// Set the headers
[Link]("X-EBAY-SOA-MESSAGE-PROTOCOL", [Link]("SOAP12"));
[Link]("X-EBAY-SOA-OPERATION-NAME", [Link]("findItemsAdvanced"));

// Edit the following line to insert your AppID to set the X-EBAY-SOA-SECURITY-APPNAME correctly
[Link]("X-EBAY-SOA-SECURITY-APPNAME", [Link](KEY_PERSONAL));
[Link]

[Link](MessageContext.HTTP_REQUEST_HEADERS, httpHeaders);
[Link](BindingProvider.ENDPOINT_ADDRESS_PROPERTY, strBaseURL);

... Suite dans le prochain transparent

}
Fournit à partir du compte
} personnel

Classe EBAYFindingserviceClient du projet

EBAYFindingServiceClient JAX-WS - M. Baron - Page 65
 JAX-WS « in actions » : Web Services eBay

Exemple (suite) : création d’un client pour Web Service eBay

public class EBAYFindingserviceClient {
public static void main (String[] args) {
... Création du paramètre à
FindItemsAdvancedRequest req = new FindItemsAdvancedRequest();
List<OutputSelectorType> opSelector = [Link]();
passer à l’opération
[Link](OutputSelectorType.SELLER_INFO); findItemsAdvanced(…)
ItemFilter objFilter1 = new ItemFilter();
[Link](ItemFilterType.AVAILABLE_TO);[Link]().add("US");
ItemFilter objFilter2 = new ItemFilter();
[Link](ItemFilterType.LISTING_TYPE);[Link]().add("All");
ItemFilter objFilter3 = new ItemFilter();
[Link](ItemFilterType.HIDE_DUPLICATE_ITEMS);[Link]().add("true");

List<ItemFilter> itemFilter = [Link]();

[Link](objFilter1);
[Link](objFilter2);
[Link](objFilter3);

List<String> catID = [Link]();

[Link]

[Link]("279");
[Link](SortOrderType.END_TIME_SOONEST);
[Link]("Harry Potter"); Recherche des produits en
// Suite dans le prochain transparent relation avec Harry Potter
}
}

Classe EBAYFindingserviceClient du projet

EBAYFindingServiceClient JAX-WS - M. Baron - Page 66
 JAX-WS « in actions » : Web Services eBay

Exemple (suite) : création d’un client pour Web Service eBay

public class EBAYFindingserviceClient {
public static void main (String[] args) {
...

FindItemsAdvancedResponse res = [Link](req);

SearchResult searchResult = [Link]();
List<SearchItem> item = [Link](); Un appel synchrone à
for (SearchItem searchItem : item) {
[Link]([Link]());
l’opération
} findItemsAdvanced(…)
[Link]("Search Count: " + [Link]());
}
}

Classe EBAYFindingserviceClient du projet

EBAYFindingServiceClient

Une liste de liens d’aperçu

[Link]

d’image est générée par

rapport à la recherche
effectuée

JAX-WS - M. Baron - Page 67

 Tutoriel
Construire un Web Service à partir d’un EJB avec
Netbeans 6.8 et Glassfish 3
Mickaël BARON - 2010
[Link] ou [Link]
 Web Service avec les EJB : client

Démarrer la création d’un nouveau Projet (File -> New

Project …)

Choisir la construction
d’une Web Application
(Catégories : Java Web)
[Link]

2
Faire Next JAX-WS - M. Baron - Page 69
 Web Service avec les EJB : serveur
Définir le nom du projet
NotebookWebServiceFromEJB

3
[Link]

4
Faire Next JAX-WS - M. Baron - Page 70
[Link] Web Service avec les EJB : serveur

Faire Next JAX-WS - M. Baron - Page 71

[Link] Web Service avec les EJB : serveur

Faire Finish JAX-WS - M. Baron - Page 72

 Web Service avec les EJB : serveur

Génération de la structure des fichiers du projet

7
Recopier les fichiers Java
dans ce nouveau package
[Link]

JAX-WS - M. Baron - Page 73

 Web Service avec les EJB : serveur

Ajouter l’annotation @Stateless

pour définir ce POJO comme un
EJB Session sans état
8
@Stateless
@WebService(endpointInterface = "[Link]")
public class NotebookServiceImpl {
public boolean addPersonWithComplexType(Person newPerson) {
... 9
}

public Person getPersonByName(String name) { S’assurer que le chemin

... de l’interface du Web
}
Service est correcte
public List<Person> getPersons() {
...
}

public void addPersonWithSimpleType(String name, String address, String birthyear) {

[Link]

...
}
}

Classe [Link] du projet

NotebookWebServiceFromEJB
JAX-WS - M. Baron - Page 74
 Web Service avec les EJB : serveur

Déployer l’application sur Glassfish 3

10

Déploiement de
l’application sur Glassfish
[Link]

JAX-WS - M. Baron - Page 75

[Link] Web Service avec les EJB : serveur

L’application est déployée et le Web Service est

découvert
JAX-WS - M. Baron - Page 76
 Web Service avec les EJB : serveur

Visualiser le document WSDL

[Link]

JAX-WS - M. Baron - Page 77

 Web Service avec les EJB : serveur

Tester le Web Service

Génération d’un formulaire pour tester le Web
Service

11
Tester le Web
Service
[Link]

Possibilité de saisir les paramètres et de tester

le résultat JAX-WS - M. Baron - Page 78
 Tutoriel
Construire un client Web Service défini à partir d’un EJB
avec Netbeans 6.8 et Glassfish 3
Mickaël BARON - 2010
[Link] ou [Link]
 Web Service avec les EJB : client

Démarrer la création d’un nouveau Projet (File -> New

Project …)

Choisir la construction
d’une Web Application
(Catégories : Java Web)
[Link]

2
Faire Next JAX-WS - M. Baron - Page 80
 Web Service avec les EJB : client
Définir le nom du projet
NotebookWebServiceFromEJBClient

3
[Link]

4
Faire Next JAX-WS - M. Baron - Page 81
[Link] Web Service avec les EJB : client

Faire Next JAX-WS - M. Baron - Page 82

[Link] Web Service avec les EJB : client

Faire Finish JAX-WS - M. Baron - Page 83

 Web Service avec les EJB : client

Ajouter la bibliothèque JAX-WS pour la génération des

artifacts (JAXB, …) à partir de l’outil wsimport
Bouton droit sur le
nœud Libraries

8
[Link]

Choisir la bibliothèque
JAX-WS 2.2

9
Faire Add Library
JAX-WS - M. Baron - Page 84
 Web Service avec les EJB : client

Créer un client à partir d’un document WSDL (New -> Web

Services -> Web Service Client

Indiquer l’URL du
document WSDL 10

Préciser le package 11
des fichiers générés
[Link]

12
Faire Finish JAX-WS - M. Baron - Page 85
 Web Service avec les EJB : client

Les artifacts du Web

Service Notebook sont
générés
[Link]

JAX-WS - M. Baron - Page 86

 Web Service avec les EJB : client

Création d’une Servlet pour appeler un Web Service (File ->

New Files … -> Servlet)
[Link]

13

Faire Next JAX-WS - M. Baron - Page 87

 Web Service avec les EJB : client

Ajouter l’information dans le fichier [Link]

14
[Link]

15
Faire Finish JAX-WS - M. Baron - Page 88
 Web Service avec les EJB : client

Compléter le code de la Servlet

public class NotebookWebServiceFromEJBClientServlet extends HttpServlet {

@WebServiceRef(wsdlLocation = "[Link]
private Notebook_Service service;

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

[Link]("text/html;charset=UTF-8");
PrintWriter out = [Link]();
try {
[Link]("<html>");
[Link]("<head>");
[Link]("<title>Servlet NotebookWebServiceFromEJBClientServlet</title>");
[Link]("</head>");
[Link]("<body>");
[Link]("<h1>Servlet NotebookWebServiceFromEJBClientServlet at " + [Link]() + "</h1>");

try {
Notebook port = [Link]();
Person newPerson = new Person();
[Link]("BARON Mickael");
[Link]("Poitiers");
[Link]("1976");
boolean result = [Link](newPerson);
[Link]("<div>Result = " + result + "</div>");
} catch (Exception ex) {
[Link]();
[Link]

}
[Link]("</body>");
[Link]("</html>");
} finally {
[Link]();
}
}
}

Classe NotebookWebServiceFromEJBClientServlet
du projet NotebookWebServiceFromEJBClient JAX-WS - M. Baron - Page 89