1 Les technologies XML Cours 3 : Les Web Services – Implémentation – JAX-WS Février Version 1.0 -

2 Web Services JAX-WS remplace JAX-RPC à partir de JEE 5. Ce changement de nom reflète la changement de philosophie des développements Web Services en Java, passant dun modèle « RPC » à un modèle « document » A partir de J2SE 5, le langage intègre des annotations permettant de simplifier le développement de Web Services. Ces annotations correspondent à la JSR 224 et à la JSR 181.

3 Web Services La version intégré à JEE 5 est JAX-WS 2.0 Limplémentation de référence de la norme est un sous-projet OpenSource qui fait partie du projet « Metro ». Metro lui-même est un sous projet de GlassFish le serveur dapplication OpenSource de Sun.

4 WebServices – Encodage des messages Messages de type RPC Messages XML destinés à représenter, indépendamment du langage de programmation, linvocation dun service, ainsi que son résultat éventuel. La structure générale de la requête et de la réponse est imposée par la spécification. Cette dernière aborde aussi les problèmes dencodage des paramètres, notamment des tableaux et des graphes dobjets : RPC / encoded. Ce modèle de messages est le plus simple des deux, mais aussi le plus contraignant.

5 WebServices – Encodage des messages Messages de type Document La spécification SOAP nimpose, dans ce cas, aucune contrainte sur la structure de ces messages. Le sens des données XML véhiculées est laissé à lappréciation des applications participant à léchange. Ce modèle de messages offre plus de liberté, mais peut être à lorigine de problèmes dinteropérabilité.

6 WebServices – Encodage des messages Notez bien que dans les 2 cas, la structure des messages XML échangés est complètement décrite par le document WSDL. Dans le 1er cas, le serveur est obligé de respecter certaines règles. Dans le 2ème cas, il peut décrire nimporte quelle structure XML. Le modèle de messages de type RPC est tombé en désuétude : Dans SOAP 1.2, seul le support du modèle Document est obligatoire ; On constate une évolution similaire en Java avec la dernière API : JAX-WS 2.0 ; Quant à.Net, il préconise depuis le début lutilisation des messages de type Document. Gare donc aux problèmes dinteropérabilité entre les anciennes applications qui sappuient sur le modèle RPC et certains nouveaux outils qui ne supportent que le modèle Document. Pour invoquer un Web Service, les plates-formes sappuient donc aujourdhui sur le modèle Document. Mais, comme la structure des messages XML est libre, comment par exemple repérer dans le document XML le nom du service invoqué ? En fait, pour résoudre ce problème, les plates-formes utilisent généralement le modèle Document/literal wrapped. Ce modèle impose quelques contraintes. Notamment le fait que la balise racine du message XML transporté corresponde au nom de lopération invoquée.

7 Web Services Description des annotations JSR 181 (WS MetaData) Marque une classe comme Expose une méthode comme une opération Marque une action comme sans retour. Ne sapplique quà une méthode sans paramètre de Permet de spécifier lencodage du message (RPC ou Document)

8 Web Services Description des annotations JSR 181 (WS MetaData) Permet de spécifier le mapping entre un paramètre de la méthode java et un élément du message Permet de spécifier le mapping entre la valeur de retour de la méthode java et un élément du message Permet de préciser un fichier de configuration pour la factorisation des gestionnaires

9 Web Services Description des annotations JSR 224 (JAX-WS 2.0) Précise le type de bind du service Permet à JAXB de mapper les éléments XML de la requête avec les éléments java Permet à JAXB de mapper les éléments XML de la réponse avec les éléments java Permet laccès au message complet ou au Permet de gérer le mapping entre une exception Java et une Fault SOAP

10 Web Services - Serveurs serviceName="ConvertisseurService", targetNamespace="peut.etre.different") ….}ImplementationWebService(endpointInterface="fr.lgr.exemple.ws.Convertisseur") public class ConvertisseurImpl implements Convertisseur { public double getEuro(double franc) throws ConvertisseurException { public class ConvertisseurException extends RemoteException { …}

11 Web Services - Client Les classes clientes sont générées à laide dun outil. Exemple = "ConvertisseurImplService", targetNamespace = " wsdlLocation = " web/mesWebServices/Convertisseur?wsdl") public class ConvertisseurImplService extends Service extends Service{..}

12 Web Services - = "Convertisseur", targetNamespace = ObjectFactory.class ObjectFactory.class}) public interface Convertisseur { /** /** * arg0 arg0 * returns double * returns double @WebResult(targetNamespace = = = "getEuro", targetNamespace = "peut.etre.different", className = = "getEuro", targetNamespace = "peut.etre.different", className = = "getEuroResponse", targetNamespace = "peut.etre.different", className = = "getEuroResponse", targetNamespace = "peut.etre.different", className = "fr.lgr.exemple.ws.client.generated.GetEuroResponse") public double getEuro( public double = "arg0", targetNamespace = = "arg0", targetNamespace = "") double arg0); double arg0);

13 Web Services Référence