Tutoriel sur le développement de services web étendus avec JAX-WS, Maven et Eclipse

Bonjour,

Je vous propose un tutoriel qui présente sous la forme d'exercices comment utiliser l'API JAX-WS pour le développement de services web étendus.

Chaque exercice est fourni avec un projet Java Maven contenant des classes et des fichiers de configuration qu'il faudra compléter au fur et à mesure des questions. À la fin de chaque exercice, une solution du projet Java sera donnée.

L'adresse du tutoriel est disponible ici : http://mbaron.developpez.com/tutorie...maven-eclipse/

Bon tutoriel et apprentissage autour de JAX-WS.

Mickael

Je vais être un tout petit peu de mauvaise foi mais pourquoi faire un article sur une technologies en perdition .... SOAP meurt au profit de REST.
Pourquoi ne pas parler de spring-boot, spring-cloud ou même jax-rs .... ?

Citation:

---

Je vais être un tout petit peu de mauvaise foi mais pourquoi faire un article sur une technologies en perdition .... SOAP meurt au profit de REST.

---

Je ne dirais pas que SOAP meurt mais est moins utilisé. SOAP à l'inverse de REST s'appuie sur des standards. Il est encore utilisé entre entreprises. Il adresse des besoins différents. Chacun son usage et laissons les gens utilisaient ce qu'ils veulent et ne laissons pas les buzz words dicter les choix.

Citation:

---

Pourquoi ne pas parler de spring-boot, spring-cloud ou même jax-rs .... ?

---

Pour JAX-RS qui adresse les services web REST ça sera pour le prochain : http://www.developpez.net/forums/d15...maven-eclipse/

Pour Spring-Boot il adresse les microframeworks et s'appuie partiellement sur des choses déjà faite sur JAX-RS (c'est mon avis).

Mickael

Citation:

---

Je ne dirais pas que SOAP meurt mais est moins utilisé

---

Ok, constat identique au final, sauf que je vais plus loin en disant que c'est au profit de REST ce qui se justifie aussi (mon avis).

Citation:

---

SOAP à l'inverse de REST s'appuie sur des standards.

---

REST s'appuie sur le standard HTTP ... rien de moins.

Citation:

---

Il est encore utilisé entre entreprises. Il adresse des besoins différents. Chacun son usage et laissons les gens utilisaient ce qu'ils veulent et ne laissons pas les buzz words dicter les choix.

---

C'est vrai mais il a été aussi moult et moult fois étudié, expliqué et ma question (qui ne se veut pas trollesque mais en a les traits) portait plus sur le fait d'encore faire un tutoriel dessus.

Cela dit, il est vrai qu'un tutoriel sur JAX-RS va arriver donc au moins ça pourra donner un ensemble de comparaison intéressante espérons le.

Merci de la réponse.

Salut,

Pour les standards je voulais parler du poster en PJ.

Pour la petite information, ces tutoriels sous formes d'exercices sont un support que j'utilise pour présenter un cours sur SOA. Je mets en avant les bien faits de REST face à SOAP. SOAP existe et je ne peux pas ne pas en parler.

Mickael

J'ai commencé l'exercice 1 du tuto. Quand j'ai importé le projet dans eclipse, j'ai une erreur « Plugin execution not covered by lifecycle configuration: org.jvnet.jax-ws-commons:jaxws-maven-plugin:2.3:wsgen ». Pour la corrigé j'ai ajouté la balise <pluginManagement/> comme indiqué dans ce thread. Dans la fin de l'exercice, tu es moins clair sur l'étape pour générer le wsdl à partir de Maven dans eclipse, d'ailleurs j'ai pas réussi :(.
Ton tuto est super! Merci pour le travail fourni.

Salut,

Pour la génération du WSDL du premier exercice. Tu peux faire cela en ligne de commande

$ mvn clean process-classes

Mickael

Bonjour Mickaël,


J'essaie de faire ton tuto, mais je n'arrive pas à lancer les scripts wsgen1 et wsgen2 y compris en ligne de commande comme tu le suggères.

J'arrive toujours à une erreur de build.


Voici la trace:

C:\Mes workspaces\workspaces_Mars\workspace_01\NotebookWebServiceExercice1>mvn "wsgen1 (clean and process-classes).launch"
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building NotebookWebServiceExercice1 0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.100 s
[INFO] Finished at: 2016-01-31T18:06:16+01:00
[INFO] Final Memory: 5M/123M
[INFO] ------------------------------------------------------------------------
[ERROR] Unknown lifecycle phase "wsgen1 (clean and process-classes).launch". You must specify a valid lifecycle phase or a goal in the format <plugin-prefix>:<goal> or <plugin-group-id>:<plugin-artifact-id>[:<plugin-version>]:<goal>. Available lifecycle phases are: validate, initialize, generate-sources, process-sources, generate-resources, process-resources, compile, process-classes, generate-test-sources, process-test-sources, generate-test-resources, process-test-resources, test-compile, process-test-classes, test, prepare-package, package, pre-integration-test, integration-test, post-integration-test, verify, install, deploy, pre-clean, clean, post-clean, pre-site, site, post-site, site-deploy. -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/d...FoundException



Bref, je ne m'en sors pas. Peux-tu m'aider un peu stp?

En te remerciant.
Jeff

Bonjour,

En ligne de commande il faut saisir cela

$ mvn clean process-classes

Cela : wsgen1 (clean and process-classes).launch c'est le nom du fichier correspondant à une configuration d'exécution d'Eclipse

Mickael

Bonjour,

Je voudrais d'abord vous remercier pour vos divers tutos, cela aide énormément.

J'ai effectué les 6 exercices de votre tuto : développement de services Web avec JAX-WS.

J'ai deux questions, une en rapport à l'exercice 4, l'autre sur l'exercice 6.

ex4:

J'ai effectué l'exercice sans soucis, et je vois bien les logs du serveur jboss. Cependant, si le webservice n'est pas déployé ou si le serveur est éteint.
le client fonctionne tout de même...
Je n'arrive pas à comprendre pourquoi?


ex6:

Quand je fais un clean and build sur le projet et que je déploie sur le serveur, les logs du serveur indique que le fichier handler.xml est manquant, alors
que je l'ai bien placé dans le repértoire WEB-INF.

Code:

---

1 2 3 4 5 6 7 8

Caused by: javax.xml.ws.WebServiceException: JBAS015507: Handler chain config file soa/jaxwslabs/notebookwebserviceexercice6/service/handler.xml not found in ResourceRoot [root="/M:/content/NotebookWebServiceExercice6-1.0-SNAPSHOT.war/WEB-INF/classes"] at org.jboss.as.webservices.injection.WSHandlerChainAnnotationProcessor.getInputStream(WSHandlerChainAnnotationProcessor.java:158) at org.jboss.as.webservices.injection.WSHandlerChainAnnotationProcessor.processHandlerChainAnnotation(WSHandlerChainAnnotationProcessor.java:130) at org.jboss.as.webservices.injection.WSHandlerChainAnnotationProcessor.processHandlerChainAnnotations(WSHandlerChainAnnotationProcessor.java:116) at org.jboss.as.webservices.injection.WSHandlerChainAnnotationProcessor.deploy(WSHandlerChainAnnotationProcessor.java:93) at org.jboss.as.server.deployment.DeploymentUnitPhaseService.start(DeploymentUnitPhaseService.java:113) [jboss-as-server-7.1.1.Final.jar:7.1.1.Final] ... 5 more

---

Avez-vous une idée du problème?

Merci d'avance de votre réponse.

Telendri

Salut,

Comme c'est un appel asynchrone je pense que le code dans le callbakc du bouton est fait et que l'appel via le service web échoue

Citation:

---

Quand je fais un clean and build sur le projet et que je déploie sur le serveur, les logs du serveur indique que le fichier handler.xml est manquant, alors
que je l'ai bien placé dans le repértoire WEB-INF.

---

Etrange. Vérifie que le fichier est présent au niveau du répertoire target

Mickael

Bonjour,

Lors de l'importation du projet maven NotebookWebServiceExercice1.zip dans eclipse, je rencontre l'erreur suivante au niveau du fichier pom.xml :
Pièce jointe 275754

Auriez-vous une idée de comment le régler ? J'ai beau chercher l'erreur sur internet depuis plusieurs heures, je ne trouve rien de concluant ...

Merci beaucoup.

Salut,

C'est étrange car je le fais chaque année avec mes étudiants.

As-tu la dernière version de Java et d'Eclipse ? As-tu configuré dans Eclipse, le JDK et le non seulement la JRE ?

Mickael

Bonjour,

J'ai JDK 1.8.0_121 de configuré dans Eclipse Néon 4.6.0, je ne peux malheureusement pas le mettre à jour car il ne trouve pas certains répertoires, je ne comprends pas vraiment cette erreur.
Pièce jointe 276164

Devrais-je changer de version d'eclipse / réinstaller celle-ci une nouvelle fois ?

Merci

Salut,

Cela vient plus d'un problème de Java et d'Eclipse que de problème lié à mon tutoriel. Peux-tu poster sur le bon forum, tu auras peut être plus de chance

Mickael

Bonjour,

Félicitations pour vos tutoriels, ils sont vraiment très didactiques. Je n'ai eu aucun problème à les effectuer sur mon ordinateur sous ubuntu (mise à part un peu de debug). Seulement voilà, j'ai des collègues qui ont souhaité faire ces tutoriels sous windows/mac et ils ont tous le même problème.

Lorsqu'ils tentent de faire un mvn clean install sur l'exercice 1 terminé, le message de sortie indique : cannot execute wsgen et c'est la même chose pour wsimport sur exercice 2.
On a tenté de changer le JDK, on est passé sur openjdk11, openJDK10, jdk1.8.0_201, jdk11.0.2... à chaque fois le changement était pris en compte puisque le chemin changeait bien dans le message d'erreur. On a tenté de supprimer le contenu du repository de maven mais rien n'y fait. Sur Eclipse, le message est le même et indique cannot execute ...\wsgen.

Sur le poste qui fonctionne, en sortie de java -version j'ai :
openjdk version "1.8.0_191"
OpenJDK Runtime Environment (build 1.8.0_191-8u191-b12-0ubuntu0.18.04.1-b12)
OpenJDK 64-Bit Server VM (build 25.191-b12,mixed mode)

Sur un des postes qui ne fonctionne pas :
openjdk version "11.0.2" 2019-01-15
OpenJDK Runtime Environment 18.9 (build 11.0.2+9)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.2+9, mixed mode)

J'ai vu que vous aviez posté un message sur ce site qui semble proche de mon problème : https://github.com/javaee/metro-jax-ws/issues/1251
y'a-t-il un rapport entre les deux ?

Concrètement, avez-vous rencontré ce problème ? sur quelle version de jdk me conseilleriez vous de passer (open / Oracle ? 10 ? 11 ?) ?
Peut-être que je me trompe et que cela n'a rien à voir avec le jdk... mais normalement mon fichier .pom est correcte, il est a l'exact identique que celui qui fonctionne sur mon poste.

Merci,
Philippe.

Bonjour,

Merci pour votre retour.

Depuis Java 9, il y a de nombreux problèmes de compatibilité.

J'ai fait ce tutoriel en TP avec les étudiants dernièrement et votre description me rappelle quelques problèmes.

Pour générer actuellement il faut qu'il y ait au moins Java 10. Avec Java 11 le plugin que j'utilise ne fonctionne pas car il y a un problème sur quelques classes. Pour résoudre ce problème, j'ai forcé à utiliser les outils wsimport et wsgen du JDK. Malheureusement, wsimport et wsgen ne sont plus disponibles sur JDK 11 et +.

Avec Java 11

Solution 1
Avoir un JDK plus ancien (en plus du JDK 11 qui sert à exécuter) et faire pointer le paramètre <executable>${java.home}/bin/wsgen</executable> vers ce JDK plus ancien.

Solution 2
Je viens de vérifier et suite à mon ticket sur Github, la version 2.3.2 de JAXWS est sortie (ouf enfin). Avec cette version, il y a maintenant un plugin inclus. Plus besoin d'utiliser celui de org.codehaus.mojo.

Voici le code à modifier

Citation:

---

<plugin>
<groupId>com.sun.xml.ws</groupId> <!--org.codehaus.mojo -->
<artifactId>jaxws-maven-plugin</artifactId>
<version>${jaxws.version}</version> <!-- ${jaxws.maven.version} -->
<executions>
<execution>
<goals>
<goal>wsgen</goal>
</goals>
<configuration>
<sei>fr.mickaelbaron.jaxwstutorialexercice1.NotebookServiceImpl</sei>
<genWsdl>true</genWsdl>
<keep>true</keep>
</configuration>
</execution>
</executions>
</plugin>

---

Je vais impacter tout mon tutoriel

Tenez moi au courant de votre côté si ça fonctionne

C'est bon, j'ai impacté tout le tutoriel en passant au plugin de JAXWS et en migrant vers 2.3.2

Mickael

Bonjour,

Super, merci pour votre réactivité, j'attendais d'avoir tout refait pour répondre, ça fonctionne très bien. j'ai juste un message sur le fichier pom.xml de l'exercice 1 sur eclipse :

Plugin execution not covered by lifecycle configuration: com.sun.xml.ws:jaxws-maven-plugin:2.3.2:wsgen (execution: default, phase: process-classes)

Je pense que c'est un warning car ça n'a pas impacté le fonctionnement (fichiers wsdl généré, build et execution des webservices fonctionnels) et de plus ça n'apparaît pas lors d'un maven install, ce serait donc plus un problème lié à éclipse.

Juste une petite question, dans l'exercice 5 le handler ne récupère pas le nom de l'opération (il affiche "null") est-ce que c'est voulu ou est-ce juste un oubli ?
Pour ma part j'ai trouvé une autre solution pour le récupérer (grâce à vos slides de cours) donc ça ne m'a pas fait de mal de chercher, mais je préfère demander au cas où.

En tout cas merci beaucoup !
Philippe.

Citation:

---

Plugin execution not covered by lifecycle configuration: com.sun.xml.ws:jaxws-maven-plugin:2.3.2:wsgen (execution: default, phase: process-classes)

---

Ce n'est pas grave, c'est un warning effectivement. De toute façon, la référence pour moi c'est que ça fonctionne en ligne de commande, après Eclipse c'est juste pour coder. S'il n'y a pas de raison => supprimer le warning ;-)

Citation:

---

Juste une petite question, dans l'exercice 5 le handler ne récupère pas le nom de l'opération (il affiche "null") est-ce que c'est voulu ou est-ce juste un oubli ?

---

Je ne me rappelle plus, je vais devoir tester pour vérifier.

Merci pour le retour

Mickael