Netbeans Yaps

8/2/2019 Netbeans Yaps

1/188

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 AntonioGoncalves dans son livre "Java EE 5", sous NetBeans.
http://www.developpez.com/


2/188

YAPS Pet Store sous NetBeans par Sad Eloudrhiri

- 2 -Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme par tielle, ne peut tre faite de ce siteet de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon laloi jusqu' 3 ans de prison et jusqu' 300 000 E de dommages et intrts.

http://noratek.developpez.com/tutoriel/javaee/netbeans/yapson/

I - Introduction..............................................................................................................................................................5II - Conventions............................................................................................................................................................7

II-A - Langue...........................................................................................................................................................7II-B - Mots cls.......................................................................................................................................................7II-C - Rpertoires....................................................................................................................................................7II-D - Commandes..................................................................................................................................................7

II-E - Messages................................. ..................................................................................................................... 7III - Installation............................................................................................................................................................. 8III-A - Prrequis...................................................................................................................................................... 8III-B - NetBeans.................................................. ....................................................................................................8

III-B-1 - Rcuprer NetBeans................................. .......................................................................................... 8III-B-2 - Installer NetBeans............................................................................................................................. 10

III-B-2-a - Page d'accueil................. ..........................................................................................................10III-B-2-b -License Agreement................................................................................................................... 13III-B-2-c -Rpertoires d'installation........................................................................................................... 13III-B-2-d -Proprits de GlassFish v2.. .................................................................................................... 14III-B-2-e - GlassFish v3............................................................................................................................. 15III-B-2-f - Apache Tomcat.......................................................................................................................... 16

III-B-2-g - Rsum.....................................................................................................................................17III-B-2-h - Finish.........................................................................................................................................18III-B-3 - Dmarrer NetBeans............................ ...............................................................................................19III-B-4- Localisation........................................................................................................................................20

LLIII-C -Variables d'environnement.....................................................................................................................21LLIII-D - Rcuprer l'application Yaps................................................................................................................. 22LLIII-E - Rcuprer l'application YapsON............................................................................................................ 23

IV - Configur er YapsON.............................................................................................................................................24LLIV-A - Var iables d'environnement.....................................................................................................................24LLIV-B - Scr ipts Ant............................................................................................................................................. 24

V - Configurer GlassFish........................................................................................................................................... 25LLV-A - Positionner les variables d'environnement............................................................................................. 25LLV-B - Crer le domaine petstore ................. .............................................................................................. 26LLV-C - Dmarrer le domaine petstore .. ....................................................................................................... 28LLV-D - Localisation de GlassFish.......................................................................................................................30LLV-E - Crer les ressources Database.............. ................................................................................................ 30

LLV-E-1 - Pool de connexions JDBC............................................................................................................. 31LLV-E-2 - Dmarrer le serveur Derby............................................................................................................ 33LLV-E-3 - Crer la base d e donnes............................................................................................................. 33LLV-E-4 - Crer la source de donnes..... ..................................................................................................... 34

LLV-F - Crer les ressources JMS...................................................................................................................... 35LLV-F-1 - Crer la fabrique de connexion......................................................................................................35LLV-F-3 - Vrification...................................................................................................................................... 36

LLV-G -Crer les loggers............................... .....................................................................................................37LLV-H - Finde la configuration............................................................................................................................38

LLV-G-1- Stopper le serveur Derby...............................................................................................................38LLV-G-2 - Stopper le domaine petstore ...................................................................................................38VI - Configurer NetBeans..................... ..................................................................................................................... 39

LLVI-A - Serveur Petstore ................... .......................................................................................................... 39LLVI-A-1 - Ajout du serveur Petsto re .......................................................................................................39

LLVI-A-1-a - Type de serveur............................. .......................................................................................39LLVI-A-1-b - Slection du domaine........................................................................................................... 40LLVI-A-1-c - Profil de l'administrateur....................................................................................................... 41

LLVI-A-2 - Liste des serveurs.............. ........................................................................................................... 42LLVI-A-3- Affichage des traces......................................................................................................................43LLVI-A-4- Dmarrer le serveur Petstor e........................................................................................................44LLVI-A-5 - Explorer les ressources.................................................................................................................47LLVI-A-6 - Accs la console d'administration..............................................................................................49

LLVI-B- Changer de browser.............................................................................................................................. 49LLVI-C -Base de donne s...................................................................................................................................51
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


3/188




LLVI-C-1 - Arrt et dmarrage du serveur de base de donnes....................................................................52LLVI-C-2 - Vrifier les proprits.................................................................................................................... 53LLVI-C-3 - Connexion vers la base de donnes............................................................................................56

LLVI-D - Conclusion............................................................................................................................................. 56VII - Importer le projet BarkBank.............................................................................................................................. 57

LLVII-A - Crer un nouveau projet.......................................................................................................................57

LLVII- A-1 - Fermeture des projets.................................................................................................................. 57LLVII- A-2 - Type de projet.............................................................................................................................. 58LLVII- A-3 - Nom et rpertoires....................................................................................................................... 58LLVII- A-4 - Configuration du serveur..............................................................................................................59LLVII-A-5- Les frameworks............................................................................................................................ 60LLVII-A-6 - Gnration du projet.................................................................................................................... 61

LLVII-B - Transf rer le projet sous NetBeans................... ...................................................................................62LLVII-B-1- Positionner les variables d'environnement...................................................................................62LLVII-B-2- Transfrer le projet.......................................................................................................................62LLVII-B-3- Crer le groupe de projet.............................................................................................................64

LLVII-C -Compiler le projet................................................................................................................................. 66LLVII-4 - Dployer le projet..................................................................................................................................68

LLVII-E - Tester le projet...................................................................................................................................... 70LLVII-E-1- Mthode 1 : Web Service Tester de GlassFish............................................................................71LLVII-E-2- Mthode 2 : Web Service Tester de NetBeans............................................................................71

LLVII-F - Conclusion.............................................................................................................................................79VIII - Importer le projet PetEx................................................................................................................................... 80

LLVIII-A - Crer un nouveau projet......................................................................................................................80LLVIII-A-1 - Fermeture des projets................................................................................................................. 80LLVIII-A-2- Type de projet............................................................................................................................. 81LLVIII-A-3- Nom et rpertoires...................................................................................................................... 81LLVIII-A-4 - Configuration du serveur.............................................................................................................82LLVIII-A-5 - Les frameworks........................................................................................................................... 83LLVIII-A-6 - Gnration du projet................................................................................................................... 84

LLVIII-B - Tr ansfrer le projet sous NetBeans......... ............................................................................................85LLVIII-B-1- Positionner les variables d'environnement..................................................................................85LLVIII-B-2- Transfrer le projet...................................................................................................................... 85LLVIII-B-3 - Crer le groupe de projet............................................................................................................87

LLVIII-C - Compiler le projet................................................................................................................................ 89LLVIII-D - Dployer le projet................................................................................................................................ 91LLVIII-E - Tester le projet..................................................................................................................................... 93

LLVIII-E-1- Mthode 1: Web Service Tes ter de GlassFish............................................................................94LLVIII-E-2- Mthode 2: Web Service Tester de NetBeans............................................................................94

LLVIII-F - Conclusion..........................................................................................................................................101IX - Importer le projet Yaps - ct serveur......... .................................................................................................... 102

LLIX- A - Crer un nouveau projet..................................................................................................................... 102LLIX- A-1 - Fermeture des projets.................................................................................................................102

LLIX-A-2- Type de projet............................................................................................................................. 103LLIX-A-3- Nom et rpertoires...................................................................................................................... 103LLIX- A-4 - Configuration du serveur.............................................................................................................104LLIX- A-5 - Gnration du projet................................................................................................................... 105

LLIX-B -Transfrer le projet sous NetBeans.....................................................................................................106LLIX-B-1- Positionner les variables d'environnement..................................................................................106LLIX-B-2- Transfrer le projet......................................................................................................................107LLIX-B-3- Rfrencer les Web Services.................................... ................................................................. 110

LLIX-B-3-a - Rfrencer DeliveryService................................................................................................ 110LLIX-B-3-b - Rfrencer ValidationService..............................................................................................113

LLIX-B-4- Crer le groupe de projet........................................................................................................... 116LLIX-C - Changer le Context Root.....................................................................................................................118LLIX-D - Crer le fichier de dploiement standard............................................................................................119LLIX-E - Compiler le projet................................................................................................................................ 122LLIX-F - Dployer le projet.................................................................................................................................123


4/188




LLIX-G - Base de donnes................................................................................................................................ 125LLIX-G-1 - Crer une connexion.................................................................................................................. 125LLIX-G-2 - Connexion la DB..................................................................................................................... 129LLIX-G-3 - Explorer la DB............................................................................................................................ 131LLIX-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.............................................138LLIX-H - Tester le projet.....................................................................................................................................146LLIX-I - Conclusion.............................................................................................................................................150

X - Importer le projet Yaps - ct client..................................................................................................................151LLX-A - Crer un nouveau projet...................................................................................................................... 151

LLX-A-1-a - Fermer les projets.....................................................................................................................151LLX-A-1-b - Type de projet......................................................................................................................151LLX-A-1-c - Nom et rpertoires...............................................................................................................152LLX-A-1-d - Gnration du projet............................................................................................................154

LLX-B - Transfrer le projet sous NetBeans......................................................................................................154LLX-B-1 - Positionner les variables d'environnement...................................................................................154LLX-B-2 - Transfrer le projet.......................................................................................................................154

LLX-B-3 - Rfrencer les librairies............................................................................................................... 156LLX-B-3-a - Rfrencer les classes de Yaps-Server.............................................................................. 157LLX-B-3-b - Rfrencer les librairies utilitaires....................................................................................... 161LLX-B-3-c - Rfrencer les librairies JMS.............................................................................................. 163LLX-B-3-d - Rfrencer les librairies TopLink......................................................................................... 171

LLX-B-4 - Identifier la classe principale........................................................................................................174LLX-B-5 - Crer le groupe de projet............................................................................................................ 177

LLX-C - Compiler le projet................................................................................................................................. 179LLX-D - Tester le projet......................................................................................................................................182

LLX-D-1 - Dmarrer le serveur PetStore......................................................................................................182LLX-D-2 - Excuter l'application Yaps-Client................................................................................................182

LLX-E - Conclusion............................................................................................................................................ 185XI - Conclusion........................................................................................................................................................ 186XII - Rfrences............. ..........................................................................................................................................187XIII - Glossaire.................. ....................................................................................................................................... 188


5/188




I - Introduction

Dans le livre d'Antonio Goncalves consacr Java EE5 (voir ici ), l'auteur illustre les principaux concepts de JEE 5 autravers d'une application fictive baptise Yaps Pet Store (ou Yaps pour faire court). Cette application est elle-mmeune 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 etexprimenter le vaste sujet qu'est JEE 5 .

Les sujets du livre de rfrence sont traits de manire construire pas pas les diffrents composants del'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'IDEde 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 estque l'IDE choisi (Eclipse, NetBeans, IntelliJ, etc.) soit un moteur et non un frein dans le processus d'industrialisationde logiciels.

Par ailleurs, connatre plus d'un IDE est une valeur ajoute. En tant que consultants informatiques, nous sommessouvent amens adapter nos habitudes par rapport l'environnement de l'entreprise dans laquelle nousintervenons. Le choix des outils logiciels est souvent dict par des contraintes tant financires, techniques ouculturelles.

Dans le cas de notre entreprise, NetBeans est trs apprci notamment pour sa couche SOA . Les outilsSOA intgrs NetBeans ainsi que l'ESB (Enterprise Service Bus) OpenESB sont excellents pour concevoir des prototypesapplicatifs. Mais c'est un autre sujet que nous aurons probablement l'occasion d'aborder dans le cadre d'un autredocument.

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 NetBeans6.5 pour obtenir un environnement complet et gratuit pour exprimenter les diffrents sujets du livre et aller plus loindans la dcouverte des concepts entourant les spcifications JEE 5 .

Ce document est subdivis comme suit :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.antoniogoncalves.org/xwiki/bin/view/Book/JavaEE5Frhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


6/188




Installation Installation de NetBeans et des fichiersncessaires au processus d'importation del'application Yaps Pet Store.

Configurer YapsON Dcris la configuration apporter auxfichiers livrs avec l'application initialeYapsON.

Configurer GlassFish La configuration de GlassFish ncessaireavant de pouvoir dployer les diffrentsprojets.

Configurer NetBeans La configuration de NetBeans avantd'accueillir les projets dployer.

Importer le projet BarkBank L'importation et le dploiement du projetBarkBank.

Importer le projet PetEx L'importation et le dploiement du projetPetEx.

Importer le projet Yaps - ct serveur L'importation et le dploiement de la partieserveur du projet Yaps.

Importer le projet Yaps - ct client L'importation et le dploiement de la partie

cliente du projet Yaps. Conclusion La conclusion de ce document.
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


7/188




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 Par "Livre de rfrence", nous entendons lelivre sur Java EE5 d'Antonio Goncalves (voir [R1]).

Yaps Identifie l'application originale Yaps PetStore fournie par l'auteur du livre derfrence.

YapsON Identifie l'application Yaps importe sousNetBeans (Yaps Pet Store on NetBeans).

II-C - Rpertoires

{netbeans_home} Rpertoire d'installation de NetBeans.{glassfish_home} Rpertoire d'installation de GlassFish v2.{yaps_home} Rpertoire hbergeant l'application originale

Yaps Pet Store.{yaps_on_home} 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.


8/188




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 dukit 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.
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.netbeans.org/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


9/188




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 :


10/188




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 cetIDE.Vous trouverez notamment bon nombre de tutoriaux estampills avec la version de l'IDEqui est supporte.

III-B-2 - Installer NetBeansVous 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 :


11/188




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 :


12/188




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.


13/188




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 votreenvironnement :


14/188




Cliquez sur Next pour continuer.

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

Proprits de GlassFish v2


15/188




Nous avons gard les paramtres par dfaut savoir :

GlassFish Le dossier o sera install GlassFish v2. JDK Le dossier o a t install le JDK . Admin Username Le nom qui sera utilis pour administrer

GlassFish.Le dfaut est: admin

Admin Password Le mot de pass de l'administrateur deGlassFish.Le dfaut est: adminadmin

Ports 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 :


16/188




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 :


17/188





III-B-2-g - Rsum

La page suivante prsente un rsum du paramtrage :


18/188




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 :


19/188




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 :


20/188




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

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 byexplicit# command line switches:netbeans_default_options="-JDorg.netbeans.modules.tomcat.autoregister.token=1227909276055 -JDorg.netbeans.modules.tomcat.autoregister.catalinaHome=\"C:\ProgramFiles\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"...


21/188




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:\> set ANT_HOME=C:\Tools\Ant\apache-an t-1.7.1C:\> set PATH=%ANT_HOME%\bin;%PATH%C:\> set GLASSFISH_HOME=C:\Program Files\glassfish-v2ur2C:\> set PATH=%GLASSFISH_HOME%\bin;%PATH%C:\> set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_10C:\> set PATH=%JAVA_HOME%\bin;%PATH%


22/188




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 Yapscorrespondant au JDK 1.6.

Ensuite, vous devez extraire le fichier d'archives dans un rpertoire qui sera rfrenc dans la suite du documentsous le nom {yaps_home }.

Les rpertoires et les documents suivants sont extraits du fichier d'archives :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.antoniogoncalves.org/xwiki/bin/view/Book/JavaEE5Frhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


23/188




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 laversion minimale del'application YapsON utilise comme point dedpart au processus de portage dcrit dansce document.

YapsON-complete.zip Ce fichier contient laversion compltede l'application YapsON telle qu'obtenueaprs la phase de portage dcrite dans cedocument.

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 Ce fichier Ant provient du projet Yaps PetStore et contient un ensemble de tchespour configurer et grer GlassFish et Derby.

setenv-yaps.cmd Fichier de commande dfinissant lesvariables d'environnement JAVA_HOME,

ANT_HOME, GLASSFISH_HOME. yapson.xml Fichier de script Ant permettant le transfert

des projets Yaps vers l'arborescence deNetBeans.

yapson.properties Fichier de proprits utilis par le script Ant yapson.xml .

yaps-data.xml Fichier de script Ant utilis pour charger labase 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 dansla suite du document sous le nom {yaps_on_home } :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.noratek.net/2008/12/08/yaps-sous-netbeans-65/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


24/188




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 lesrpertoires d'installation adquats :

YAPS_HOME Rpertoire d'installation de l'applicationYaps (voir ici ).

YAPSON_HOME Rpertoire d'installation de l'applicationYapsON (voir ici ).

GLASSFISH_HOME Rpertoire d'installation de GlassFish v2(voir ici ).

ANT_HOME Rpertoire d'installation d'Ant (voir ici ).JAVA_HOME Rpertoire d'installation du JDK (voir ici ).

LLIV-B - Scripts Ant

ditez le fichier yapson.properties et modifiez les proprits suivantes :

yaps.folder Rpertoire d'installation de l'applicationYaps (voir ici ).

yapson.folder Rpertoire d'installation de l'applicationYapsON (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 ).
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LIII-B-2-dhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LLLIII-Ehttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LLLIII-Dhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LIII-Ahttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LIII-Ahttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LIII-B-2-dhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LLLIII-Ehttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=installation#LLLIII-Dhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


25/188




V - Configurer GlassFish

La configuration du serveur d'applications GlassFish est similaire celle expose dans le livre de rfrence etrsume 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 deconfiguration.

Rendez-vous dans le rpertoire de l'application YapsON et excutez le fichier de commande setenv-yaps.cmd :


26/188




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'applicationYapsON.

Les proprits du domaine petstore sont les suivantes :

Name petstore http port number 8080 Admin port number 8282 Admin username admin

Admin password adminpwd Master password masterpwd

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

{yapson_home}> asadmin create-domain --a dminport 8282 --user admin --savemasterpa ssword=true --instanceport 8080 petstore

La procdure de cration du domaine petstore vous demande de dfinir les mots de passe admin et master :

...Please enter the admin password>Please enter the admin password again>Please enter the master password [Enter to accept the default]:>Please enter the 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 inconfiguration file.


27/188




Security Store uses: JKSDomain petstore created.

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

{yapson_home}> dir {glassfish_home}\doma ins\petstore...06/11/2008 23:59 .06/11/2008 23:59 ..06/11/2008 23:59 addons06/11/2008 23:59 applications06/11/2008 23:59 autodeploy06/11/2008 23:59 bin06/11/2008 23:59 config06/11/2008 23:59 docroot06/11/2008 23:59 generated06/11/2008 23:59 imq06/11/2008 23:59 java-web-start

06/11/2008 23:59 jbi06/11/2008 23:59 lib06/11/2008 23:59 logs06/11/2008 23:59 500 master-password06/11/2008 23:59 session-store1 File(s) 500 bytes15 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_hom e}\domains petstoreDomain petstore deleted.

Cette commande ncessite d'identifier :

le rpertoire domains de GlassFish
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


28/188




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-do main

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 b04-fcs)] 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 :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://localhost:8282/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


29/188




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 :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=glassfish#LLLV-Bhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


30/188




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.
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://localhost:8282/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


31/188




Cette section dcrit le processus de cration de l'ensemble des ressources requises pour accder et manipuler labase 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-c onnection-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 correctementdroule.

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-con nection-pool...[exec] __CallFlowPool[exec] __TimerPool[exec] DerbyPool[exec] petstorePool[exec] Command list-jdbc-connection-pools executed successfully.[exec][exec] C:\Projects\YapsON>endlocalBUILD 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
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.antoniogoncalves.org/xwiki/bin/view/Book/JavaEE5InstallMySQLFrhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


32/188




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 labase de donnes :


33/188




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-con nection-pool...[exec] Command ping-connection-pool executed successfully....

La base de donnes petstoreDB est maintenant cre sous le rpertoire javadb de GlassFish :


34/188




{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-d atasource...[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-dat asource

...[exec] jdbc/__TimerPool[exec] jdbc/__CallFlowPool
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


35/188




[exec] jdbc/__default[exec] jdbc/petstoreDS[exec] Command list-jdbc-resources executed successfully.


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-j ms-connection-factory...


36/188




[exec] Command create-jms-resource executed successfully.]]>

Crer la file d'attente

Excutez la tche create-jms-topic pour crer la file d'attente (JMS topic) jms/topic/order

:

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.


Les ressources JMS se trouvent aux emplacements suivants :

Resources -> JMS Resources -> Connection Factories Resources -> JMS Resources -> Destination Resources


37/188




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-logg ers...[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 :


38/188




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 serontdmarrs 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-dom ain...[exec] Domain petstore stopped.


39/188




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 avezprcdemment 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 :


40/188




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.


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 :


41/188





LLVI-A-1-c - Profil de l'administrateur

Cette tape consiste identifier le profil de l'administrateur :


42/188




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 :
http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson//?page=glassfish#LLLV-Bhttp://%20http//noratek.developpez.com/tutoriel/javaee/netbeans/yapson/http://www.developpez.com/


43/188




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 :


44/188




LLVI-A-4 - Dmarrer le serveur Petstore

Vous pouvez maintenant dmarrer le serveur Petstore en slectionnant l'option Start du menu contextuel :


45/188




La fentre Output de NetBeans permet de suivre le processus de dmarrage du domaine petstore :


46/188




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 derechercher une chane de caractres (Find) ou d'effacer le contenu de la fentre (Clear).


47/188




LLVI-A-5 - Explorer les ressources

Une exploration du serveur Petstore permet de dcouvrir les lments dploys dans le domaine tels que lesapplications, les ressources JMS ou les ressources JDBC :


48/188


- 48 -Copyright 2008,2009 Developpez LLC. Tout droits rservs Developpez LLC. Aucune reproduction, mme par tielle, ne peut tre faite de ce siteet de l'ensemble

Documents

Netbeans Yaps