Netbeans Yaps

YAPS Pet Store sous NetBeans
par Sad Eloudrhiri

Date de publication : 08/12/2008 Dernire mise jour : 18/06/2009
Cet article va prsenter le portage de l'application "Yaps Pet Store", prsente par Antonio Goncalves dans son livre "Java EE 5", sous NetBeans.
YAPS Pet Store sous NetBeans par Sad Eloudrhiri
I - Introduction..............................................................................................................................................................5 II - Conventions............................................................................................................................................................7 II-A - Langue...........................................................................................................................................................7 II-B - Mots cls....................................................................................................................................................... 7 II-C - Rpertoires....................................................................................................................................................7 II-D - Commandes.................................................................................................................................................. 7 II-E - Messages...................................................................................................................................................... 7 III - Installation............................................................................................................................................................. 8 III-A - Prrequis...................................................................................................................................................... 8 III-B - NetBeans......................................................................................................................................................8 III-B-1 - Rcuprer NetBeans........................................................................................................................... 8 III-B-2 - Installer NetBeans............................................................................................................................. 10 III-B-2-a - Page d'accueil...........................................................................................................................10 III-B-2-b - License Agreement................................................................................................................... 13 III-B-2-c - Rpertoires d'installation........................................................................................................... 13 III-B-2-d - Proprits de GlassFish v2...................................................................................................... 14 III-B-2-e - GlassFish v3............................................................................................................................. 15 III-B-2-f - Apache Tomcat.......................................................................................................................... 16 III-B-2-g - Rsum..................................................................................................................................... 17 III-B-2-h - Finish.........................................................................................................................................18 III-B-3 - Dmarrer NetBeans...........................................................................................................................19 III-B-4 - Localisation........................................................................................................................................ 20 LLIII-C - Variables d'environnement..................................................................................................................... 21 LLIII-D - Rcuprer l'application Yaps................................................................................................................. 22 LLIII-E - Rcuprer l'application YapsON............................................................................................................ 23 IV - Configurer YapsON.............................................................................................................................................24 LLIV-A - Variables d'environnement.....................................................................................................................24 LLIV-B - Scripts Ant............................................................................................................................................. 24 V - Configurer GlassFish........................................................................................................................................... 25 LLV-A - Positionner les variables d'environnement............................................................................................. 25 LLV-B - Crer le domaine petstore ............................................................................................................... 26 LLV-C - Dmarrer le domaine petstore ......................................................................................................... 28 LLV-D - Localisation de GlassFish.......................................................................................................................30 LLV-E - Crer les ressources Database.............................................................................................................. 30 LLV-E-1 - Pool de connexions JDBC............................................................................................................. 31 LLV-E-2 - Dmarrer le serveur Derby............................................................................................................ 33 LLV-E-3 - Crer la base de donnes............................................................................................................. 33 LLV-E-4 - Crer la source de donnes.......................................................................................................... 34 LLV-F - Crer les ressources JMS...................................................................................................................... 35 LLV-F-1 - Crer la fabrique de connexion......................................................................................................35 LLV-F-3 - Vrification...................................................................................................................................... 36 LLV-G - Crer les loggers.................................................................................................................................... 37 LLV-H - Fin de la configuration............................................................................................................................ 38 LLV-G-1 - Stopper le serveur Derby...............................................................................................................38 LLV-G-2 - Stopper le domaine petstore ................................................................................................... 38 VI - Configurer NetBeans.......................................................................................................................................... 39 LLVI-A - Serveur Petstore ............................................................................................................................. 39 LLVI-A-1 - Ajout du serveur Petstore ....................................................................................................... 39 LLVI-A-1-a - Type de serveur....................................................................................................................39 LLVI-A-1-b - Slection du domaine........................................................................................................... 40 LLVI-A-1-c - Profil de l'administrateur....................................................................................................... 41 LLVI-A-2 - Liste des serveurs......................................................................................................................... 42 LLVI-A-3 - Affichage des traces......................................................................................................................43 LLVI-A-4 - Dmarrer le serveur Petstore........................................................................................................44 LLVI-A-5 - Explorer les ressources.................................................................................................................47 LLVI-A-6 - Accs la console d'administration..............................................................................................49 LLVI-B - Changer de browser.............................................................................................................................. 49 LLVI-C - Base de donnes...................................................................................................................................51
-2Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
http://noratek.developpez.com/tutoriel/javaee/netbeans/yapson/
LLVI-C-1 - Arrt et dmarrage du serveur de base de donnes....................................................................52 LLVI-C-2 - Vrifier les proprits.................................................................................................................... 53 LLVI-C-3 - Connexion vers la base de donnes............................................................................................ 56 LLVI-D - Conclusion............................................................................................................................................. 56 VII - Importer le projet BarkBank.............................................................................................................................. 57 LLVII-A - Crer un nouveau projet.......................................................................................................................57 LLVII-A-1 - Fermeture des projets.................................................................................................................. 57 LLVII-A-2 - Type de projet.............................................................................................................................. 58 LLVII-A-3 - Nom et rpertoires....................................................................................................................... 58 LLVII-A-4 - Configuration du serveur.............................................................................................................. 59 LLVII-A-5 - Les frameworks............................................................................................................................ 60 LLVII-A-6 - Gnration du projet.................................................................................................................... 61 LLVII-B - Transfrer le projet sous NetBeans......................................................................................................62 LLVII-B-1 - Positionner les variables d'environnement...................................................................................62 LLVII-B-2 - Transfrer le projet....................................................................................................................... 62 LLVII-B-3 - Crer le groupe de projet.............................................................................................................64 LLVII-C - Compiler le projet................................................................................................................................. 66 LLVII-4 - Dployer le projet.................................................................................................................................. 68 LLVII-E - Tester le projet...................................................................................................................................... 70 LLVII-E-1 - Mthode 1 : Web Service Tester de GlassFish............................................................................71 LLVII-E-2 - Mthode 2 : Web Service Tester de NetBeans............................................................................71 LLVII-F - Conclusion............................................................................................................................................. 79 VIII - Importer le projet PetEx................................................................................................................................... 80 LLVIII-A - Crer un nouveau projet......................................................................................................................80 LLVIII-A-1 - Fermeture des projets................................................................................................................. 80 LLVIII-A-2 - Type de projet............................................................................................................................. 81 LLVIII-A-3 - Nom et rpertoires...................................................................................................................... 81 LLVIII-A-4 - Configuration du serveur............................................................................................................. 82 LLVIII-A-5 - Les frameworks........................................................................................................................... 83 LLVIII-A-6 - Gnration du projet................................................................................................................... 84 LLVIII-B - Transfrer le projet sous NetBeans.....................................................................................................85 LLVIII-B-1 - Positionner les variables d'environnement..................................................................................85 LLVIII-B-2 - Transfrer le projet...................................................................................................................... 85 LLVIII-B-3 - Crer le groupe de projet............................................................................................................87 LLVIII-C - Compiler le projet................................................................................................................................ 89 LLVIII-D - Dployer le projet................................................................................................................................ 91 LLVIII-E - Tester le projet..................................................................................................................................... 93 LLVIII-E-1 - Mthode 1: Web Service Tester de GlassFish............................................................................94 LLVIII-E-2 - Mthode 2: Web Service Tester de NetBeans............................................................................94 LLVIII-F - Conclusion.......................................................................................................................................... 101 IX - Importer le projet Yaps - ct serveur............................................................................................................. 102 LLIX-A - Crer un nouveau projet..................................................................................................................... 102 LLIX-A-1 - Fermeture des projets.................................................................................................................102 LLIX-A-2 - Type de projet............................................................................................................................. 103 LLIX-A-3 - Nom et rpertoires...................................................................................................................... 103 LLIX-A-4 - Configuration du serveur.............................................................................................................104 LLIX-A-5 - Gnration du projet................................................................................................................... 105 LLIX-B - Transfrer le projet sous NetBeans.....................................................................................................106 LLIX-B-1 - Positionner les variables d'environnement..................................................................................106 LLIX-B-2 - Transfrer le projet......................................................................................................................107 LLIX-B-3 - Rfrencer les Web Services..................................................................................................... 110 LLIX-B-3-a - Rfrencer DeliveryService................................................................................................ 110 LLIX-B-3-b - Rfrencer ValidationService..............................................................................................113 LLIX-B-4 - Crer le groupe de projet........................................................................................................... 116 LLIX-C - Changer le Context Root.....................................................................................................................118 LLIX-D - Crer le fichier de dploiement standard............................................................................................ 119 LLIX-E - Compiler le projet................................................................................................................................ 122 LLIX-F - Dployer le projet.................................................................................................................................123
LLIX-G - Base de donnes................................................................................................................................ 125 LLIX-G-1 - Crer une connexion.................................................................................................................. 125 LLIX-G-2 - Connexion la DB..................................................................................................................... 129 LLIX-G-3 - Explorer la DB............................................................................................................................ 131 LLIX-G-4 - Donnes de test......................................................................................................................... 134 LLIX-G-4-a - Mthode 1 : Chargement manuel des donnes de test.....................................................135 LLIX-G-4-b - Mthode 2 : Chargement automatique des donnes de test............................................. 138 LLIX-H - Tester le projet.....................................................................................................................................146 LLIX-I - Conclusion.............................................................................................................................................150 X - Importer le projet Yaps - ct client.................................................................................................................. 151 LLX-A - Crer un nouveau projet...................................................................................................................... 151 LLX-A-1-a - Fermer les projets.....................................................................................................................151 LLX-A-1-b - Type de projet......................................................................................................................151 LLX-A-1-c - Nom et rpertoires...............................................................................................................152 LLX-A-1-d - Gnration du projet............................................................................................................154 LLX-B - Transfrer le projet sous NetBeans......................................................................................................154 LLX-B-1 - Positionner les variables d'environnement...................................................................................154 LLX-B-2 - Transfrer le projet.......................................................................................................................154 LLX-B-3 - Rfrencer les librairies............................................................................................................... 156 LLX-B-3-a - Rfrencer les classes de Yaps-Server.............................................................................. 157 LLX-B-3-b - Rfrencer les librairies utilitaires....................................................................................... 161 LLX-B-3-c - Rfrencer les librairies JMS.............................................................................................. 163 LLX-B-3-d - Rfrencer les librairies TopLink......................................................................................... 171 LLX-B-4 - Identifier la classe principale........................................................................................................174 LLX-B-5 - Crer le groupe de projet............................................................................................................ 177 LLX-C - Compiler le projet................................................................................................................................. 179 LLX-D - Tester le projet......................................................................................................................................182 LLX-D-1 - Dmarrer le serveur PetStore......................................................................................................182 LLX-D-2 - Excuter l'application Yaps-Client................................................................................................182 LLX-E - Conclusion............................................................................................................................................ 185 XI - Conclusion........................................................................................................................................................ 186 XII - Rfrences.......................................................................................................................................................187 XIII - Glossaire......................................................................................................................................................... 188
I - Introduction
Dans le livre d'Antonio Goncalves consacr Java EE5 (voir ici), l'auteur illustre les principaux concepts de JEE 5 au travers d'une application fictive baptise Yaps Pet Store (ou Yaps pour faire court). Cette application est elle-mme une manation du Java Petstore de Sun issue du programme Java BluePrints. Le livre de rfrence coupl l'application Yaps est un excellent support pdagogique pour qui souhaite aborder et exprimenter le vaste sujet qu'est JEE 5. Les sujets du livre de rfrence sont traits de manire construire pas pas les diffrents composants de l'application en abordant les principales spcifications de JEE5 : EJB, JPA, JMS, JAX-WS, JavaMail, etc. L'auteur a pris le parti d'tre indpendant d'un quelconque IDE. Des tches Ant sont utilises pour configurer l'environnement de travail, ainsi que pour construire et dployer les projets de l'application. Ce document a pour objectif de dcrire les diffrentes tapes ncessaires pour porter l'application Yaps sous l'IDE de Sun : NetBeans 6.5 Pourquoi NetBeans ? Loin de nous l'ide de dbattre entre tel ou tel IDE. Chaque IDE a ses forces et faiblesses. Le plus important est que l'IDE choisi (Eclipse, NetBeans, IntelliJ, etc.) soit un moteur et non un frein dans le processus d'industrialisation de logiciels. Par ailleurs, connatre plus d'un IDE est une valeur ajoute. En tant que consultants informatiques, nous sommes souvent amens adapter nos habitudes par rapport l'environnement de l'entreprise dans laquelle nous intervenons. Le choix des outils logiciels est souvent dict par des contraintes tant financires, techniques ou culturelles. Dans le cas de notre entreprise, NetBeans est trs apprci notamment pour sa couche SOA. Les outils SOA intgrs NetBeans ainsi que l'ESB (Enterprise Service Bus) OpenESB sont excellents pour concevoir des prototypes applicatifs. Mais c'est un autre sujet que nous aurons probablement l'occasion d'aborder dans le cadre d'un autre document. NetBeans coupl GlassFish est le partenaire idal pour aborder les concepts JEE5. Et c'est justement l'objectif de ce document. partir du livre de rfrence et de l'application Yaps, nous allons importer l'ensemble des projets sous NetBeans 6.5 pour obtenir un environnement complet et gratuit pour exprimenter les diffrents sujets du livre et aller plus loin dans la dcouverte des concepts entourant les spcifications JEE 5. Ce document est subdivis comme suit :
Installation Configurer YapsON Configurer GlassFish Configurer NetBeans Importer le projet BarkBank Importer le projet PetEx Importer le projet Yaps - ct serveur Importer le projet Yaps - ct client Conclusion
Installation de NetBeans et des fichiers ncessaires au processus d'importation de l'application Yaps Pet Store. Dcris la configuration apporter aux fichiers livrs avec l'application initiale YapsON. La configuration de GlassFish ncessaire avant de pouvoir dployer les diffrents projets. La configuration de NetBeans avant d'accueillir les projets dployer. L'importation et le dploiement du projet BarkBank. L'importation et le dploiement du projet PetEx. L'importation et le dploiement de la partie serveur du projet Yaps. L'importation et le dploiement de la partie cliente du projet Yaps. La conclusion de ce document.
II - Conventions II-A - Langue

Dans ce document, les copies d'crans des logiciels utiliss (Microsoft Windows, NetBeans, etc.) sont en anglais. Ils peuvent donc diffrer de votre environnement.
II-B - Mots cls

Le tableau suivant fournit l'ensemble des mots cls utiliss dans le document : Livre de rfrence Yaps YapsON Par "Livre de rfrence", nous entendons le livre sur Java EE5 d'Antonio Goncalves (voir [R1]). Identifie l'application originale Yaps Pet Store fournie par l'auteur du livre de rfrence. Identifie l'application Yaps importe sous NetBeans (Yaps Pet Store on NetBeans).
II-C - Rpertoires
{netbeans_home} {glassfish_home} {yaps_home} {yaps_on_home} Rpertoire d'installation de NetBeans. Rpertoire d'installation de GlassFish v2. Rpertoire hbergeant l'application originale Yaps Pet Store. Rpertoire de l'application Yaps cr sous NetBeans.
II-D - Commandes
Les commandes sont reprsentes de la manire suivante :
C:\> echo "This is a command" Cette commande affiche l'cran la phrase suivante: "This is a command".
II-E - Messages
Dans le document, des messages peuvent apparatre pour alerter ou informer le lecteur. Un message d'alerte. Un message d'information.
III - Installation III-A - Prrequis

Ce document a t conu avec la configuration logicielle suivante: Microsoft Windows Vista Service Pack 1 ou suprieur Sun Java Development Kit (JDK) 1.6 Update 7 ou suprieur Ant 1.7.0 ou suprieur NetBeans 6.5 install avec le Bundle All Les fichiers de Yaps Les fichiers de YapsON
Le chapitre 3 du livre de rfrence dcrit comment installer le JDK et Ant.
III-B - NetBeans
NetBeans 6.5 est l'IDE (Integrated Development Environment) Open Source de Sun conu pour concevoir, dployer et tester des applications dveloppes sous diffrents langages (Java, PHP, Ruby, C/C++, etc.). Tout comme Eclipse, NetBeans utilise la notion de plug-ins pour enrichir son environnement de dveloppement. En ce qui concerne JEE5, NetBeans fournit un environnement riche et complet pour concevoir des applications (visuelles ou non) et les dployer au sein de serveurs tels que GlassFish ou Tomcat qui font partie intgrante du kit d'installation. NetBeans est disponible sous diffrents bundles. Chacun couvrant un ensemble de fonctionnalits. Ce document a t conu sur base du bundle All de NetBeans. Mais vous pouvez vous contenter du bundle Java et rcuprer plus tard les plug-ins qui vous intressent (par exemple le stack SOA).
III-B-1 - Rcuprer NetBeans

NetBeans 6.5 peut tre tlcharg gratuitement partir du site de Sun l'adresse suivante: http://www.netbeans.org La page affiche la dernire version en date de NetBeans.
Cliquez sur le bouton "Download NetBeans IDE" pour continuer. La page de tlchargement permet de dfinir les proprits du kit NetBeans : Langue de travail Plateforme
Ensuite, il vous reste slectionner le type de bundle :
Ce document est conu partir du bundle "All". Cliquez sur le bouton "Download" pour tlcharger NetBeans. Le site de NetBeans regorge d'information utile qui facilitera votre prise en main de cet IDE. Vous trouverez notamment bon nombre de tutoriaux estampills avec la version de l'IDE qui est supporte.
III-B-2 - Installer NetBeans

Vous allez passer en revue les diffrentes tapes requises pour installer NetBeans. Commencez par excuter le fichier "netbeans-6.5-ml-windows.exe".
III-B-2-a - Page d'accueil

La page d'accueil permet d'emble de dfinir la liste des composants installer :
- 10 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
Le seul composant optionnel est le serveur d'applications Tomcat version 6 . Si vous souhaitez modifier la liste des composants installer, cliquez sur le bouton Customize :
Dans l'cran ci-dessus, on remarque que l'ensemble des composants a t slectionn. Dans le contexte de l'application YapsON, veillez slectionner les composants suivants : Base IDE Java SE Common Web Components Java Web and EE GlassFish V2 R2
Cliquez sur OK pour valider votre configuration. Ensuite, cliquez sur Next pour continuer.
III-B-2-b - License Agreement

Cette tape prsente la licence Open Source utilise par NetBeans :
Acceptez les termes de la licence et cliquez sur "Next" pour continuer.
III-B-2-c - Rpertoires d'installation

Cette tape permet de dfinir les rpertoires d'installation de NetBeans et de localiser le JDK prinstall dans votre environnement :
Cliquez sur Next pour continuer.
III-B-2-d - Proprits de GlassFish v2

Proprits de GlassFish v2
Nous avons gard les paramtres par dfaut savoir : GlassFish JDK Admin Username Admin Password Ports Cliquez sur Next pour continuer. Le dossier o sera install GlassFish v2. Le dossier o a t install le JDK. Le nom qui sera utilis pour administrer GlassFish. Le dfaut est: admin Le mot de pass de l'administrateur de GlassFish. Le dfaut est: adminadmin Les numros de port.
III-B-2-e - GlassFish v3
La version 3 de GlassFish est livre titre d'valuation (Prelude version). L'application YapsON n'utilise pas GlassFish v3 :
Vous pouvez garder le dfaut et cliquer sur Next pour continuer.
III-B-2-f - Apache Tomcat

Cette tape apparat uniquement si vous avez slectionn le package optionnel de Tomcat. Dans ce cas, l'cran suivant vous demande de choisir le rpertoire d'installation de Tomcat v6 ou d'accepter le dfaut :
III-B-2-g - Rsum
La page suivante prsente un rsum du paramtrage :
Cliquez sur Install pour dmarrer le processus d'installation.
III-B-2-h - Finish
la fin de l'installation, la dernire tape vous demande d'enregistrer NetBeans et GlassFish :
Cliquez sur Finish pour terminer le processus d'installation.
III-B-3 - Dmarrer NetBeans

Dmarrez NetBeans sous le lien: Start -> All Programs -> NetBeans -> NetBeans IDE 6.5 NetBeans offre un processus automatique qui lui permet de vrifier la prsence de mises jour. Ce processus est enclench chaque dmarrage de NetBeans :
Un message dans la barre de statut vous informe de la prsence des mises jour :
Pour visualiser la liste des mises jour et les appliquer, cliquez sur l'icne de la barre de statut. Il est bien entendu recommand d'appliquer ces mises jour.
III-B-4 - Localisation
Par dfaut, NetBeans utilise la localisation courante pour afficher ses botes de dialogues. Vous pouvez forcer une localisation spcifique en modifiant le fichier netbeans.conf de NetBeans qui se trouve l'emplacement suivant :
{netbeans_home}\etc\netbeans.conf
Dans ce fichier, modifiez l'entre "netbeans_default_options" pour y ajouter l'option :

--locale <code_langue>
Par exemple, pour forcer le code langue en anglais :

--locale EN
Ci-dessous, un extrait du fichier de configuration montre le code langue fix EN :

... # Options used by NetBeans launcher by default, can be overridden by explicit # command line switches: netbeans_default_options="-JDorg. netbeans.modules.tomcat.autoregister.token=1227909276055 -J Dorg.netbeans.modules.tomcat.autoregister.catalinaHome=\"C:\Program Files\Apache Software Foundation\Apache Tomcat 6.0.18\" -JDorg. glassfish.v3.installRoot=\"C:\Program Files\glassfish-v3-prelude\" -JDcom. sun.aas.installRoot=\"C:\Program Files\glassfish-v2ur2\" -J-client -JXverify: none -J-Xss2m -J-Xms32m -J-XX:PermSize=32m -J-XX:MaxPermSize=200m J-Dapple.laf.useScreenMenuBar=true -J-Dsun.java2d.noddraw=true --locale EN" ...
LLIII-C - Variables d'environnement

Il sera quelquefois ncessaire d'excuter des instructions via la ligne de commande. Pour ce faire, les variables d'environnement suivantes doivent tre dfinies dans votre systme: GLASSFISH_HOME ANT_HOME JAVA_HOME
La variable d'environnement PATH doit galement tre adapte pour localiser les logiciels requis. Ci-dessous, nous donnons un exemple de dfinition de variables d'environnement sous MS-Windows:
C:\> C:\> C:\> C:\> C:\> C:\> set set set set set set ANT_HOME=C:\Tools\Ant\apache-ant-1.7.1 PATH=%ANT_HOME%\bin;%PATH% GLASSFISH_HOME=C:\Program Files\glassfish-v2ur2 PATH=%GLASSFISH_HOME%\bin;%PATH% JAVA_HOME=C:\Program Files\Java\jdk1.6.0_10 PATH=%JAVA_HOME%\bin;%PATH%
Ces variables d'environnement peuvent galement tre dfinies dans les proprits systme de MS-Windows.
LLIII-D - Rcuprer l'application Yaps

Rcuprez l'application Yaps que sera importe sous NetBeans. L'application Yaps se trouve l'adresse suivante : http://www.antoniogoncalves.org/xwiki/bin/view/Book/JavaEE5Fr Dans cette page, reportez-vous la section relative au tlchargement du code source :
Ce document est bas sur une version 1.6 du JDK. Veillez tlcharger le code source de l'application Yaps correspondant au JDK 1.6. Ensuite, vous devez extraire le fichier d'archives dans un rpertoire qui sera rfrenc dans la suite du document sous le nom {yaps_home}. Les rpertoires et les documents suivants sont extraits du fichier d'archives :
Le livre de rfrence dtaille l'ensemble des rpertoires.
LLIII-E - Rcuprer l'application YapsON

L'application YapsON est disponible sous deux archives diffrentes: YapsON-initial.zip Ce fichier contient la version minimale de l'application YapsON utilise comme point de dpart au processus de portage dcrit dans ce document. Ce fichier contient la version complte de l'application YapsON telle qu'obtenue aprs la phase de portage dcrite dans ce document.
YapsON-complete.zip
Ce document dcrit les tapes de portage appliquer sur la version minimale de l'application YapsON. La version minimale est compose des fichiers suivants : admin.xml setenv-yaps.cmd yapson.xml yapson.properties yaps-data.xml Ce fichier Ant provient du projet Yaps Pet Store et contient un ensemble de tches pour configurer et grer GlassFish et Derby. Fichier de commande dfinissant les variables d'environnement JAVA_HOME, ANT_HOME, GLASSFISH_HOME. Fichier de script Ant permettant le transfert des projets Yaps vers l'arborescence de NetBeans. Fichier de proprits utilis par le script Ant yapson.xml . Fichier de script Ant utilis pour charger la base de donnes avec les donnes de test.
Les fichiers de l'application YapsON sont disponibles l'adresse suivante : http://www.noratek.net/2008/12/08/yaps-sous-netbeans-65/ Vous devez rcuprer et extraire le fichier d'archives YapsON-initial.zip dans un rpertoire qui sera rfrenc dans la suite du document sous le nom {yaps_on_home} :
IV - Configurer YapsON
Avant d'entamer le processus de configuration, vous allez configurer les fichiers de commande livrs avec le fichier d'archives de l'application YapsON.
LLIV-A - Variables d'environnement

ditez le fichier setenv-yaps.cmd et modifiez les variables d'environnements suivantes pour y placer les rpertoires d'installation adquats : YAPS_HOME YAPSON_HOME GLASSFISH_HOME ANT_HOME JAVA_HOME Rpertoire d'installation de l'application Yaps (voir ici). Rpertoire d'installation de l'application YapsON (voir ici). Rpertoire d'installation de GlassFish v2 (voir ici). Rpertoire d'installation d'Ant (voir ici). Rpertoire d'installation du JDK (voir ici).
LLIV-B - Scripts Ant

ditez le fichier yapson.properties et modifiez les proprits suivantes : yaps.folder yapson.folder Rpertoire d'installation de l'application Yaps (voir ici). Rpertoire d'installation de l'application YapsON (voir ici).
Il y a galement lieu d'diter le fichier yaps-data.xml afin de modifier la proprit suivante : glassfish.home Rpertoire d'installation de GlassFish v2 (voir ici).
V - Configurer GlassFish
La configuration du serveur d'applications GlassFish est similaire celle expose dans le livre de rfrence et rsume dans le fichier readme.txt livr avec le fichier d'archives de Yaps. Afin de rendre ce document autonome, nous allons rappeler les commandes ncessaires pour configurer GlassFish. Pour cela, vous allez utiliser les tches Ant partir de la ligne de commande.
LLV-A - Positionner les variables d'environnement

Avant tout, vous devez positionner les variables d'environnement ncessaires pour l'excution des tches Ant de configuration. Rendez-vous dans le rpertoire de l'application YapsON et excutez le fichier de commande setenv-yaps.cmd :
C:> cd {yapson_home} {yapson_home}> setenv-yaps.cmd
LLV-B - Crer le domaine petstore

Sous GlassFish, vous allez crer le domaine petstore dans lequel seront dploys les projets de l'application YapsON. Les proprits du domaine petstore sont les suivantes : Name http port number Admin port number Admin username Admin password Master password petstore 8080 8282 admin adminpwd masterpwd
Excutez la commande asadmin suivante afin de crer le domaine petstore :

{yapson_home}> asadmin create-domain --adminport 8282 --user admin --savemasterpassword=true -instanceport 8080 petstore
La procdure de cration du domaine petstore vous demande de dfinir les mots de passe admin et master :
... Please Please Please Please ...
enter enter enter enter
the the the the
admin password> admin password again> master password [Enter to accept the default]:> master password again [Enter to accept the default]:>
Pour rester conforme au livre de rfrence, vous allez introduire les mots de passe suivants: adminpwd pour le admin password masterpwd pour le master password
Pour terminer, la procdure vous informe des numros de ports assigns au domaine petstore :
... Using port 8282 for Admin. Using port 8080 for HTTP Instance. Using default port 7676 for JMS. Using default port 3700 for IIOP. Using default port 8181 for HTTP_SSL. Using default port 3820 for IIOP_SSL. Using default port 3920 for IIOP_MUTUALAUTH. Using default port 8686 for JMX_ADMIN. Domain being created with profile:developer, as specified by variable AS_ADMIN_PROFILE in configuration file. - 26 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
YAPS Pet Store sous NetBeans par Sad Eloudrhiri Security Store uses: JKS Domain petstore created.
ce stade, le domaine "petstore" est physiquement cr sous le rpertoire domains de GlassFish :

{yapson_home}> dir {glassfish_home}\domains\petstore ... 06/11/2008 23:59 <DIR> . 06/11/2008 23:59 <DIR> .. 06/11/2008 23:59 <DIR> addons 06/11/2008 23:59 <DIR> applications 06/11/2008 23:59 <DIR> autodeploy 06/11/2008 23:59 <DIR> bin 06/11/2008 23:59 <DIR> config 06/11/2008 23:59 <DIR> docroot 06/11/2008 23:59 <DIR> generated 06/11/2008 23:59 <DIR> imq 06/11/2008 23:59 <DIR> java-web-start 06/11/2008 23:59 <DIR> jbi 06/11/2008 23:59 <DIR> lib 06/11/2008 23:59 <DIR> logs 06/11/2008 23:59 500 master-password 06/11/2008 23:59 <DIR> session-store 1 File(s) 500 bytes 15 Dir(s) 149.829.881.856 bytes free
Suppression d'un domaine sous GlassFish Lors des phases de tests, on peut tre amen devoir supprimer un domaine. Le script Ant admin.xml propose le target delete-domain pour supprimer un domaine de GlassFish. On peut galement directement utiliser l'interface d'administration de GlassFish comme illustr ci-dessous. Tout d'abord, veuillez dmarrer l'interface d'administration via la commande asadmin :
{yapson_home}> asadmin ... Use "exit" to exit and "help" for online help. asadmin>
l'invite de l'interface d'administration, vous pouvez supprimer le domaine en utilisant la commande delete-domain :
delete-domain --domaindir {glassfish_home}\domains petstore Domain petstore deleted.
Cette commande ncessite d'identifier : le rpertoire domains de GlassFish
le nom du domaine supprimer (dans notre exemple, il s'agit du domaine petstore )
Pour sortir de l'interface asadmin , il suffit d'introduire la commande exit .
LLV-C - Dmarrer le domaine petstore

Le domaine petstore que vous venez de crer doit tre dmarr afin de poursuivre la configuration du serveur GlassFish. L'application YapsON fournit le fichier admin.xml contenant des tches qui permettent de dmarrer et stopper le domaine. Placez-vous dans le rpertoire de l'application YapsON:
C:\> cd {yapson_home} {yapson_home}>
Excuter la tche start-domain pour dmarrer le domaine petstore :

{yapson_home}> ant -f admin.xml start-domain
Les traces doivent indiquer que le domaine petstore est correctement dmarr :
... [exec] Domain [petstore] is running [Sun Java System Application Server 9.1_02 (build b04fcs)] with its configuration and logs at: [C:\Program Files\glassfish-v2ur2\domains]. ...
ce stade, il est possible d'accder la console d'administration du domaine petstore au travers du lien suivant : http://localhost:8282 L'cran de login suivant apparat :
Sur base de notre configuration (voir ici), les informations suivantes doivent tre introduites : User Name : admin Password : adminpwd
La console d'administration apparat l'cran :
LLV-D - Localisation de GlassFish

Par dfaut, la console d'administration de GlassFish utilise la localisation dfinie sur le systme. Nous allons dcrire comment changer la localisation sous GlassFish: Ouvrez la console d'administration accessible l'adresse http://localhost:8282. Connectez-vous avec votre compte administrateur. Slectionnez le noeud Application Server. Slectionnez l'onglet Advanced et ensuite Domain Attributes. Changez la valeur de l'entre Locale pour y dfinir le code langue que vous souhaitez utiliser. Sauvez vos modifications.
La modification du code langue ncessite un redmarrage du serveur GlassFish. La figure suivante illustre l'application de l'anglais (en-UK) comme langue de travail :
LLV-E - Crer les ressources Database

Les donnes de l'application Yaps sont maintenues dans une base de donnes de type Sun Java DB. Sun Java DB et Apache Derby Il n'existe pas de diffrence entre Sun Java DB et Apache Derby. Apache Derby est packag par Sun sous le nom Java DB.
Cette section dcrit le processus de cration de l'ensemble des ressources requises pour accder et manipuler la base de donnes petstoreDB . Base de donnes sous MySQL La base de donnes de l'application Yaps peut tre dfinie sous MySQL. L'auteur du livre de rfrence dcrit comment modifier la configuration pour supporter MySQL : http://www.antoniogoncalves.org/xwiki/bin/view/Book/JavaEE5InstallMySQLFr Commencez par vous placer dans le rpertoire de l'application YAPS:
C:\> cd {yapson_home} {yapson_home}>
LLV-E-1 - Pool de connexions JDBC

Excutez la tche create-connection-pool pour crer le pool de connexions petstorePool :
{yapson_home}> ant -f admin.xml create-connection-pool ... [exec] Command create-jdbc-connection-pool executed successfully. ...
En recherchant le statut BUILD SUCCESSFUL , on s'assure que l'excution de la tche s'est correctement droule. La tche list-connexion-pool permet de vrifier que le pool de connexion JDBC a t correctement cr :
{yapson_home}> ant -f admin.xml list-connection-pool ... [exec] __CallFlowPool [exec] __TimerPool [exec] DerbyPool [exec] petstorePool [exec] Command list-jdbc-connection-pools executed successfully. [exec] [exec] C:\Projects\YapsON>endlocal BUILD SUCCESSFUL
Une autre manire consiste se rendre sur la console d'administration de GlassFish. Le pool de connexions JDBC se trouve l'emplacement suivant : Resources -> JDBC -> Connection Pools -> petstorePool
N'hsitez pas inspecter les proprits du pool de connexion petstorePool . Les proprits dfinies dans l'onglet Additional Properties seront utilises plus tard lors de la cration de la base de donnes :
LLV-E-2 - Dmarrer le serveur Derby

Avant de poursuivre le processus, il est ncessaire de dmarrer le serveur de base de donnes Derby. Excutez la tche start-db pour dmarrer Derby :
{yapson_home}> ant -f admin.xml start-db ... [exec] Starting database in the background. [exec] Log redirected to c:\Program Files\glassfish-v2ur2/javadb\derby.log. [exec] Command start-database executed successfully. ...
LLV-E-3 - Crer la base de donnes

La base de donnes est cre en excutant un ping vers le pool de connexion. Excutez la tche ping-connection-pool pour crer la base de donnes petstoreDB :
{yapson_home}> ant -f admin.xml ping-connection-pool ... [exec] Command ping-connection-pool executed successfully. ...
La base de donnes petstoreDB est maintenant cre sous le rpertoire javadb de GlassFish :
{glassfish_home}\javadb\petstoreDB
LLV-E-4 - Crer la source de donnes

La source de donnes (data source) permet l'application d'accder la base de donnes. Excutez la tche create-datasource pour crer la source de donnes petstoreDS :
{yapson_home}> ant -f admin.xml create-datasource ... [exec] Command create-jdbc-resource executed successfully. ...
Utilisez la tche list-datasource pour vrifier que la data source a bien t cre :
{yapson_home}> ant -f admin.xml list-datasource ... [exec] jdbc/__TimerPool [exec] jdbc/__CallFlowPool - 34 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
YAPS Pet Store sous NetBeans par Sad Eloudrhiri [exec] jdbc/__default [exec] jdbc/petstoreDS [exec] Command list-jdbc-resources executed successfully.
Une autre manire consiste se rendre sur la console d'administration de GlassFish. Le pool de connexions JDBC se trouve l'emplacement suivant : Resources-> JDBC-> JDBC Resources-> jdbc/petstoreDS
LLV-F - Crer les ressources JMS

Vous allez maintenant crer les ressources JMS que sont la file d'attente (JMS topic) et la fabrique de connexion (Connection Factory).
LLV-F-1 - Crer la fabrique de connexion

Excutez la tche create-jms-connection-factory pour crer la fabrique de connexion JMS (Connection Factory) jms/petstoreConnectionFactory :
{yapson_home}> ant -f admin.xml create-jms-connection-factory ... - 35 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
YAPS Pet Store sous NetBeans par Sad Eloudrhiri [exec] Command create-jms-resource executed successfully.] ]></code> <paragraph> </paragraph> </section> <section id="V-F-2"> <title>Crer la file d'attente</title> <paragraph> Excutez la tche <b>create-jms-topic</b> pour crer la file d'attente (<b>JMS</b> topic) jms/topic/order : </paragraph> <code langage="other"><![CDATA[ {yapson_home}> ant -f admin.xml create-jms-topic ... [exec] Command create-jms-resource executed successfully.
LLV-F-3 - Vrification
Utilisez la tche list-jms-resources pour numrer les ressources JMS dfinies sous GlassFish :
{yapson_home}> ant -f admin.xml list-jms-resources ... [exec] jms/topic/order [exec] jms/petstoreConnectionFactory [exec] Command list-jms-resources executed successfully. BUILD SUCCESSFUL
Vous devez vous assurer que la file d'attente jms/topic/order et la fabrique de connexion jms/ petstoreConnectionFactory ont bien t cres. Une autre manire consiste se rendre sur la console d'administration de GlassFish. Les ressources JMS se trouvent aux emplacements suivants : Resources -> JMS Resources -> Connection Factories Resources -> JMS Resources -> Destination Resources
LLV-G - Crer les loggers

Les loggers sont utiliss par l'application pour gnrer des traces (messages d'erreur, informations de debug, audit, etc.). Excutez la tche set-loggers pour crer les loggers de chaque composant (petsore, barkbank, petex) :
{yapson_home}> ant -f admin.xml set-loggers ... [exec] server.log-service.module-log-levels.property.com.yaps.petstore = FINEST ... [exec] server.log-service.module-log-levels.property.com.barkbank = FINEST ... [exec] server.log-service.module-log-levels.property.com.petex = FINEST ...
La console d'administration de GlassFish vous permet de vrifier la prsence des loggers. Rendez-vous l'emplacement suivant : Application Server -> Logging -> Log Level La page Log Levels prsente la section Additional Properties dans laquelle sont dfinis les loggers :
LLV-H - Fin de la configuration

ce stade, nos environnements GlassFish et Derby sont configurs pour accueillir l'application Yaps. Le reste du processus de configuration va se poursuivre sous NetBeans. Vous allez maintenant stopper le serveur de base de donnes Derby et le domaine petstore . Ceux-ci seront dmarrs en temps voulu sous NetBeans.
LLV-G-1 - Stopper le serveur Derby

Excutez la tche Ant stop-db pour stopper le serveur de base de donnes Derby :
{yapson_home}> ant -f admin.xml stop-db ... [exec] Command stop-database executed successfully.
LLV-G-2 - Stopper le domaine petstore

Excutez la tche Ant stop-domain pour stopper le domaine applicatif petstore :
{yapson_home}> ant -f admin.xml stop-domain ... [exec] Domain petstore stopped.
VI - Configurer NetBeans
Avant de procder au portage des projets Yaps sous NetBeans, il est ncessaire de configurer l'IDE. Veuillez dmarrer NetBeans comme dcrit dans la section 3.2.3.
LLVI-A - Serveur Petstore LLVI-A-1 - Ajout du serveur Petstore

Vous allez procder l'ajout d'un serveur de type GlassFish v2 qui sera li au domaine petstore que vous avez prcdemment cr. Par dfaut, le serveur GlassFish v2 dfini sous NetBeans est configur avec le domaine domain1 . Slectionnez l'onglet Services et ensuite un clic droit sur le noeud Servers :
Le menu contextuel apparat et vous permet d'ajouter un nouveau serveur. Cliquez sur l'option Add Server .
LLVI-A-1-a - Type de serveur

La premire tape du wizard consiste dfinir le type de serveur d'applications. Dans notre cas, il s'agit de GlassFish v2 :
Dans le champ Name , veuillez nommer le serveur Petstore . Ce nom est arbitraire et ne sert qu' identifier le serveur parmi la liste dfinie sous NetBeans. Cliquez sur Next pour continuer.
LLVI-A-1-b - Slection du domaine

Dans cette tape, vous allez lier notre domaine petstore au serveur Petstore . Slectionnez l'option Register Local Default Domain et ensuite le domaine petstore :
LLVI-A-1-c - Profil de l'administrateur

Cette tape consiste identifier le profil de l'administrateur :
Veillez introduire le mot de passe que vous avez dfini plus haut lors de la cration du domaine (voir ici). Cliquez sur le bouton Finish pour terminer le processus de cration du serveur applicatif.
LLVI-A-2 - Liste des serveurs

La liste des serveurs fait maintenant apparatre notre serveur Petstore :
LLVI-A-3 - Affichage des traces

Avant de dmarrer le serveur Petstore , vous devez vous assurer que les traces seront visibles. Un click droit sur le serveur Petstore permet d'activer l'affichage des traces. Cliquez sur l'option View Server Log du menu contextuel :
LLVI-A-4 - Dmarrer le serveur Petstore

Vous pouvez maintenant dmarrer le serveur Petstore en slectionnant l'option Start du menu contextuel :
La fentre Output de NetBeans permet de suivre le processus de dmarrage du domaine petstore :
Fentre Output : Affichage Si la fentre Output n'est pas visible, activez l au travers du menu : Window -> Output -> Output Vous constaterez que la fentre Output contient deux sous-fentres : Petstore: affiche les traces du domaine petstore Java DB Database Process: affiche les traces de la base de donnes Derby
Si l'on explore la sous-fentre Java DB Database Process , on constate que le dmarrage du domaine petstore a automatiquement dmarr le serveur de base de donnes Derby :
Fentre Output : Menu contextuel La fentre de trace offre un menu contextuel accessible via un click droit :
En plus de proposer les options d'arrt (Stop) ou de dmarrage du serveur (Start), il est galement possible de rechercher une chane de caractres (Find) ou d'effacer le contenu de la fentre (Clear).
LLVI-A-5 - Explorer les ressources

Une exploration du serveur Petstore permet de dcouvrir les lments dploys dans le domaine tels que les applications, les ressources JMS ou les ressources JDBC :
LLVI-A-6 - Accs la console d'administration

L'option View Admin Console du menu contextuel du serveur permet d'accder la console d'administration :
NetBeans utilise le browser pour ouvrir la console d'administration : http://localhost:8282
LLVI-B - Changer de browser

En modifiant les options de NetBeans, il est possible de changer le browser par dfaut. Slectionnez le menu Tools -> Options :
Dans les options gnrales (General), vous tes libre d'opter pour un browser et mme d'en dfinir en cliquant sur le bouton Edit :
On constate qu'il est notamment possible d'ajouter les dfinitions d'autres browsers.
LLVI-C - Base de donnes

Le noeud Databases de l'onglet Services rpertorie les serveurs de base de donnes et les connexions:
LLVI-C-1 - Arrt et dmarrage du serveur de base de donnes

Vous avons vu que le dmarrage du serveur "Petstore" dmarrait automatiquement le serveur de base de donnes Java DB. Il peut tre utile de dmarrer et stopper manuellement le serveur Java DB. Ces oprations sont accessibles au travers du menu contextuel li au noeud Java DB :
LLVI-C-2 - Vrifier les proprits

Pour vrifier les proprits dfinies sur un serveur de base de donnes, slectionnez l'option Properties du menu contextuel :
Le menu Properties permet d'accder aux proprits dfinies par NetBeans pour le serveur de base de donnes.
Les proprits de Java DB vous apprennent que NetBeans utilise des rpertoires autres que ceux attendus par notre configuration. Pour tre conforme notre dploiement (voir ici), vous devez vrifier et modifier le cas chant les rpertoires suivants : Java DB Installation : %GLASSFISH_HOME%\javadb Database Location : %GLASSFISH_HOME%\javadb
Appuyez sur le bouton "OK" pour valider la modification. Modifications de proprits de Java DB La modification des proprits de Java DB entrane automatique l'arrt du serveur de base de donnes:
Le serveur de base de donnes devra donc tre redmarr :
LLVI-C-3 - Connexion vers la base de donnes

Bien que la data source et le schma de la base soit dj cre, il est possible d'utiliser NetBeans pour consulter et manipuler les donnes du schma de la base petstoreDB . Mais ce stade, le schma de base de donnes n'a pas encore t cr. Cette opration sera ralise plus tard lorsque les directives JPA attaches aux Entity auront gnr les diffrentes tables de l'application Yaps.
LLVI-D - Conclusion
NetBeans est configur et prt accueillir les projets de l'application Yaps. Dans la suite du document, nous allons dcrire le processus d'importation des projets suivants : BarkBank PetEx Yaps-Server Yaps-Client
VII - Importer le projet BarkBank

Le projet BarkBank est une application Web ( Web Applications ) exposant le Web Service ValidationService charg de simuler le processus de validation des cartes de crdit. Nous allons dcrire les diffrentes tapes ncessaires pour importer le projet BarkBank de l'application Yaps vers NetBeans. L'ensemble des oprations qui suivent est ralis sous NetBeans.
LLVII-A - Crer un nouveau projet LLVII-A-1 - Fermeture des projets

Vous allez crer un nouveau de groupe de projets qui sera spcifique BarkBank. Si c'est le cas, il y a d'abord lieu de fermer l'ensemble des projets actuellement ouverts sous NetBeans. Slectionnez l'onglet Projects . Un clic droit fait apparatre le menu contextuel. L'option Project Group (none) permet de fermer l'ensemble des projets ouverts :
LLVII-A-2 - Type de projet

Crez un nouveau projet de type Web Application . Pour cela, slectionnez l'onglet Project et crez un nouveau projet via le menu File New Project . Le projet que vous allez crer est de type Java Web Web Application :
Cliquez sur le bouton Next pour continuer.
LLVII-A-3 - Nom et rpertoires

L'cran suivant vous permet de nommer le projet, et de dfinir le dossier cible:
Les informations introduire sont les suivantes: Project Name: Project Folder: Project Folder Le rpertoire du projet est donn ici titre d'exemple et doit correspondre au rpertoire o vous avez dcompress le fichier d'archives de l'application YapsON (voir ici). Cliquez sur le bouton Next pour continuer. BarkBank C:\Projects\YapsON\BarkBank
LLVII-A-4 - Configuration du serveur

Cette tape vous permet d'identifier le serveur d'applications PetStore (voir ici) sur lequel sera dploye l'application BarkBank :
La configuration utilise pour le dploiement est la suivante : Server: Context Path: Cliquez sur le bouton Next pour continuer. Petstore /barkbank
LLVII-A-5 - Les frameworks

La dernire tape consiste spcifier les frameworks utiliser. Dans le cadre du projet BarkBank , aucun framework spcifique n'est employ :
Appuyez sur le bouton Finish pour terminer le processus de cration du projet.
LLVII-A-6 - Gnration du projet

Le projet est maintenant gnr et prsente l'ensemble des dossiers suivants :
Vous tes prt importer le code source du projet BarkBank de l'application Yaps vers l'arborescence de NetBeans.
LLVII-B - Transfrer le projet sous NetBeans

L'opration de transfert du projet BarkBank consiste copier les fichiers de l'application Yaps vers l'application YapsON. Pour faciliter cette opration, le script Ant yapson.xml (dcrit dans la section 3.5) automatise la copie des fichiers. Pour faciliter cette opration, le script Ant yapson.xml (dcrit dans la section 3.5) automatise la copie des fichiers.
LLVII-B-1 - Positionner les variables d'environnement

Les commandes que vous allez excuter ncessitent de positionner les variables d'environnement pour l'excution des tches Ant. Rendez-vous dans le rpertoire de l'application YapsON et excutez le fichier de commande setenv-yaps.cmd :
LLVII-B-2 - Transfrer le projet

partir de la ligne de commande, excutez la tche transferBarkBank charge de transfrer le projet sous NetBeans :
{yapson_home}> ant -f yapson.xml transferBarkBank Buildfile: yapson.xml transferBarkBank: [echo] Transfer the BarkBank projet to NetBeans ...
L'excution du script Ant commence par demander une confirmation avant de procder au remplacement des fichiers :
... [input] The target source files will be overwritten by the original YAPS project. Do you want to continue? (y, n) y ...
Dans l'affirmative, la tche Ant copie respectivement les codes sources Java, les fichiers de ressources Web et les descripteurs :
... [echo] === Copy Java Sources === [copy] Copying 1 file to c:\Projects\YapsON\BarkBank\src\java [echo] === Copy Web Resources === [copy] Copying 2 files to c:\Projects\YapsON\BarkBank\web [echo] === Copy Web Descriptors === [copy] Copying 1 file to c:\Projects\YapsON\BarkBank\web\WEB-INF BUILD SUCCESSFUL
NetBeans rafrachit automatiquement le projet BarkBank :
LLVII-B-3 - Crer le groupe de projet

NetBeans offre la possibilit de crer des groupes de projets pour faciliter le passage d'un projet l'autre sans avoir redmarrer l'IDE. partir du menu File ou via un clic droit dans la fentre Projects , NetBeans offre la capacit de crer le nouveau groupe de projet:
Slectionnez l'option New group . La fentre suivante permet de nommer le groupe de projet qui est dans notre cas BarkBank :
Les options par dfaut indiquent que les projets en cours de chargement dans l'IDE seront automatiquement ajouts au groupe de projet BarkBank. Cliquez sur le bouton Create Group .
LLVII-C - Compiler le projet

Un clic droit sur le projet fait apparatre le menu contextuel proposant les options pour compiler le projet ( Build ou Clean and Build ) :
Cliquez sur l'option Clean and Build . Le fentre Output affiche les traces de la compilation :
Les messages intressants sont les suivants :

... compile: compile-jsps: Created dir: C:\Projects\YapsON\BarkBank\dist Building jar: C:\Projects\YapsON\BarkBank\dist\BarkBank.war do-dist: dist: BUILD SUCCESSFUL (total time: 2 seconds)
Ces traces indiquent que le projet a t correctement compil ( BUILD SUCCESSFUL ) et archiv dans le fichier BarkBank.war .
LLVII-4 - Dployer le projet

Vous allez maintenant procder au dploiement du projet sous GlassFish. Un clic droit sur le projet fait apparatre le menu contextuel proposant l'option de dploiement ( Deploy ) :
Cliquez sur l'option Deploy . Si ncessaire, NetBeans se charge de dmarrer le serveur d'applications PetStore . Si l'application BarkBank tait dj dploye sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version. La fentre Output trace les messages suivants :
... deployment started : 0% deployment finished : 100% Deploying application in domain completed successfully ... All operations completed successfully run-deploy: BUILD SUCCESSFUL (total time: 4 seconds)
Le dploiement termin, vous pouvez explorer le contenu de l'application BarkBank sur le serveur PetStore. Rendez-vous sur l'onglet "Services" et slectionnez le serveur "Petstore". Le noeud Applications -> Web Applications -> BarkBank affiche les ressources et services exposs par l'application :
L'application BarkBank est accessible l'adresse http://localhost:8080/barkbank et se prsente comme suit:
ce stade, vous pouvez inspecter le WSDL ou tester le service tel que dcrit dans le livre de rfrence.
LLVII-E - Tester le projet

Vous tes maintenant en mesure de tester l'application BarkBank en invoquant le Web Service ValidationService . Un Web Service peut tre test de diffrentes manires. Nous allons ici nous contenter de quelques unes d'entre elles disponibles sous NetBeans. Client de test SOAP Nous vous recommandons d'valuer la solution soapUI (http://www.soapui.org) qui est un outil de test de Web Service. soapUI est propos sous deux licences. La version standard est gratuite et distribue sous licence Open Source. La version Pro est payante. soapUI peut-tre intgr sous forme de plug-in tant sous Eclipse que sous NetBeans.
Mais nous avons toutefois constat des problmes de stabilits avec le plug-in pour NetBeans contrairement la stabilit affiche par la version standalone.
LLVII-E-1 - Mthode 1 : Web Service Tester de GlassFish

Au travers de la fentre Projects , un clic droit sur le Web Service Validation propose le menu contextuel suivant:
L'option Test Web Service invoque le mcanisme de tests de Web Service de GlassFish qui a son tour invoque le Web Service ValidationService au travers de l'URL suivante: http://localhost:8080/barkbank/ValidationService?Tester Ce mcanisme est largement dcrit dans le livre de rfrence.
LLVII-E-2 - Mthode 2 : Web Service Tester de NetBeans

Cette mthode consiste enregistrer le Web Service sous NetBeans afin de bnficier d'un outil de test un peu plus volu que celui offert par GlassFish.
Les Web Services sont rpertoris dans la fentre Services sous le noeud Web Service :
Pour ajouter un Web Service, procdez comme suit. Vous devez avant tout crer un groupe dans lequel seront stocks les Web Service du projet YapsON. Un click droit sur le noeud Web Services propose un menu contextuel dans lequel vous allez crer le groupe YapsON par l'option Create Group :
Ensuite, un clic droit sur le groupe YapsON offre un ensemble d'options parmi lesquelles celle qui permet d'ajouter un Web Service par l'option Add Web Service :
Le formulaire permet d'identifier le Web Service partir de son WSDL:
Veuillez localiser le WSDL du Web Service partir de son URL : http://localhost:8080/barkbank/ValidationService?WSDL Cliquez sur le bouton "OK" pour ajouter la rfrence du Web Service sous NetBeans. Le Web Service ValidationService est maintenant ajout la liste des Web Service :
Un clic droit sur l'opration ValidateCard permet de tester la mthode au travers de l'cran suivant :
La partie suprieure concerne la requte mettre tandis que la partie infrieure se charge d'afficher le message de retour. Le bouton Submit permet d'envoyer la requte au Web Service. Testez le Web Service avec les donnes suivantes: creditCardNumber: creditCardType: expiryDate: 1234567890 MC 11/09
Cliquez sur le bouton Submit pour envoyer la requte au Web Service ValidationService . Les donnes sont considres comme valides par le service et le rsultat est un message OK :
Si l'on omet par exemple la date d'expiration, le Web Service retourne un message d'erreur explicite compos par l'application BarkBank :
LLVII-F - Conclusion
Les sources de l'application BarkBank ont t transfres sous NetBeans dans une arborescence conforme au format prconis par le Java Blueprints. Les tests que nous avons raliss attestent que le Web Service de l'application BarkBank a t correctement compil et est dploy sur le serveur.
VIII - Importer le projet PetEx

Le projet PetEx est une application Web ( Web Applications ) exposant le Web Service DeliveryService charg de simuler le processus de transport des marchandises achetes en ligne. Nous allons dcrire les diffrentes tapes ncessaires pour importer le projet PetEx de l'application Yaps vers NetBeans. Vous noterez que le principe est en tout point similaire au processus d'importation du projet BarkBank. L'ensemble des oprations qui suivent est ralis sous NetBeans.
LLVIII-A - Crer un nouveau projet LLVIII-A-1 - Fermeture des projets

Vous allez crer un nouveau de groupe de projets qui sera spcifique PetEx. Si c'est le cas, il y a d'abord lieu de fermer l'ensemble des projets actuellement ouverts sous NetBeans. Slectionnez l'onglet Projects . Un clic droit fait apparatre le menu contextuel. L'option Project Group (none) permet de fermer l'ensemble des projets ouverts :
LLVIII-A-2 - Type de projet

Crez un nouveau projet de type Web Application . Pour cela, slectionnez l'onglet Project et crez un nouveau projet via le menu File New Project . Le projet que vous allez crer est de type Java Web -> Web Application :
LLVIII-A-3 - Nom et rpertoires

Les informations introduire sont les suivantes: Project Name: Project Folder: Project Folder Le rpertoire du projet est donn ici titre d'exemple et doit correspondre au rpertoire o vous avez dcompress le fichier d'archives de l'application YapsON (voir ici). Cliquez sur le bouton Next pour continuer. PetEx C:\Projects\YapsON\PetEx
LLVIII-A-4 - Configuration du serveur

Cette tape vous permet d'identifier le serveur d'applications PetStore (voir ici) sur lequel sera dploye l'application PetEx :
La configuration utilise pour le dploiement est la suivante : Server: Context Path: Cliquez sur le bouton Next pour continuer. Petstore /petex
LLVIII-A-5 - Les frameworks

La dernire tape consiste spcifier les frameworks utiliser. Dans le cadre du projet PetEx , aucun framework spcifique n'est employ :
Appuyez sur le bouton Finish pour terminer le processus de cration du projet.
LLVIII-A-6 - Gnration du projet

Vous tes prt importer le code source du projet PetEx de l'application Yaps vers l'arborescence de NetBeans.
LLVIII-B - Transfrer le projet sous NetBeans

L'opration de transfert du projet PetEx consiste copier les fichiers de l'application Yaps vers l'application YapsON. Pour faciliter cette opration, le script Ant yapson.xml (dcrit dans la section 3.5) automatise la copie des fichiers. Assurez-vous d'avoir configur le fichier yapson.properties tel que dcrit dans la section 4.
LLVIII-B-1 - Positionner les variables d'environnement

LLVIII-B-2 - Transfrer le projet

partir de la ligne de commande, excutez la tche Ant transferPetEx charge de transfrer le projet sous NetBeans :
%YAPSON-HOME%> ant -f yapson.xml transferPetEx Buildfile: yapson.xml transferPetEx: [echo] Transfer the PetEx projet to NetBeans ...
L'excution du script Ant commence par demander une confirmation l'utilisateur avant de procder au remplacement des fichiers :
Dans l'affirmative, la tche Ant copie respectivement les codes sources Java, les fichiers de ressources Web et les descripteurs :
... [echo] === Copy Java Sources === [copy] Copying 1 file to c:\Projects\YapsON\PetEx\src\java [echo] === Copy Web Resources === [copy] Copying 2 files to c:\Projects\YapsON\PetEx\web [echo] === Copy Web Descriptors === [copy] Copying 1 file to c:\Projects\YapsON\PetEx\web\WEB-INF BUILD SUCCESSFUL
NetBeans rafrachit automatiquement le projet PetEx :
LLVIII-B-3 - Crer le groupe de projet

partir du menu File ou via un clic droit dans la fentre Projects , NetBeans offre la capacit de crer le nouveau groupe de projet:
Slectionnez l'option New group . La fentre suivante permet de nommer le groupe de projet qui est dans notre cas PetEx :
Les options par dfaut indiquent que les projets en cours de chargement dans l'IDE seront automatiquement ajouts au groupe de projet PetEx. Cliquez sur le bouton Create Group .
LLVIII-C - Compiler le projet

Cliquez sur l'option Clean and Build . La fentre Output affiche les traces de la compilation :

... compile: compile-jsps: Created dir: C:\Projects\YapsON\PetEx\dist Building jar: C:\Projects\YapsON\PetEx\dist\PetEx.war do-dist: dist: BUILD SUCCESSFUL (total time: 2 seconds) - 90 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
Ces traces indiquent que le projet a t correctement compil ( BUILD SUCCESSFUL ) et archiv dans le fichier PetEx.war .
LLVIII-D - Dployer le projet

Cliquez sur l'option Deploy . Si ncessaire, NetBeans se charge de dmarrer le serveur d'applications PetStore . Si l'application PetEx tait dj dploye sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version. La fentre Output trace les messages suivants :
... deployment started : 0% deployment finished : 100% Deploying application in domain completed successfully ... All operations completed successfully run-deploy:
YAPS Pet Store sous NetBeans par Sad Eloudrhiri BUILD SUCCESSFUL (total time: 4 seconds)
Le dploiement termin, vous pouvez explorer le contenu de l'application PetEx sur le serveur PetStore. Rendez-vous sur l'onglet "Services" et slectionnez le serveur "Petstore". Le noeud Applications -> Web Applications -> PetEx affiche les ressources et services exposs par l'application :
L'application PetEx est accessible l'adresse http://localhost:8080/petex et se prsente comme suit:
ce stade, vous pouvez inspecter le WSDL ou tester le service tel que dcrit dans le livre de rfrence.
LLVIII-E - Tester le projet

Nous sommes maintenant en mesure de tester l'application PetEx en invoquant le Web Service DeliveryService . Un Web Service peut tre test de diffrentes manires. Nous allons ici nous contenter de quelques unes d'entre elles disponibles sous NetBeans.
LLVIII-E-1 - Mthode 1: Web Service Tester de GlassFish

Au travers de la fentre Projects , un clic droit sur le Web Service Delivery propose le menu contextuel suivant:
L'option Test Web Service invoque le mcanisme de tests de Web Service de GlassFish qui a son tour invoque le Web Service DeliveryService au travers de l'URL suivante: http://localhost:8080/petex/DeliveryService?Tester Cette mcanique de test n'est pas vraiment approprie pour tester le Web Service DeliveryService . La raison est que la requte transmettre contient un message complexe.
LLVIII-E-2 - Mthode 2: Web Service Tester de NetBeans

Cette mthode consiste enregistrer le Web Service sous NetBeans afin de bnficier d'un outil de test un peu plus volu que celui offert par GlassFish. Les Web Services sont rpertoris dans la fentre Services sous le noeud Web Service :
Le groupe de Web Service YapsON a dj t cr prcdemment. Nous allons nous concentrer sur l'ajout de la rfrence du Web Service de PetEx. Un clic droit sur le groupe YapsON offre un ensemble d'options parmi lesquelles celles permettant d'ajouter un Web Service:
Le formulaire permet d'identifier le Web Service partir de son WSDL:
Veuillez localiser le WSDL du Web Service partir de son URL : http://localhost:8080/petex/DeliveryService?WSDL Cliquer sur le bouton "OK" pour ajouter la rfrence au Web Service sous NetBeans. Le Web Service DeliveryService est maintenant ajout la liste des Web Service :
Un clic droit sur l'opration deliveryItems permet de tester la mthode au travers de l'cran suivant :
La partie suprieure concerne la requte mettre tandis que la partie infrieure se charge d'afficher le message de retour. Le bouton Submit permet d'envoyer la requte au Web Service. Testez le Web Service avec les donnes suivantes:
Delivery From
City Contact Country State Street Zipcode City Contact Country State Street Zipcode Number
Lige Said Eloudrhiri BE None My street 1234 Paris Antonio Goncalves FR None Your street 5678 12345678
Delivery To
Reference
Cliquez sur le bouton Submit pour envoyer la requte au Web Service DeliveryService . La rponse retourne par le Web Service est vide :
En effet, le code de retour du Web Service DeliveryService est de type void . Par contre, le Web Service trace la requte en utilisant le logger applicatif dfini pour com.petex.transport . Si l'on se reporte sur la fentre Output et en particulier sur les traces gnres par le serveur Petstore , on retrouvera les traces suivantes :
.. ENTRY Delivery Order Received Deliver from DeliveryPlace{contact='Said Eloudrhiri', street='My street', city='Lige', state='None', zipcode='1234', country='BE'} Deliver to DeliveryPlace{contact='Antonio Goncalves', street='Your street', city='Paris', state='None', zipcode='5678', country='FR'} Reference n 12345678 RETURN
Ces traces montrent que le Web Service a bien reu le message de requte.
LLVIII-F - Conclusion
Les sources de l'application PetEx ont t transfres sous NetBeans dans une arborescence conforme au format prconis par le Java Blueprints. Les tests que nous avons raliss attestent que le Web Service de l'application PetEx a t correctement compil et est dploy sur le serveur.
IX - Importer le projet Yaps - ct serveur

Le projet Yaps-Server est une application de type Enterprise Applications qui a pour fonction d'hberger la logique serveur de l'application Yaps. Le projet Yaps-Server est compos des modules suivants : Module EJB : Entity, Stateless, Statefull, Message Driver Bean Module Web : JSF
L'ensemble des oprations qui suivent est ralis sous NetBeans.
LLIX-A - Crer un nouveau projet LLIX-A-1 - Fermeture des projets

Vous allez crer un nouveau de groupe de projets qui sera spcifique Yaps-Server. Si c'est le cas, il y a d'abord lieu de fermer l'ensemble des projets actuellement ouverts sous NetBeans. Slectionnez l'onglet Projects . Un clic droit fait apparatre le menu contextuel. L'option Project Group (none) permet de fermer l'ensemble des projets ouverts :
LLIX-A-2 - Type de projet

Crez un nouveau projet de type Enterprise Application . Pour cela, slectionnez l'onglet Project et crez un nouveau projet via le menu File -> New Project . Le projet que vous allez crer est de type Java EE > Enterprise Application :
LLIX-A-3 - Nom et rpertoires

Les informations introduire sont les suivantes: Project Name: Project Folder: Project Folder Le rpertoire du projet est donn ici titre d'exemple et doit correspondre au rpertoire o vous avez dcompress le fichier d'archives de l'application YapsON (voir ici). Cliquez sur le bouton Next pour continuer. Yaps-Server C:\Projects\YapsON\Yaps-Server
LLIX-A-4 - Configuration du serveur

Cette tape vous permet d'identifier le serveur d'applications PetStore (voir ici) sur lequel sera dploye l'application PetEx ainsi que les modules (EJB et Web) associs au projet:
La configuration utilise pour le dploiement est la suivante : Server: EJB Module: Web Application Module: Petstore Yaps-Server-ejb Yaps-Server-war
Cliquez sur le bouton Finish pour terminer le processus de cration du projet.
LLIX-A-5 - Gnration du projet

Vous tes prt importer le code source du projet Yaps (ct serveur) de l'application Yaps vers l'arborescence de NetBeans.
LLIX-B - Transfrer le projet sous NetBeans

L'opration de transfert du projet Yaps consiste copier les fichiers de la partie serveur de l'application Yaps vers l'application YapsON. Pour faciliter cette opration, le script Ant yapson.xml (dcrit dans la section 3.5) automatise la copie des fichiers. Assurez-vous d'avoir configur le fichier yapson.properties tel que dcrit dans la section 4.
LLIX-B-1 - Positionner les variables d'environnement

Les commandes que vous allez excuter ncessitent de positionner les variables d'environnement pour l'excution des tches Ant.
Rendez-vous dans le rpertoire de l'application YapsON et excutez le fichier de commande setenv-yaps.cmd :

LLIX-B-2 - Transfrer le projet

partir de la ligne de commande, excutez la tche Ant transferYapsServer charge de transfrer le projet sous NetBeans :
%YAPSON-HOME%> ant -f yapson.xml transferYapsServer Buildfile: yapson.xml transferYapsServer: [echo] Transfer to NetBeans the server part of the Yaps project ...
L'excution du script Ant commence par demander une confirmation l'utilisateur avant de procder au remplacement des fichiers :
La tche Ant copie ensuite les lments requis pour le module Yaps-Server-ejb :
... [echo] >>>>>> Module Yaps-Server-ejb >>>>>> [echo] === Copy Java Sources === [echo] entity ... [copy] Copying 8 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\entity [echo] exception ... [copy] Copying 2 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\exception [echo] mdb ... [copy] Copying 2 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\mdb [echo] stateless ... [copy] Copying 9 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\stateless [echo] statefull ... [copy] Copying 3 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\stateful [echo] util ... [copy] Copying 2 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverejb\ src\java\com\yaps\petstore\util [echo] === Copy Persistence Unit === [copy] Copying 1 file to c:\Projects\YapsON\Yaps-Server\Yaps-Server-ejb\src\conf ...
Ensuite, les ressources ncessaires pour le module "Yaps-Server-war" sont transfres :

... [echo] >>>>>> Module Yaps-Server-war >>>>>> [echo] === Copy Web Sources === [copy] Copying 4 files to c:\Projects\YapsON\Yaps-Server\Yaps-Serverwar\ src\java\com\yaps\petstore\jsf [echo] === Copy Web Resources === [copy] Copying 39 files to c:\Projects\YapsON\Yaps-Server\Yaps-Server-war\web [echo] === Copy Web Descriptors === [copy] Copying 2 files to c:\Projects\YapsON\Yaps-Server\Yaps-Server-war\web\WEB-INF ...
Pour terminer, les ressources utilitaires sont transfres (dans notre cas le fichier SQL contenant les donnes de test) :
... [echo] >>>>>> Tools >>>>>> [echo] === Copy Test data file === [copy] Copying 1 file to c:\Projects\Yaps-Server BUILD SUCCESSFUL
NetBeans rafrachit automatiquement le projet Yaps-Server :
Ouverture des modules Il se peut que les modules du projet Yaps-Server soient ferms :
Un clic droit sur le module vous permet d'ouvrir le sous-projet dans l'IDE :
LLIX-B-3 - Rfrencer les Web Services

Des erreurs apparaissent dans les modules Yaps-Server-ejb et Yaps-Server-war . La cause de ces erreurs est que les rfrences des Web Service des projets BarkBank et PetEx sont manquantes.
LLIX-B-3-a - Rfrencer DeliveryService

Dans le module Yaps-Server-ejb , la classe OrderBean injecte la rfrence du Web Service DeliveryService issue du projet PetEx . Pour corriger l'erreur, vous allez devoir ajouter le Proxy client du Web Service. Un clic droit sur le module Yaps-Server-ejb fait apparatre le menu contextuel dans vous devez slectionner l'option New -> Web Service Client :
L'cran suivant vous demande de localiser le WSDL du Web Service :
Dans notre cas, vous devez fournir l'URL du WSDL relatif l'application PetEx: http://localhost:8080/petex/DeliveryService?WSDL Dmarrage du serveur PetStore Assurez-vous que le serveur Petstore est dmarr, car dans le cas contraire la tche de cration du client Web Service ne pourra localiser l'URL du WSDL. Cliquer sur Finish pour gnrer le code du Proxy client du Web Service. Localisation du WSDL Nous aurions pu localiser le WSDL soit par projet ou par fichier. Par Projet, cela aurait impliqu que le projet PetEx soit galement ouvert dans l'IDE. Par Fichier, cela ncessite de localiser le fichier WSDL gnr dans le projet PetEx. Nous avons prfr illustrer le mode URL pour simuler la situation o le Web Service serait dploy sur un serveur distant ?
la fin du processus de gnration, le dossier Web Service References est ajout au module Yaps-Serverejb et contient le Proxy client du Web Service :
Code source du Proxy client Le code source Java du Proxy client est gnr sous le rpertoire suivant :
{yapson_home}/Yaps-Server/Yaps-Server-ejb/build/generated/wsimport/client
NetBeans va ensuite automatiquement rafrachir le projet et faire disparatre les erreurs de rfrences repres dans la classe OrderBean .
LLIX-B-3-b - Rfrencer ValidationService

Dans le module Yaps-Server-war , la classe ShoppingCartController injecte la rfrence du Web Service ValidationService issue du projet BarkBank . Pour corriger l'erreur, vous allez devoir ajouter le Proxy client du Web Service. Un clic droit sur le module Yaps-Server-war fait apparatre le menu contextuel dans vous devez slectionner l'option New -> Web Service Client :
L'cran suivant vous demande de localiser le WSDL du Web Service :
Dans notre cas, vous devez fournir l'URL du WSDL relatif l'application BarkBank: http://localhost:8080/barkbank/ValidationService?WSDL Cliquer sur Finish pour gnrer le code du Proxy client du Web Service. la fin du processus de gnration, le dossier Web Service References est ajout au module Yaps-Serverwar et contient le Proxy client du Web Service :
Code source du Proxy client Le code source Java du Proxy client est gnr sous le rpertoire suivant :
{yapson_home}/Yaps-Server/Yaps-Server-war/build/generated/wsimport/client
NetBeans va ensuite automatiquement rafrachir le projet et faire disparatre les erreurs de rfrences repres dans la classe ShoppingCartController .
LLIX-B-4 - Crer le groupe de projet

partir du menu File ou via un clic droit dans la fentre Projects , NetBeans offre la capacit de crer le nouveau groupe de projet:
Slectionnez l'option New group . La fentre suivante permet de nommer le groupe de projet qui est dans notre cas Yaps-Server :
Les options par dfaut indiquent que les projets en cours de chargement dans l'IDE seront automatiquement ajouts au groupe de projet. Cliquez sur le bouton Create Group .
LLIX-C - Changer le Context Root

Pour tre conforme au livre de rfrence, vous allez changer le Context Root de l'application Web qui a t dfini par dfaut dans le module Yaps-Server-war . Le Context Root est dfini dans le fichier de dploiement sun-web.xml qui se trouve sous : Yaps-Server-war -> Configuration Files -> sun-web.xml
Le fichier sun-web.xml est le descripteur de dploiement Web pour SUN GlassFish. ditez ce fichier et modifiez l'entre Context Root pour y placer la valeur /petstore :
LLIX-D - Crer le fichier de dploiement standard

Avant de dployer l'application, il vous reste gnrer le fichier de dploiement standard application.xml . Pour cela, un clic droit sur le projet Yaps-Server propose le menu contextuel suivant dans lequel vous allez pouvoir ajouter le descripteur de dploiement standard (Standard Deployment Descriptor) :
L'cran suivant apparat prcisant o rsidera le fichier de dploiement :
Cliquez sur Finish pour gnrer le fichier de dploiement. Le fichier application.xml est gnr et associ au projet :
Si l'on consulte le fichier application.xml , on constate que la section web du fichier met en relation l'URI du projet Web ( Yaps-Server-war.war ) avec le Context Root /petstore que vous avez dfini prcdemment.
... <web> <web-uri>Yaps-Server-war.war</web-uri> <context-root>/petstore</context-root> </web> ...
LLIX-E - Compiler le projet


... Building jar: C:\Projects\YapsON\Yaps-Server\Yaps-Server-ejb\dist\Yaps-Server-ejb.jar ... Building jar: C:\Projects\YapsON\Yaps-Server\Yaps-Server-war\dist\Yaps-Server-war.war ... Building jar: C:\Projects\YapsON\Yaps-Server\dist\Yaps-Server.ear ... BUILD SUCCESSFUL (total time: 7 seconds)
Ces traces indiquent que les modules ont t correctement compils de mme que l'archive de type EAR.
LLIX-F - Dployer le projet

Cliquez sur l'option Deploy . Si ncessaire, NetBeans se charge de dmarrer le serveur d'applications PetStore . Si l'application Yaps-Server tait dj dploye sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version. La fentre Output trace les messages suivants :
... deployment started : 0% deployment finished : 100% Deploying application in domain completed successfully ... All operations completed successfully post-run-deploy: run-deploy: BUILD SUCCESSFUL (total time: 10 seconds)
Le dploiement termin, vous pouvez explorer le contenu de l'application Yaps-Server sur le serveur PetStore. Rendez-vous sur l'onglet "Services" et slectionnez le serveur "Petstore". Le noeud Applications -> Enterprise Applications -> Yaps-Server affiche les ressources et services exposs par l'application :
LLIX-G - Base de donnes

Le dploiement de l'application Yaps-Server a eu pour effet de supprimer et de crer les tables de la base de donnes petstoreDB . Ces oprations sont ralises par le biais d'annotations JPA apposes dans les diffrentes Entity. Dans cette section, nous allons montrer comment - au travers de NetBeans - accder la structure et aux donnes de la base de donnes petstoreDB .
LLIX-G-1 - Crer une connexion

La premire tape consiste crer une connexion vers la base de donnes. Slectionnez l'onglet Services et ensuite un clic droit sur Databases . Le menu contextuel suivant apparat offrant la possibilit de crer une nouvelle connexion :
Cliquez sur New Connection . L'cran suivant apparat dans lequel vous allez identifier les proprits de la base de donnes petstoreDB :
Dans le formulaire, introduisez les informations suivantes : Name: Host: Port: Database: User Name: Password: Proprits de la source de donnes Les informations de connexion proviennent des proprits dfinies durant la cration du Connection Pool (voir ici). Cliquez sur le bouton OK pour crer la connexion. Avant de fermer la fentre, NetBeans peut vous demander de prciser le schma de la base de donnes : Java DB (Network) localhost 1527 petstoreDB dbuser dbpwd
Veuillez prciser DBUSER et cliquez ensuite sur OK . Le noeud Databases prsente la nouvelle connexion
Chaque connexion est prfixe par une icne qui prcise un statut : Une connexion DB est en cours
Pas de connexion DB
LLIX-G-2 - Connexion la DB
Un clic droit sur la connexion fait apparatre le menu contextuel par lequel vous pouvez vous connecter la base de donnes :
Cliquez sur Connect pour vous connecter la base de donnes. Le systme vous demande d'introduire le mot de passe :
En cochant l'option Remember password , le mot de passe ne vous sera plus demand. Vous tes maintenant connect la base de donnes :
LLIX-G-3 - Explorer la DB
Les noeuds de la connexion peuvent tre ouverts pour explorer la structure de la base de donnes petstoreDB :
Un clic droit sur une table fait apparatre le menu contextuel qui permet de visualiser le contenu de la table ou d'altrer sa structure :
Si vous cliquez sur l'option View Data , une fentre apparat et vous donnez la possibilit d'excuter des requtes de type SQL et obtenir le rsultat de la requte :
Vous constaterez que les tables de la base de donnes sont vides. Nous allons maintenant prsenter les mthodes pour charger les donnes de test de livres avec le projet Yaps original.
LLIX-G-4 - Donnes de test

Dans le fichier build.xml du projet original Yaps, la tche db-insert-data insre des donnes de test dans la base de donnes. Ce processus d'insertion des donnes de test est excut chaque dploiement de l'application. Durant la phase de transfert (voir ici), les donnes de test ont t transfres l'emplacement suivant :
{yapson_home}\Yaps-Server\data.sql
Nous allons montrer deux mthodes que l'on peut utiliser sous NetBeans pour charger ces donnes de test.
LLIX-G-4-a - Mthode 1 : Chargement manuel des donnes de test

Cette mthode dcrit comment charger manuellement les donnes de test dans la base de donnes en utilisant les oprations offertes dans le service Database . Un clic droit sur le noeud Table de la base de donnes petstoreDB prsente le menu contextuel suivant :
Slectionnez l'option Execute Command . Copiez le contenu du fichier data.sql pour le coller dans la fentre de commande :
Excutez les requtes SQL en cliquant sur l'icne de la toolbar. La fentre Output trace le rsultat de chaque requte SQL. Vous pouvez maintenant visualiser le contenu de chaque table en invoquant l'option View Data dcrite plus haut. Par exemple, nous obtenons le rsultat suivant pour la table CUSTOMER :
Excuter une slection de commandes SQL Il vous est galement loisible d'excuter un ensemble de commande. Dans la fentre de commande SQL, slectionnez les commandes excuter. Un clic droit fait apparatre le menu contextuel avec l'option Run Selection :
On se rend vite compte que le chargement manuel est quelque peu contraignant, car il vous oblige rpter les oprations de chargement aprs chaque dploiement de l'application. Nous allons montrer une autre mthode qui automatise le processus de chargement des donnes de test.
LLIX-G-4-b - Mthode 2 : Chargement automatique des donnes de test

Cette seconde mthode est beaucoup plus lgante, car elle automatise le chargement des donnes de test conformment au projet original Yaps. En inspectant les fichiers de projet Netbeans, vous aurez compris que NetBeans utilise Ant pour compiler et dployer les applications. NetBeans offre la possibilit de personnaliser le processus de construction et de dploiement des applications en offrant au dveloppeur la libert de modifier le fichier build.xml du projet afin d'exploiter les targets Ant suivantes : pre-init post-init pre-compile post-compile pre-dist post-dist post-clean pre-run-deploy post-run-deploy Called before initialization of project properties Called after initialization of project properties Called before javac compilation Called after javac compilation Called before archive building Called after archive building Called after cleaning build products Called before deploying Called after deploying
Nous allons enrichir le processus de construction de l'application Yaps-Server afin d'y insrer une tche pour ajouter les donnes de test dans la base de donnes petstoreDB.
Nous allons montrer comment enrichir le fichier build.xml afin d'insrer les donnes de test aprs chaque dploiement de l'application (post-run-deploy). Slectionnez l'onglet Files et ouvrez le noeud du projet Yaps-Server :
Vous constatez la prsence du fichier data.sql qui a t transfr du projet original. Vous allez crer le script Ant yaps-data.xml qui sera utilis pour charger les donnes de test. Fichier yaps-data.xml L'archive de l'application YapsON est livre avec le fichier yaps-data.xml . Il n'est donc pas ncessaire de crer ce fichier. Vous tes libres de le dplacer du rpertoire principal vers le rpertoire du projet Yaps-Server :
C:\> cd {yapson_home} {yapson_home}> copy yaps-data.xml Yaps-Server
Slectionnez le dossier yaps-Server. Un clic droit affiche le menu contextuel suivant dans lequel vous allez slectionner l'option New -> Other :
Pour crer un fichier de type Ant, vous allez choisir l'option Other -> Ant Build Script :
Cliquez sur Next pour poursuivre. Ensuite, entrez le nom du fichier qui sera dans notre cas yaps-data.xml :
Cliquez sur Finish pour terminer le processus. Le fichier yaps-data.xml s'ouvre maintenant dans l'diteur de NetBeans pour vous permettre de le complter :
Nous fournissons ci-dessous le contenu appliquer au fichier yaps-data.xml :

<?xml version="1.0"?>  <project name="Yaps-Data" default="load-data" basedir=".">  <property name="db-url" value="jdbc:derby://localhost:1527/petstoreDB" /> <property name="db-driver" value="org.apache.derby.jdbc.ClientDriver" /> <property name="db-userid" value="dbuser" /> <property name="db-password" value="dbpwd" />  <property name="derby.home" value="C:/Program Files/glassfish-v2ur2/javaDB"/> <property name="derby.lib" value="${derby.home}/lib"/>  <path id="classpath">  <pathelement location="${derby.lib}/derbyclient.jar"/> </path>  <target name="load-data"> <sql driver="${db-driver}" url="${db-url}" userid="${db-userid}" password="${db-password}" autocommit="yes" onerror="continue" caching="yes" src="data.sql"> <classpath refid="classpath"/> </sql> </target> </project>
Nous allons dcrire le fichier Ant. Le script Ant Yaps-Data commence par dfinir un ensemble de proprits pour identifier : Database properties : les proprits de la base de donnes petstoreDB . Derby Library location: le chemin vers les librairies de Derby. Classpath : la librairie Derby ncessaire pour importer les donnes.
Ensuite, la cible load-data fournit la tche SQL utilise pour charger les donnes dans la base de donnes petstoreDB partir du fichier data.sql . Sauvez les modifications et vrifiez la structure XML du fichier. Pour cela, un clic droit dans le fichier fait apparatre le menu contextuel offrant l'option Check XML :
Maintenant, vous allez modifier le fichier build.xml du projet Yaps-Server pour invoquer le script Ant yapsdata.xml aprs la phase de dploiement du projet. Toujours partir de l'onglet Files , ouvrez le fichier build.xml du projet Yaps- Server :
L'objectif tant d'insrer les donnes de test aprs le dploiement du projet, vous allez ajouter la target Ant postrun-deploy dans le fichier build.xml :
...  <target name="post-run-deploy"> <echo>Load Data on the Yaps Pet Store Database ... </echo> <ant antfile="yaps-data.xml" target="load-data"/> </target> </project>
La target post-run-deploy se charge d'invoquer la cible load-data du fichier yaps-data.xml . Pour vrifier le bon droulement du processus, l'instruction echo permet d'afficher une trace sur la console. Vrifiez la structure du fichier en invoquant l'option Check XML comme dcrite prcdemment. Sauvez vos modifications. Si vous dployez le projet comme dcrit plus haut (voir ici), vous verrez apparatre la trace suivante sur la console :
... post-run-deploy: Load Data on the Yaps Pet Store Database ... load-data: Executing resource: C:\Projects\YapsON\Yaps-Server\data.sql 91 of 91 SQL statements executed successfully ...
Ces informations indiquent que 91 requtes SQL du fichier data.sql ont t excutes durant la phase postrun-deploy . Avec cette mthode, les donnes de tests seront automatiquement injectes dans la base de donnes chaque dploiement du projet Yaps-Server .
LLIX-H - Tester le projet

Le test du projet est largement dcrit dans le livre de rfrence. On rappellera que l'application Web est accessible l'adresse suivante : http://localhost:8080/petstore
N'oubliez pas de crer un compte utilisateur afin de pouvoir valider le comportement de l'application : Ajout d'articles dans le panier. Cration et envoi d'un bon de commande. Rception d'un email de confirmation.
Messages de trace produits sur le serveur et mentionnant la rception des messages du topic JMS.
L'analyse des traces du serveur Petstore vous permet galement de suivre le cheminement des messages et de constater que les Web Services (DeliveryService et ValidationService) sont bien invoqus. Configuration du serveur SMTP La classe EmailSenderBean charge d'envoyer les emails utilise des constantes pour identifier le serveur SMTP:
private static final String SMTP_HOST = "smtp.free.fr"; private static final String USER = "yaps.petstore"; private static final String PASSWORD = "yapspwd";
Il est ncessaire d'adapter les valeurs de ces constantes en fonction de votre environnement. Aprs la modification, n'oubliez de recompiler et de dployer l'application. Bug JMS En consultant les traces du serveur Petstore, on peut rencontrer le message d'erreur suivant:
DirectConsumer:Caught Exception delivering messagecom.sun.messaging.jmq.io.Packet cannot be cast to com.sun.messaging.jms.ra.DirectPacket
Ce problme est identifi comme un bug connu par SUN: http://bugs.sun.com/view_bug.do?bug_id=6650996 Le problme est li la manire dont le JMS Provider et l'Application Server sont lis. Par dfaut, la relation est de type EMBEDDED . Cela signifie que le serveur d'applications (GlassFish) et le JMS Provider (Sun Java System Message Queue software) fonctionnent sous la mme JVM. Pour contourner le problme, il est recommand de changer le type de relation en LOCAL . Ce mode stipule que le JMS Provider est dmarr dans sa propre JVM au moment o le serveur d'applications est lui-mme dmarr. Pour modifier la configuration du service JMS, procdez comme suit : Dmarrer la console d'administration du serveur Petstore sur le site suivant : http://localhost:8282/ Dans la partie de gauche, slectionnez la tche Configuration > Java Message Service :
Changer le type de relation de EMBEDDED LOCAL :
Sauver vos modifications. Cette modification ncessite un redmarrage du serveur. Redmarrez le serveur Petstore.
Les diffrents types de relation sont exposs dans la documentation de GlassFish (Sun Java System Application Server 9.1) disponible l'adresse suivante : http://docs.sun.com/app/docs/doc/819-3672/beaob?a=view
LLIX-I - Conclusion
Les sources du serveur de l'application Yaps ont t transfres sous NetBeans dans une arborescence conforme au format prconis par le Java Blueprints. Les tests que nous avons raliss attestent que l'application Web, la logique mtier et les Web Services communiquent correctement ensemble.
X - Importer le projet Yaps - ct client

Le projet YAPS Pet Store est compos de deux interfaces clientes. L'une dite lgre et compose d'une interface Web (JSF) et l'autre dite lourde (Java Swing). Comme nous l'avons vu (voir ici), le client lger de type Web est dploy avec les composants du serveur de l'application Yaps. Nous allons dcrire le processus d'importation du client lourd (Java Swing) sous le projet de type Java Applications baptis Yaps-Client. L'ensemble des oprations qui suivent est ralis sous NetBeans.
LLX-A - Crer un nouveau projet LLX-A-1-a - Fermer les projets

Vous allez crer un nouveau de groupe de projets qui sera spcifique Yaps-Client. Si c'est le cas, il y a d'abord lieu de fermer l'ensemble des projets actuellement ouverts sous NetBeans. Slectionnez l'onglet Projects . Un clic droit fait apparatre le menu contextuel. L'option Project Group (none) permet de fermer l'ensemble des projets ouverts :
LLX-A-1-b - Type de projet

Crez un nouveau projet de type Java Application .
Pour cela, slectionnez l'onglet Project et crez un nouveau projet via le menu File -> New Project . Le projet que vous allez crer est de type Java > Java Application :
Cliquez sur le bouton Next pour continuer. Java Desktop Application ? Nous aurions tendance opter pour un projet de type Java Desktop Application prconis pour le dveloppement d'applications de type Swing. L'application client de Yaps Pet Store est certes de type Swing mais son fonctionnement a t enrichi par l'apport d'un framework baptis XSwing. Nous avons ainsi prfr rester dans le contexte d'une application Java standard pour rester dans l'esprit de l'application originale.
LLX-A-1-c - Nom et rpertoires

L'cran suivant nous permet de nommer le projet, et de dfinir le dossier cible :
Les informations introduire sont les suivantes : Project Name: Project Folder: Yaps-Client C:\Projects\YapsON\Yaps-Client
Il n'est pas ncessaire de cocher l'option Create Main Class , car nous allons importer nos propres codes sources. Project Folder Le rpertoire du projet est donn ici titre d'exemple et doit correspondre au rpertoire o vous avez dcompress le fichier d'archives de l'application YapsON (voir ici). Cliquez sur le bouton Finish pour terminer le processus.
LLX-A-1-d - Gnration du projet

Vous tes prt importer le code source du projet Yaps (ct client) de l'application Yaps vers l'arborescence de NetBeans.
LLX-B - Transfrer le projet sous NetBeans

L'opration de transfert du projet Yaps consiste copier les fichiers de la partie serveur de l'application Yaps vers l'application YapsON. Pour faciliter cette opration, le script Ant yapson.xml (dcrit dans la section 3.5) automatise la copie des fichiers. Assurez-vous d'avoir configur le fichier yapson.properties tel que dcrit dans la section 4.
LLX-B-1 - Positionner les variables d'environnement

LLX-B-2 - Transfrer le projet

partir de la ligne de commande, excutez la tche Ant transferYapsClient charge de transfrer le projet sous NetBeans :
%YAPSON-HOME%> ant -f yapson.xml transferYapsClient - 154 Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme partielle, ne peut tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.
YAPS Pet Store sous NetBeans par Sad Eloudrhiri Buildfile: yapson.xml transferYapsClient: [echo] Transfer to NetBeans the client's side of the Yaps project ...
L'excution du script ANT commence par demander une confirmation l'utilisateur avant de procder au remplacement des fichiers :
La tche Ant copie code source Java du projet :

... [echo] === Copy Java Sources === [copy] Copying 82 files to c:\Projects\YapsON\Yaps-Client\src\com\yaps\petstore\client ...
Pour terminer, les librairies sont copies dans un rpertoire spcifique :

... [echo] === Copy Libraries === [copy] Copying 2 files to c:\Projects\YapsON\Tools\Lib BUILD SUCCESSFUL
NetBeans rafrachit automatiquement le projet Yaps-Client :
LLX-B-3 - Rfrencer les librairies

Comme on peut le constater, des erreurs apparaissent dans le code source du projet.
Ces erreurs sont causes par l'absence de librairies requises par le projet : Les classes des EJBs du projet Yaps-Server Les librairies utilitaires (Apache Commons, Framework XSwing) Les librairies JMS Les librairies de TopLink
Les rfrences ces libraires se ralisent en modifiant les proprits du projet. Nous allons dcrire comment rfrencer chacune de ces libraires ainsi que la manire de crer certaines d'entre elles sous NetBeans.
LLX-B-3-a - Rfrencer les classes de Yaps-Server

L'application Yaps-Client rfrence un ensemble de classes dfinies dans le projet Yaps-Server : entity, stateless, util, exception. Vous allez ajouter la rfrence la librairie contenant les classes construites dans le cadre de l'application YapsServer et plus spcifiquement les classes du module Yaps-Server-ejb. Un clic droit sur le projet Yaps-Client fait apparatre le menu contextuel dans lequel vous allez activer l'option Properties :
Dans l'cran des proprits du projet, slectionnez la catgorie Libraries :
Dans la partie de droite, cliquez sur le bouton Add JAR/Folder . La bote de dialogue permet de slectionner la librairie rfrencer dans le projet. Dans notre cas, vous devez retrouver la librairie Yaps-Servr-ejb.jar qui se trouve sous le rpertoire Build du projet Yaps-Server : {yapson_home}\build\Yaps-Server-ejb.jar
ce stade, les librairies rfrences dans le projet sont les suivantes :
Cliquez sur OK afin d'ajouter la rfrence de la libraire au projet. En consultant le projet, on constate la disparition des erreurs relatives au rfrencement des classes du projet YapsServer.
LLX-B-3-b - Rfrencer les librairies utilitaires

En utilisant la mthode dcrite prcdemment, vous allez rfrencer les deux librairies utilitaires transfres du projet Yaps. Ces deux librairies sont localises sous le rpertoire suivant :
{yapson_home}\Tools\Libs\commons-lang-2.3.jar {yapson_home}\Tools\Libs\vstm-xcore-0.5.0.jar
ce stade, les librairies rfrences dans le projet sont les suivantes:
Cliquez sur OK afin d'ajouter la rfrence des libraires au projet. En consultant le projet, on constate la disparition des erreurs relatives au rfrencement des classes d'Apache Commons et du framework XSwing.
LLX-B-3-c - Rfrencer les librairies JMS

L'application cliente met en oeuvre un MessageListener JMS pour tre l'coute de la file de messages. Il est donc ncessaire de rfrencer l'ensemble des classes JMS pour permettre l'application de se connecter au topic JMS, de souscrire aux messages et de recevoir lesdits messages. Le fournisseur JMS utilis par l'application YAPS est celui fourni en standard avec Sun GlassFish savoir Sun Java System Message Queue software. Vous allez ajouter les rfrences aux libraires JMS livres avec Sun GlassFish.
Sous NetBeans, slectionnez le menu Tools > Libraries :
L'cran suivant montre l'ensemble des librairies dfinies sous NetBeans :
Vous allez ajouter une nouvelle librairie. Cliquez sur le bouton New Library pour ajouter une nouvelle libraire de type Class Libraries que nous allons nommer JMS :
Cliquez sur OK pour poursuivre. ce stade, la libraire JMS est slectionne. En utilisant le bouton Add Jar/Folder , vous allez ajouter l'ensemble des fichiers suivants localiss sous le rpertoire de Sun GlassFish : 1 2 3 4 5 {glassfish-home}/lib/install/applications/jmsra/imqjmsra.jar {glassfish-home}/lib/appserv-admin.jar {glassfish-home}/imq/lib/imq.jar {glassfish-home}/lib/appserv-rt.jar {glassfish-home}/lib/javaee.jar
Les boutons Move Up et Move Down permettent d'agencer l'ordre des fichiers tel que nous l'avons dcrit plus haut. Cliquez sur le bouton OK pour appliquer vos modifications. Maintenant que la librairie JMS est prte l'emploi, vous allez ajouter sa rfrence au projet Yaps-Client. Ouvrez les proprits du projet Yaps-Client et slectionnez la catgorie Libraries :
Cliquez sur le bouton Add Library :
Dans la liste des librairies, slectionnez JMS et cliquez sur le bouton Add Library :
Cliquez sur OK . La librairie JMS est maintenant rfrence dans le projet Yaps-Client. NetBeans va automatiquement compiler le projet et rsoudre les rfrences manquantes. ce stade, plus aucune erreur ne doit tre dtecte dans le projet :
LLX-B-3-d - Rfrencer les librairies TopLink

Durant la phase d'excution du l'application Yaps-Client, des objets de type Entity sont manipuls pour lesquelles les classes du framework TopLink sont requises.
Vous allez rfrencer les classes du framework TopLink pour viter les erreurs d'excution. Ouvrez les proprits du projet et slectionnez la catgorie Libraries :
Cliquez sur le bouton "Add Library" et slectionnez la librairie TopLink Essentials :
Cliquez sur Add Library . Cliquez ensuite sur OK afin d'ajouter la rfrence de la libraire TopLink :
LLX-B-4 - Identifier la classe principale

Avant de tester l'application, il vous reste localiser la classe principale Main Class qui sera invoque l'excution. Ouvrez les proprits du projet et rendez-vous sur la catgorie Run :
Le champ Main Class permet d'identifier la classe principale. Cliquez sur le bouton Browse pour slectionner la classe principale com.yaps.petstore.client.ui.PetstoreFrame :
Cliquez sur le bouton Select Main Class . Cliquez ensuite sur OK afin de sauver vos modifications dans les proprits du projet :
LLX-B-5 - Crer le groupe de projet

partir du menu File ou via un clic droit dans la fentre Projects , NetBeans offre la capacit de crer le nouveau groupe de projet :
Slectionnez l'option New group . La fentre suivante permet de nommer le groupe de projet qui est dans notre cas Yaps - Client :
Les options par dfaut indiquent que les projets en cours de chargement dans l'IDE seront automatiquement ajouts au groupe de projet. Cliquez sur le bouton Create Group .
LLX-C - Compiler le projet

En analysant en dtail les traces de la compilation, on relve les messages suivants :

... Building jar: C:\Projects\YapsON\Yaps-Client\dist\Yaps-Client.jar ... To run this application from the command line without Ant, try: java -jar "C:\Projects\YapsON\Yaps-Client\dist\Yaps-Client.jar" ... BUILD SUCCESSFUL (total time: 6 seconds)
Ces traces indiquent que l'application Yaps-Client a t correctement compile et qu'il est possible de l'excuter partir de la ligne de commande en invoquant la commande suivante :
java -jar {yapson_home}\Yaps-Client\dist\Yaps-Client.jar
LLX-D - Tester le projet

Nous allons dcrire les spcificits de NetBeans en matire d'excutions d'applications Java.
LLX-D-1 - Dmarrer le serveur PetStore

Avant de dmarrer l'application Yaps-Client, il est ncessaire de dmarrer le serveur PetStore . Rendez-vous sur l'onglet Services et dmarrez le serveur PetStore :
LLX-D-2 - Excuter l'application Yaps-Client

Sous NetBeans, l'application Yaps-Client peut-tre dmarre de diffrentes faons : En appuyant sur la touche F6 partir du menu Run -> Run Main project :
partir de l'option Run du menu contextuel du projet :
partir de la barre d'outils en cliquant sur l'icne suivant :
L'application apparat l'cran :
Reportez-vous au livre de rfrence qui dcrit les fonctionnalits de l'application client. S'abonner au topic JMS Pour recevoir les messages posts dans la file d'attente JMS (les articles de type reptiles ), n'oubliez pas de vous abonner au topic JMS en ouvrant la fentre Watch orders disponible sous le menu Order . L'application cliente ne gre pas la notion de durabilit des messages JMS. La barre de statut de NetBeans (en bas et droite) affiche le statut de l'application en cours d'excution :
Pour stopper l'excution de l'application, un clic droit sur la barre de statut propose un menu contextuel permettant de stopper l'application :
LLX-E - Conclusion
Les sources du client de l'application Yaps ont t transfres sous NetBeans dans une arborescence conforme au format prconis par le Java Blueprints. Les tests que nous avons raliss attestent que l'application cliente Swing communique correctement avec les composants dploys sur le serveur.
XI - Conclusion
Nous voil arrivs au terme de ce document. Vous tes maintenant en mesure d'utiliser l'application Yaps Pet Store sous NetBeans et d'approfondir vos connaissances de JEE5 en bnficiant de la richesse et de la souplesse de NetBeans 6.5. Coupl au livre de rfrence, vous tes par vous lancer dans l'laboration d'application JEE5 ou de raliser des POC (Proof Of Concept) nettement plus riches qu'un simple Hello World . L'application Yaps Pet Store peut servir d'excellent point de dpart pour vos exprimentations. Bien entendu, nous n'avons qu'effleur les diffrentes facettes de NetBeans. Le site www.netbeans.org vous sera d'un grand secours tant les informations qui s'y trouvent sont nombreuses. Et maintenant, vous de jouer !
XII - Rfrences
[R1] Le livre Les Cahiers du Programmeur Java EE5 - Seconde dition de Antonio Goncalves parut aux ditions Eyrolles 2008. Site du livre : http:// www.antoniogoncalves.org/xwiki/bin/ view/Book/WebHome L'application de rfrence Java Pet Store 2.0 du programme Java BluePrints de Sun Microsystems : http://java.sun.com/developer/releases/ petstore/ Site de NetBeans : http://www.netbeans.org Description et historique de NetBeans sous Wikipedia : http://fr.wikipedia.org/wiki/NetBeans (Franais) http://en.wikipedia.org/wiki/Netbeans (Anglais) Cet article dcrit les motivations de portage d'une application Web sous NetBeans ainsi que la diffrence entre la structure de fichier de type Jakarta et Java BluePrints prconise par SUN : http://www.netbeans.org/kb/articles/ porting-webapps.html
[R2]
[R3] [R4]
[R5]
XIII - Glossaire
DB EAR EJB ESB IDE JAR Java SE JAX-WS JDBC JDK JEE JEE5 JMS JPA JSF JVM POC SOA SQL URI URL WAR WSDL YapsON DataBase Enterprise Archive Enterprise JavaBean Enterprise Servive Bus Integrated Development Environment Java ARchive Java Standard Edition Java API for XML Web Services Java DataBase Connectivity Java Development Kit Java Enterprise Edition Java Enterprise Edition version 5 Java Message Service Java Persistance API JavaServer Faces Java Virtual Machine Proof of Concept Service Oriented Architecture Structured Query Language Uniform Resource Identifier Uniform Resource Locator Web Application aRchive Web Service Description Language Yaps Pet Store On NetBeans

Netbeans Yaps

Diunggah oleh

Informasi Dokumen

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Netbeans Yaps

Diunggah oleh

Hak Cipta:

Format Tersedia

YAPS Pet Store sous NetBeans

par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

II - Conventions II-A - Langue

II-B - Mots cls

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

III - Installation III-A - Prrequis

Le chapitre 3 du livre de rfrence dcrit comment installer le JDK et Ant.

III-B-1 - Rcuprer NetBeans

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Ensuite, il vous reste slectionner le type de bundle :

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

III-B-2 - Installer NetBeans

III-B-2-a - Page d'accueil

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

III-B-2-b - License Agreement

Acceptez les termes de la licence et cliquez sur "Next" pour continuer.

III-B-2-c - Rpertoires d'installation

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Cliquez sur Next pour continuer.

III-B-2-d - Proprits de GlassFish v2

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Vous pouvez garder le dfaut et cliquer sur Next pour continuer.

III-B-2-f - Apache Tomcat

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Cliquez sur Next pour continuer.

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Cliquez sur Install pour dmarrer le processus d'installation.

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Cliquez sur Finish pour terminer le processus d'installation.

III-B-3 - Dmarrer NetBeans

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Dans ce fichier, modifiez l'entre "netbeans_default_options" pour y ajouter l'option :

Par exemple, pour forcer le code langue en anglais :

Ci-dessous, un extrait du fichier de configuration montre le code langue fix EN :

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

LLIII-C - Variables d'environnement

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

LLIII-D - Rcuprer l'application Yaps

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

Le livre de rfrence dtaille l'ensemble des rpertoires.

LLIII-E - Rcuprer l'application YapsON

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

LLIV-A - Variables d'environnement

LLIV-B - Scripts Ant

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

LLV-A - Positionner les variables d'environnement

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

C:> cd {yapson_home} {yapson_home}> setenv-yaps.cmd

LLV-B - Crer le domaine petstore

Excutez la commande asadmin suivante afin de crer le domaine petstore :

enter enter enter enter

the the the the

ce stade, le domaine "petstore" est physiquement cr sous le rpertoire domains de GlassFish :

Cette commande ncessite d'identifier : le rpertoire domains de GlassFish

YAPS Pet Store sous NetBeans par Sad Eloudrhiri