Creation servicewebjavaee

  • View
    283

  • Download
    0

Embed Size (px)

DESCRIPTION

Pour une prise en main de J2EE

Transcript

  • 1. Cration dun service web avec NetBeans 5.5 et SJAS 9 Cration dun service web avec NetBeans 5.5 et SJAS 9Sommaire1.Prsentation .........................................................................................................................................................22.Cration dun service web avec NetBeans ..........................................................................................................2 2.1. Cration dune application Web ..................................................................................................................2 2.2. Cration du service web ..............................................................................................................................4 2.3. Ajout dune mthode au service web ..........................................................................................................63.Gnration des javadocs .....................................................................................................................................74.Dploiement sur le serveur dapplication install avec NetBeans .......................................................................8 4.1. Dploiement partir de NetBeans ..............................................................................................................8 4.2. Test du service web partir de NetBeans ..................................................................................................85.Utilisation du service Web cr ..........................................................................................................................10 5.1. Serveur dapplication .................................................................................................................................10 5.2. Cration dun nouveau projet client ...........................................................................................................11 5.3. Intgration du fichier WSDL dans NetBeans.............................................................................................13 5.4. Utilisation du service web dans lapplication de test .................................................................................156.Dploiement sur un serveur dapplication autonome.........................................................................................17 BTS iris - Lyce Eiffel - ArmentiresPage 1 sur 21 04/03/2008

2. Cration dun service web avec NetBeans 5.5 et SJAS 91. PrsentationLobjectif de ce document est dexpliquer la cration et lutilisation dun service web avec NetBeans 5.5 enrespectant la norme JAX-WS 2.0.2. Cration dun service web avec NetBeans2.1. Cration dune application WebObjectifs : Mise en place du container web du serveur dapplication (SJAS). Il contiendra le site web JSP pardfaut (non utilis dans notre exemple) et nous allons y intgrer un service web.File > New Project > Web > Web ApplicationChoisissez le serveur dapplication sur lequel devra tre dploy le service web : Sun Java System ApplicationServer 9 (SJSAS) et Java EE 5.BTS iris - Lyce Eiffel - ArmentiresPage 2 sur 21 04/03/2008 3. Cration dun service web avec NetBeans 5.5 et SJAS 9 Aucun Frameworks de slectionn pour le moment. Cliquez sur Finish. NetBeans cr une application web contenant dj une page index.jsp :BTS iris - Lyce Eiffel - ArmentiresPage 3 sur 21 04/03/2008 4. Cration dun service web avec NetBeans 5.5 et SJAS 9 2.2. Cration du service web Clic droit sur le projet > New > File/Folder > Web Services > Web ServiceBTS iris - Lyce Eiffel - Armentires Page 4 sur 2104/03/2008 5. Cration dun service web avec NetBeans 5.5 et SJAS 9 Entrez le nom du service web : WebServiceIris1 Entrez le nom du package dans lequel doit tre cr les classes du service web : com.iris Remarque : Pas de doublon de nom du service web sur le mme serveur dapplications Cliquez sur Finish Aprs la cration du service web, NetBeans signale une erreur sur la classe WebServiceIris1 tant quaucune mthode na t cre.BTS iris - Lyce Eiffel - ArmentiresPage 5 sur 21 04/03/2008 6. Cration dun service web avec NetBeans 5.5 et SJAS 9 2.3. Ajout dune mthode au service web Dans longlet projects > Dossier Web Services > Clic droit > Add Operation Ajoutez la mthode direBonjour() en respectant lcran suivant : Voici le code gnr avec les annotations web services commenant par le caractre @ (spcifications du package javax.jws de Java EE 5)BTS iris - Lyce Eiffel - ArmentiresPage 6 sur 21 04/03/2008 7. Cration dun service web avec NetBeans 5.5 et SJAS 9@WebMethodpublic String direBonjour(@WebParam(name = "prmNom") String prmNom) {// TODO implement operationreturn null;} Ajoutez le code suivant la mthode :@WebMethodpublic String direBonjour(@WebParam(name = "prmNom") String prmNom) {String s = "" ;s = "Bonjour " + prmNom ;return s ;}3. Gnration des javadocs Pour respecter la norme de cration des services web, il faut gnrer les javadocs du projet. Clic droit sur le projet > Generate Javadocs for projectBTS iris - Lyce Eiffel - ArmentiresPage 7 sur 21 04/03/2008 8. Cration dun service web avec NetBeans 5.5 et SJAS 94. Dploiement sur le serveur dapplication install avec NetBeans 4.1. Dploiement partir de NetBeans Clic droit sur le projet > Deploy Project 4.2. Test du service web partir de NetBeans Dans longlet Projects > Clic droit sur le service web WebServiceIris1 > Test Web ServiceBTS iris - Lyce Eiffel - ArmentiresPage 8 sur 2104/03/2008 9. Cration dun service web avec NetBeans 5.5 et SJAS 9 Ce test ouvre une page web qui permet dappeler la mthode du service web et de rcuprer ladresse du fichier WSDL (utilis par les clients du web service)Clic droit sur le lien > copier le raccourci :Adresse du fichier WSDL =http://localhost:8080/WebAppIris/WebServiceIris1Service?WSDL Entrez un texte dans la zone de texte et cliquez sur le bouton direBonjour . Vous devez obtenir le rsultat suivant :BTS iris - Lyce Eiffel - Armentires Page 9 sur 21 04/03/2008 10. Cration dun service web avec NetBeans 5.5 et SJAS 9 Le service web est maintenant oprationnel.5. Utilisation du service Web cr 5.1. Serveur dapplication Vrifiez que le serveur dapplication utilis par le service web est bien dmarr. Dans NetBeans > Onglet Runtime > Clic droit sur Sun Java System Application Server 9 > StartBTS iris - Lyce Eiffel - ArmentiresPage 10 sur 2104/03/2008 11. Cration dun service web avec NetBeans 5.5 et SJAS 9 5.2. Cration dun nouveau projet client File > New Project > General > Java Application Dcochez Create Main Class BTS iris - Lyce Eiffel - ArmentiresPage 11 sur 21 04/03/2008 12. Cration dun service web avec NetBeans 5.5 et SJAS 9 Cration dune fiche graphique JFrame : Clic droit sur le projet > New > File/Folder > Java GUI Forms > JFrame Form Donnez un nom la classe : ClassJFrame Crez en mme temps le package pqtest Cliquez sur Finish Slection du nouveau JFrame comme classe principale du projet : Clic droit sur le projet > Properties > Run >Main Class = pqtest.ClassJFrame BTS iris - Lyce Eiffel - Armentires Page 12 sur 2104/03/2008 13. Cration dun service web avec NetBeans 5.5 et SJAS 9 Cration des composants de lIHM (affichage en mode Design ) : En cliquant glissant de la palette vers la JFrame, crez les composants suivants :jTextFieldNomjButton1jLabelReponse Remarque : les composants graphiques de la JFrame sont tous crs dans la mthode initComponents(). Cette mthode nest pas modifiable partir du code source, NetBeans ne prsente pas son code directement, il est repli dans lditeur de code source. 5.3. Intgration du fichier WSDL dans NetBeans Clic droit sur le projet > New > File / Folder > Web Services > Web Service ClientBTS iris - Lyce Eiffel - ArmentiresPage 13 sur 21 04/03/2008 14. Cration dun service web avec NetBeans 5.5 et SJAS 9 Remplir le champ WSDL URL avec ladresse du fichier WSDL rcupr prcdemment Remplir le champ Package avec pqtAccesWebServiceIris1 Cliquez sur FinishBTS iris - Lyce Eiffel - Armentires Page 14 sur 2104/03/2008 15. Cration dun service web avec NetBeans 5.5 et SJAS 9 NetBeans gnre le paquetage pqtAccesWebServiceIris1. Les classes gnres se situent dans le dossier WebServiceIris1AppliTestbuildclassespqtAccesWebServiceIris1. Les classes gnres lors de limportation sont les suivantes : Les mthodes du service web sont visibles dans linspecteur de projet dans le dossier Web Service References . 5.4. Utilisation du service web dans lapplication de test Cration de lvnement onClick sur le bouton JButton1 : Dans laffichage Design, clic droit sur le bouton JButton1 > Events > Mouse > mouseClicked Lappel de la mthode direBonjour() du service web peut se faire de deux faons : Cliquer glisser la mthode partir de linspecteur de projets vers le code souce Clic droit dans le code > Web Service Client Resources > Call web Service Operation > Selectionnez la mthode direBonjour() > OKBTS iris - Lyce Eiffel - Armentires Page 15 sur 2104/03/2008 16. Cration dun service web avec NetBeans 5.5 et SJAS 9 Voil le code gnr : private void jButton1MouseClicked(java.awt.event.MouseEvent evt) {try { // Call Web Service OperationpqtAccesWebServiceIris1.WebServiceIris1Service service = newpqtAccesWebServiceIris1.WebServiceIris1Service();pqtAccesWebServiceIris1.WebServiceIris1 port =service.getWebServiceIris1Port();// TODO initialize WS operation arguments herejava.lang.String prmNom = "";// TODO process result herejava.lang.String result = port.direBonjour(prmNom);System.out.println("Result = "+result);} catch (Exception ex) {// TODO handle custom exceptions here} } Remarque : par souci de lisibilit, nous avons supprim le nom du paquetage pqtAccesWebServiceIris1 devant chaque objet et nous avons import le paquetage au dbut du code source : import pqtAccesWebServiceIris1.* ; Modifiez le code pour prendre en compte les lments de linterface graphique :BTS i