Tp1 - WS avec JAXWS

Tp1 - WS avec JAXWS

• 1.
  LA 3 SIL– 2013/2014 TP1 : Les Services Web avec JAX-WS Dr. Lilia Sfaxi Objectifs du TP : Création de services web avec JAX-WS et l’IDE Netbeans Institut National des Sciences Appliquées et de Technologie
• 2.
  2 TP1 : LesServices Web avec JAX-WS I. Les Services Web avec JAX-WS I.1. Présentation de JAX-WS JAX-WS1 (Java API for XML Web Services) est une API permettant de développer des services web étendus en utilisant le protocole SOAP et le langage WSDL via la plateforme de développement JAVA. Le développement de Services Web 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 JAXWS requièrent simplement l’utilisation d’annotations Java. La figure suivante2 montre l’architecture d’un système utilisant JAX-WS. Il existe deux façons pour développer un service web avec JAX-WS : 1. Approche Top-Down (Contract First) : permet, à partir d’un document WSDL, de générer les squelettes des différentes classes Java en utilisant l’outil wsimport, de compléter leur implémentation, puis de les compiler, déployer et tester. 1 JAX-WS: http://jax-ws.java.net/ 2 Figure extraite du cours Développer des Services Web Étendus avec Java : JAX-WS, par Mickaël BARON. Architecture  Orientée  Services
• 3.
  TP1 : LesServices Web avec JAX-WS 3 2. Approche Bottom-Up (Code First) : permet de créer et d’annoter un POJO, de le compiler, déployer et tester, puis de générer automatiquement le document WSDL. I.2. Installation et Démarrage Pour les besoins de ce TP, on vous fournit les outils suivants3 (à installer dans l’ordre): -­‐ -­‐ -­‐ -­‐ jdk-7u9-windows-i586.exe : Pour l’installation de JDK 7. java_ee_sdk-6u4-windows.exe : Kit de développement de Java EE6. Contient, principalement, le serveur d’application Glassfish3, dans lequel nous allons déployer notre service web. netbeans-7.2.1-ml-javaee-windows.exe : C’est l’environnement de développement Netbeans, pour JavaEE. soapUI-x32-4.5.1.exe : outil de test léger pour les services web. I.2.1. Installation de Java EE SDK Pour installer Java EE SDK, il faut que JDK soit installé au préalable (version 1.6 au minimum). Il est recommandé de suivre les instructions suivantes : -­‐ -­‐ Configurer le serveur Glassfish comme suit (configuration standard) : o Login : admin o Mot de passe : (vide) Accepter les valeurs des ports par défaut : Admin Port (4848) et Http Port (8080) Par défaut, votre serveur d’application sera installé directement sous : C:glassfish3 I.2.2. Installation de Netbeans IDE Pour installer Netbeans, il est recommandé de suivre les instructions suivantes : -­‐ -­‐ A la première page d’installation, décocher la case pour l’installation de Glassfish Server. Continuer l’installation normalement. I.2.3. Configuration de Netbeans avec le serveur d’application Glassfish Pour ajouter Glassfish comme serveur dans l’environnement Netbeans, suivre les instructions suivantes : -­‐ -­‐ -­‐ -­‐ -­‐ 3 Démarrer NetBeans. Dans le menu Tools, cliquer sur « Servers » Cliquer sur le bouton « Add Server » Choisir « Glassfish Server 3+ » et cliquer sur Next Dans le chemin d’installation, naviguer vers votre répertoire d’installation de Glassfish (par défaut C:glassfish3) Garder les informations sur le domaine identiques, et cliquer sur Finish. Téléchargés à partir de http://www.oracle.com/index.html Architecture  Orientée  Services
• 4.
  4 TP1 : LesServices Web avec JAX-WS I.2.4. Démarrer le serveur Glassfish Pour démarrer Glassfish, aller vers : Démarrer -> Tous les programmes -> Java EE 6 SDK -> Démarrer le serveur d’application Vous pourrez vérifier que votre serveur est bien démarré en lançant le navigateur, et en tapant : http://localhost:8080 La page d’accueil de Glassfish s’affichera. II. Première Application : Helloworld II.1. Création du service web Comme indiqué précédemment, deux approches sont possibles pour créer un service web : une approche Bottom-Up et une approche Top-Down. Nous allons dans ce qui suit vous montrer comment réaliser ces deux approches en utilisant NetBeans et le serveur Glassfish. II.1.1. Approche Bottom-Up (Code first) Pour créer un service web en utilisant l’approche Bottom-Up, nous allons suivre les étapes suivantes : 1. Ouvrir NetBeans, et créer un nouveau projet de type Web, en tapant : File -> New Project -> Java Web -> Web Application 2. Cliquer sur Next. Appeler votre projet HelloWorldService, cliquer sur Next. 3. Garder la configuration du serveur par défaut, soit GlassFish Server 3+. Remarque : Si vous n’avez pas configuré votre serveur comme indiqué dans I.2.3. , vous ne trouverez pas de serveur dans la liste déroulante. Veillez à configurer votre serveur d’abord. 4. Ne cochez aucun des frameworks proposés, et cliquer sur Finish. Un nouveau projet de type WebApplication sera créé. Son arborescence sera comme représenté dans la figure suivante : Architecture  Orientée  Services
• 5.
  5 TP1 : LesServices Web avec JAX-WS 5. Sous le répertoire Source Packages, faire un clic-droit, et choisir New -> Java Class. Appeler votre nouvelle classe Hello et taper comme nom de package insat.soa.tp1.service 6. Taper le code suivant dans votre classe. Importation des annotations @WebService et @WebMethod Indique que la classe Hello est un service web Constructeur par défaut (obligatoire si on définti d’autres constructeurs) Méthode représentant un port du service: permet de saisir le nom de la personne, et de retourner un message de bienvenue. 7. Pour déployer votre service sur le serveur Glassfish, faire un clic-droit sur le projet, et choisir Deploy. Votre service web a bien été déployé si la console Netbeans affiche un message comme celui-ci : 8. Il est possible de visualiser le fichier WSDL correspondant à la description de votre service en tapant l’URL suivant dans votre navigateur : Architecture  Orientée  Services
• 6.
  6 TP1 : LesServices Web avec JAX-WS http://localhost:8080/HelloWorldService/HelloService?wsdl Le résultat sera comme suit : II.1.2. Approche Top-Down (Contract first) Pour réaliser un service Web à partir d’un fichier WSDL existant, suivre les instructions suivantes : 1. Créer un nouveau projet de type Web Application, et l’appeler HelloWorldApplication2. 2. Faire un clic-droit sur le nom du projet créé, et choisir : New -> Web Service from WSDL. 3. Nommer votre service web Hello2, votre package insat.soa.tp1.service2 et taper dans la case « Select Local WSDL File or Enter WSDL URL » l’URL vers le WSDL de votre première application HelloWorldService, soit : http://localhost:8080/HelloWorldService/HelloService?wsdl 4. Cliquer sur Finish. Modifier le contenu de la classe Hello2 de manière à implémenter votre service. On désire que l’implémentation soit identique à celle de la classe Hello du service HelloWorldService, avec la différence qu’au lieu d’afficher « Hello <name> ! », on veut qu’elle affiche « Bonjour <name> ! » . 5. Clic-droit sur votre projet, et choisir Clean and Build. Remarque : Il est possible que suite à cette manœuvre, la console vous affiche une erreur due à l’encodage. Le message sera comme suit : error: unmappable character for encoding UTF-8 Pour corriger cette erreur, faites un clic-droit sur votre projet, et choisir Properties. Dans la partie Sources et dans la liste déroulante Encoding, choisir ISO-8859-1. Refaites ensuite un Clean and Build à votre application. 6. Une fois le message Build Successful affiché, déployer votre service, et visualiser son fichier WSDL en tapant : http://localhost:8080/HelloWorldService2/Hello2Service?wsdl Architecture  Orientée  Services
• 7.
  TP1 : LesServices Web avec JAX-WS 7 Vérifier bien que ce fichier est identique au fichier WSDL du premier service. II.2. Consommation du service web Pour tester ou utiliser votre service web, plusieurs méthodes sont disponibles. Nous allons en montrer 3. II.2.1. Tester le service web avec le Tester de Glassfish Le serveur Glassfish vous fournit un outil pour tester votre service web directement sur le serveur. Pour cela, suivre les instructions suivantes : 1. Ouvrir un navigateur web et taper l’URL suivante : http://localhost:8080/HelloWorldService/HelloService?Tester 2. La page suivante sera affichée : 3. Taper votre nom dans la case qui vous est fournie, et cliquer sur SayHello. Observer le résultat, ainsi que les requêtes et réponses SOAP générées. 4. Faites le test également pour le service HelloWorldService2. Quelle est la différence entre les deux services ? II.2.2. Tester le service web avec soapUI Le serveur d’application qui héberge le service peut parfois être inaccessible à l’utilisateur. On dispose donc d’autres outils pour tester notre service web. On cite par exemple l’outil soapUI 4 qui est une solution de test open source et multi-plateforme, permettant de créer rapidement et facilement des tests fonctionnels, grâce à une interface graphique intuitive. 1. Installer l’outil soapui (il est inutile d’installer Hermer JMS). L’interface d’accueil a la forme suivante : 4 soapUI : www.soapui.org Architecture  Orientée  Services
• 8.
  8 TP1 : LesServices Web avec JAX-WS 2. Pour tester votre service, créer un nouveau projet en tapant : File -> New soapUI Project 3. Taper comme nom de projet HelloWorldTest et donner l’URL du fichier WSDL du service HelloWorldService. Cliquer ensuite sur OK. 4. L’arborescence de votre projet devient comme suit : 5. Double-cliquer sur Request1. La fenêtre suivante va s’ouvrir. 6. Le premier cadre représente la requête soap, et le second représentera la réponse. Pour tester le service, taper votre nom à la place du « ? » dans la balise <arg0> ?</arg0> 7. Cliquer sur la flèche et observer le résultat. Architecture  Orientée  Services
• 9.
  TP1 : LesServices Web avec JAX-WS 9 Refaites le test pour le service HelloWorldService2. II.2.3. Consommer le service web avec une application cliente Java Nous allons dans ce qui suit vous montrer comment consommer un service web avec une application en Java, en utilisant NetBeans. 1. Créer un nouveau projet de type : Enterprise Application Client (catégorie : JavaEE), que vous appellerez HelloWorldClient. 2. Pour définir un client au service web dans ce projet, faire un clic-droit sur le projet, et choisir : New -> Web Service Client… La fenêtre suivante va apparaître : 3. Entrer dans le champs WSDL URL, l’URL du fichier wsdl du service HelloWorldService 4. Définir comme package : insat.soa.tp1.client, et cliquer sur Finish 5. L’arborescence du projet devient alors comme suit : 6. Pour faire appel au service web, faites glisser la méthode sayHello (ci-dessus encadrée en rouge) qui se trouve dans Web Service References -> HelloService -> HelloService -> HelloPort dans le code de la classe Main.java 7. Dans la méthode main de cette classe, ajouter l’appel à cette méthode en tapant : System.out.println(sayHello(<votre nom>)) ; Architecture  Orientée  Services
• 10.
  10 TP1 : LesServices Web avec JAX-WS 8. Exécuter votre client, et observer le résultat. Refaites la même opération, dans le même projet client, pour le service HelloWorldService2, de manière à ce que l’affichage appelle les deux services l’un après l’autre. III. Homework On se propose de créer un convertisseur de monnaie du dinar vers l’euro et vice versa. Pour cela, réaliser les tâches suivantes : 1. Créer un service web ConvertisseurMonnaieService contenant deux méthodes : une méthode qui prend une valeur en dinar pour la traduire en euro, et une autre qui prend une valeur en euro pour la traduire en dinar. 2. Tester votre service web en utilisant les trois méthodes qui vous ont été montrées en TP. Date de remise du travail : prochaine séance de TP. Architecture  Orientée  Services