Différences

Ci-dessous, les différences entre deux révisions de la page.

--- enseignement:tp:sw:jaxws:2016 [2016/12/07 07:05]
ecoquery
+++ enseignement:tp:sw:jaxws:2016 [2016/12/09 15:42] (Version actuelle)
ecoquery [Contrôleur principal (front)]
@@ Ligne 5: / Ligne 5: @@
 Un projet de démarrage est fourni et comprend l'implémentation de base des fonctionnalités métier (module ''%%metier%%''). Il vous sera demandé de compléter ce projet en développant une application SpringBoot permettant d'exposer sous la forme d'un ensemble de services Web.
+URL de pull du projet: https://forge.univ-lyon1.fr/hg/tiw1-2016-services-base
 ===== Modalités de rendu =====
 Ce TP est à rendre pour le **dimanche 18/12/2016** en inscrivant l'indentifiant d'un projet forge dans la case tomuss ''%%TP8_ImplWS%%'' de l'UE "TIW1 Intergiciels et Services". **Cet identifiant devra être saisi par les deux membres du binôme le cas échéant.**
-On rappelle que l'indentifiant d'un projet forge étudiant:
+<note>On rappelle que l'indentifiant d'un projet forge étudiant:
-* Commence par ''%%p%%''
+  * Commence par ''%%p%%''
-* N'est pas une URL (ne contient pas ''%%http%%'', ni ''%%https%%'')
+  * N'est pas une URL (ne contient pas ''%%http%%'', ni ''%%https%%'')
+</note>
 ===== Code métier fourni =====
@@ Ligne 27: / Ligne 29: @@
 Utiliser le plugin ''%%cxf-codegen-plugin%%'' ([[http://cxf.apache.org/docs/maven-cxf-codegen-plugin-wsdl-to-java.html|doc]]) pour générer une interface Java représentant le service à implémenter.
-> Le code généré ne devra pas être versionné et se trouvera (par défaut) dans l'arborescence du répertoire ''%%target%%''. Il est d'ailleurs conseillé de ne pas configurer de ''%%sourceRoot%%''.
+<note tip>Le code généré ne devra pas être versionné et se trouvera (par défaut) dans l'arborescence du répertoire ''%%target%%''. Il est d'ailleurs conseillé de ne pas configurer de ''%%sourceRoot%%''.
+</note>
 Parcourir le code généré et faire le lien avec le contenu du fichier ''%%cours.wsdl%%''.
@@ Ligne 36: / Ligne 38: @@
   * qui implémente l'interface générée;
-  * annoté par [[https://docs.oracle.com/javaee/7/api/index.html?javax/jws/WebService.html|''%%@WebService%%'']];
+  * annoté par ''[[https://docs.oracle.com/javaee/7/api/index.html?javax/jws/WebService.html|@WebService]]'';
   * utilise le composant ''%%CoursManager%%'' pour l'implémentation du métier.
 Déployer ce composant dans CXF. On pourra pour celui s'inspirer du tutoriel suivant: [[https://blog.codecentric.de/en/2016/02/spring-boot-apache-cxf/|Bringing Spring Boot & Apache CXF up and running]], en particulier en adaptant le code ci-dessous pour activer le framework CXF:
-<code>
+<code java>
 @SpringBootApplication
 public class SimpleBootCxfApplication {
@@ Ligne 49: / Ligne 51: @@
     }
+    // ne pas utiliser dispatcherServlet comme nom pour ce bean sous peine de
+    // ne plus pouvoir utiliser de bean @Controller ailleurs dans l'application
     @Bean
-    public ServletRegistrationBean dispatcherServlet() {
+    public ServletRegistrationBean cxfDispatcherServlet() {
         return new ServletRegistrationBean(new CXFServlet(), "/soap-api/*");
     }
@@ Ligne 62: / Ligne 66: @@
 Lire la suite de ce tutoriel pour comprendre comment exposer le composant Spring comme service via CXF (//i.e.// ajouter le bean das la configuration et le rendre disponible via un endpoint CXF).
-> Attention: bien remplir l'annotation ''%%@WebService%%'' en spécifiant de préférence à cet endroit l'emplacement du wsdl, plutôt que dans la configuration du ''%%EndpointImpl%%''CXF. Attention également aux packages de ''%%javax.xml.ws.Endpoint%%'' et de ''%%org.apache.cxf.jaxws.EndpointImpl%%'' (non précisés dans le tutoriel)
+<note tip>Attention: bien remplir l'annotation ''%%@WebService%%'' en spécifiant de préférence à cet endroit l'emplacement du wsdl, plutôt que dans la configuration du ''%%EndpointImpl%%''CXF. Attention également aux packages de ''%%javax.xml.ws.Endpoint%%'' et de ''%%org.apache.cxf.jaxws.EndpointImpl%%'' (non précisés dans le tutoriel)
+</note>
-Aller à l'URL [[http://localhost:8080/soap-ui/|''%%http://localhost:8080/soap-ui/%%'']] et vérifiez que votre service est bien listé.
+Aller à l'URL [[http://localhost:8080/soap-api/]] et vérifiez que votre service est bien listé.
 Tester son fonctionnement avec [[http://www.soapui.org/|soapUI]].
@@ Ligne 72: / Ligne 77: @@
 Le rôle de ce contrôleur est double: extraire le contenu XML dans des instances de classes Java et aiguiller la suite du traitement vers la bonne méthode du composant d'implémentation du service.
-Créer un nouveau composant Spring implémentant l'interface [[https://docs.oracle.com/javaee/7/api/index.html?javax/xml/ws/Provider.html|''%%Provider<Source>%%'']]. La méthode ''%%invoke%%'' devra convertir le XML du //payload// en objets Java et appeler la bonne méthode du composant d'implémentation du service que vous avez mis en place à l'étape précédente.
+Créer un nouveau composant Spring implémentant l'interface ''[[https://docs.oracle.com/javaee/7/api/index.html?javax/xml/ws/Provider.html|Provider<Source>]]''. La méthode ''%%invoke%%'' devra convertir le XML du //payload// en objets Java et appeler la bonne méthode du composant d'implémentation du service que vous avez mis en place à l'étape précédente.
 Déployer ce composant comme un Web service à une autre adresse et tester avec [[http://www.soapui.org/|soapUI]].
@@ Ligne 78: / Ligne 83: @@
 ==== Contrôleur principal (front) ====
-Implémenter un contrôleur point d'accès au service via un [[http://docs.spring.io/spring/docs/current/javadoc-api/index.html?org/springframework/web/servlet/mvc/Controller.html|''%%@Controller%%'']] SpringMVC. Ce contrôleur traitera les requêtes HTTP et extraira le contenu (//payload//) du message via l'API SAAJ. Il redirigera ensuite le traitement vers le composant Web service provider de l'étape précédente.
+Implémenter un contrôleur point d'accès au service via un ''[[http://docs.spring.io/spring/docs/current/javadoc-api/index.html?org/springframework/web/servlet/mvc/Controller.html|@Controller]]'' SpringMVC. Ce contrôleur traitera les requêtes HTTP et extraira le contenu (//payload//) du message via l'API SAAJ. Il redirigera ensuite le traitement vers le composant Web service provider de l'étape précédente.
 Utiliser [[http://www.soapui.org/|soapUI]] pour tester votre contrôleur point d'accès.
-> Comme indiqué dans ''%%cours.wsdl%%'', le service déployé devra être accessible à l'adresse [[http://localhost:8080/services-sans-cxf/cours|''%%http://localhost:8080/services-sans-cxf/cours%%'']]. Il faut donc bien configurer le ''%%@RequestMapping%%'' en fonction de cette URL.
+<note>Comme indiqué dans ''%%cours.wsdl%%'', le service déployé devra être accessible à l'adresse [[http://localhost:8080/services-sans-cxf/cours]]. Il faut donc bien configurer le ''%%@RequestMapping%%'' en fonction de cette URL.</note>
+<note important>Attention au nom de la dispatcherServlet dans la configuration Spring (maj du 09/12/2016)</note>
+<note tip>Pour fabriquer correctement les ''MimeHeaders'', il faut les copier via une boucle depuis les headers de la requête HTTP.</note>
+<note tip>En cas d'utilisation de l'API XML de transformation pour faire des copies entre représentations XML, penser à ''SAAJResult'' qu ipermet d'écrire dans noeud XML d'un message SOAP</note>
 Auteur: <html><a href="http://liris.cnrs.fr/ecoquery/"></html>Emmanuel Coquery<html></a><br/></html> <html><a href="http://creativecommons.org/licenses/by-nc-sa/3.0/" rel="license"><img src="https://licensebuttons.net/l/by-nc-sa/3.0/80x15.png" alt="CC Attribution-Noncommercial-Share Alike 3.0 Unported" /></a></html> Ce document est placé sous les termes de la licence suivante : <html><bdi><a href="http://creativecommons.org/licenses/by-nc-sa/3.0/" rel="license" class="urlextern"></html>CC Attribution-Noncommercial-Share Alike 3.0 Unported<html></a></bdi></html>

Emmanuel COQUERY

Outils de la page

Différences