Cours NetBeans avancé

___

Tutorial

YAPS Pet Store sous NetBeans

___

Said Eloudrhiri

01-Oct-2009

Version: 0.07

Historique

Table des matières

Dans le livre d’Antonio Goncalves consacré à Java EE5, l'auteur illustre les principaux concepts de JEE 5 au travers d'une application fictive baptisée Yaps Pet Store (ou Yaps pour faire court). Cette application est elle-même une émanation du Java Petstore de Sun issue du programme Java BluePrints.

Le livre de référence couplé à l’application Yaps est un excellent support pédagogique pour qui souhaite aborder et expérimenter le vaste sujet qu’est JEE 5.

Les sujets du livre de référence sont traités de manière à construire pas à pas les différents composants de l'application en abordant les principales spécifications de JEE5 : EJB, JPA, JMS, JAX-WS, JavaMail, etc.

L'auteur a pris le parti d'être indépendant d'un quelconque IDE. Des tâches Ant sont utilisées pour configurer l’environnement de travail, ainsi que pour construire et déployer les projets de l’application.

Ce document a pour objectif de décrire les différentes étapes nécessaires pour porter l’application Yaps sous l’IDE de Sun : NetBeans 6.5 Pourquoi NetBeans ?

Loin de nous l’idée de débattre 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, connaître plus d’un IDE est une valeur ajoutée.  En tant que consultants informatiques, nous sommes souvent amenés à 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 financières, techniques ou culturelles. 

Dans le cas de notre entreprise, NetBeans est très apprécié notamment pour sa couche SOA. Les outils SOA intégrés à 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 idéal pour aborder les concepts JEE5.

Et c’est justement l’objectif de ce document.

À partir du livre de référence et de l’application Yaps, nous allons importer l’ensemble des projets sous NetBeans 6.5 pour obtenir un environnement complet et gratuit pour expérimenter les différents sujets du livre et aller plus loin dans la découverte des concepts entourant les spécifications JEE 5.

Ce document est subdivisé comme suit :

Dans ce document, les copies d’écrans des logiciels utilisés (Microsoft Windows, NetBeans, etc.) sont en anglais. Ils peuvent donc différer de votre environnement.

Le tableau suivant fournit l’ensemble des mots clés utilisés dans le document :

Les commandes sont représentées de la manière suivante : 

Dans le document, des messages peuvent apparaître pour alerter ou informer le lecteur.

Ce document a été conçu avec la configuration logicielle suivante:

•   Microsoft Windows Vista Service Pack 1 ou supérieur

•   Sun Java Development Kit (JDK) 1.6 Update 7 ou supérieur

•   Ant 1.7.0 ou supérieur

•   NetBeans 6.5 installé avec le Bundle « All »

•   Les fichiers de Yaps

•   Les fichiers de YapsON

Le chapitre 3 du livre de référence décrit comment installer le JDK et Ant.

NetBeans 6.5 est l’IDE (Integrated Development Environment) Open Source de Sun conçu pour concevoir, déployer et tester des applications développées sous différents langages (Java, PHP, Ruby, C/C++, etc.).

Tout comme Eclipse, NetBeans utilise la notion de plug-ins pour enrichir son environnement de développement.

En ce qui concerne JEE5, NetBeans fournit un environnement riche et complet pour concevoir des applications (visuelles ou non) et les déployer au sein de serveurs tels que GlassFish ou Tomcat qui font partie intégrante du kit d’installation.

NetBeans est disponible sous différents bundles. Chacun couvrant un ensemble de fonctionnalités.

Ce document a été conçu sur base du bundle « All » de NetBeans. Mais vous pouvez vous contenter du bundle « Java » et récupérer plus tard les plug-ins qui vous intéressent (par exemple le stack SOA).

NetBeans 6.5 peut être téléchargé gratuitement à partir du site de Sun à l’adresse suivante:

La page affiche la dernière version en date de NetBeans.

Figure 3-1: Version de NetBeans

Cliquez sur le bouton “Download NetBeans IDE” pour continuer.

La page de téléchargement permet de définir les propriétés du kit NetBeans :

•   Langue de travail

•   Plateforme

Figure 3-2: Langue de travail et plateforme

Ensuite, il vous reste à sélectionner le type de bundle :

Ce document est conçu à partir du bundle “All”.

Cliquez sur le bouton “Download” pour télécharger NetBeans.

Vous allez passer en revue les différentes étapes requises pour installer NetBeans.

Commencez par exécuter le fichier ““.

La page d’accueil permet d’emblée de définir la liste des composants à installer :

Figure 3-4: Page d'accueil

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… » :

Figure 3-5: Paramétrer (Customize) l'installation

Dans l’écran ci-dessus, on remarque que l’ensemble des composants a été sélectionné.

Dans le contexte de l’application YapsON, veillez à sélectionner 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.

Cette étape présente la licence Open Source utilisée par NetBeans :

Figure 3-6: Licence de NetBeans

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

Cette étape permet de définir les répertoires d’installation de NetBeans et de localiser le JDK préinstallé dans votre environnement :

Figure 3-7: Répertoires d'installation

Cliquez sur « Next » pour continuer.

Cette étape vous permet de définir les propriétés du serveur GlassFish v2 sur lequel sera déployé YapsON :

Figure 3-8: Paramètres de GlassFish V2

Nous avons gardé les paramètres par défaut à savoir :

Cliquez sur « Next » pour continuer.

La version 3 de GlassFish est livrée à titre d’évaluation (Prelude version).

L’application YapsON n’utilise pas GlassFish v3 :

Figure 3-9: Répertoire de GlassFish v3

Vous pouvez garder le défaut et cliquer sur « Next » pour continuer.

Cette étape apparaît uniquement si vous avez sélectionné le package optionnel de Tomcat.

Dans ce cas, l’écran suivant vous demande de choisir le répertoire d’installation de Tomcat v6 ou d’accepter le défaut :

Figure 3-10: Répertoire de Tomcat v6

Cliquez sur « Next » pour continuer.

La page suivante présente un résumé du paramétrage :

Figure 3-11: Résumé d'installation

Cliquez sur « Install » pour démarrer le processus d’installation.

À la fin de l’installation, la dernière étape vous demande d’enregistrer NetBeans et GlassFish :

Figure 3-12: Enregistrer NetBeans et GlassFish

Cliquez sur « Finish » pour terminer le processus d’installation.

Démarrez NetBeans sous le lien:

Start? All Programs ? NetBeans ? NetBeans IDE 6.5

NetBeans offre un processus automatique qui lui permet de vérifier la présence de mises à jour.

Ce processus est enclenché à chaque démarrage de NetBeans :

Figure 3-13: Vérification des mises à jour

Un message dans la barre de statut vous informe de la présence des mises à jour :

Figure 3-14: Mises à jour détectées

Pour visualiser la liste des mises à jour et les appliquer, cliquez sur l’icône de la barre de statut.

Il est bien entendu recommandé d’appliquer ces mises à jour.

Par défaut, NetBeans utilise la localisation courante pour afficher ses boîtes de dialogues.

Vous pouvez forcer une localisation spécifique en modifiant le fichier « » de NetBeans qui se trouve à l’emplacement suivant :

{netbeans_home}\etc\

Dans ce fichier, modifiez l’entrée “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 :

Il sera quelquefois nécessaire d'exécuter des instructions via la ligne de commande.

Pour ce faire, les variables d'environnement suivantes doivent être définies dans votre système:

•   GLASSFISH_HOME

•   ANT_HOME

•   JAVA_HOME

La variable d'environnement PATH doit également être adaptée pour localiser les logiciels requis.

Ci-dessous, nous donnons un exemple de définition de variables d’environnement sous MS-Windows:

Ces variables d'environnement peuvent également être définies dans les propriétés système de MS-Windows.

Récupérez l’application Yaps que sera importée sous NetBeans.

L’application Yaps se trouve à l’adresse suivante :

Dans cette page, reportez-vous à la section relative au téléchargement du code source :

Ce document est basé sur une version 1.6 du JDK. Veillez à télécharger le code source de l'application Yaps correspondant au JDK 1.6.

Ensuite, vous devez extraire le fichier d’archives dans un répertoire qui sera référencé dans la suite du document sous le nom {yaps_home}.

Les répertoires et les documents suivants sont extraits du fichier d’archives :

Figure 3-17: Structure de l'archive Yaps

Le livre de référence détaille l’ensemble des répertoires.

L’application YapsON est disponible sous deux archives différentes:

Ce document décrit les étapes de portage à appliquer sur la version minimale de l’application YapsON.

La version minimale est composée des fichiers suivants :

Les fichiers de l’application YapsON sont disponibles à l’adresse suivante :

Vous devez récupérer et extraire le fichier d’archives dans un répertoire qui sera référencé dans la suite du document sous le nom {yaps_on_home} :

Figure 3-18: Structure de l'archive YapsON

Avant d’entamer le processus de configuration, vous allez configurer les fichiers de commande livrés avec le fichier d’archives de l’application YapsON.

Éditez le fichier « » (ou "" si vous êtes sus Linux ou Mac OSX) et modifiez les variables d’environnements suivantes pour y placer les répertoires d’installation adéquats :

Éditez le fichier « yapson.properties » et modifiez les propriétés suivantes :

Il y a également lieu d’éditer le fichier « » afin de modifier la propriété suivante :

La configuration du serveur d’applications GlassFish est similaire à celle exposée dans le livre de référence et résumée dans le fichier « » livré avec le fichier d'archives de Yaps.

Afin de rendre ce document autonome, nous allons rappeler les commandes nécessaires pour configurer GlassFish.

Pour cela, vous allez utiliser les tâches Ant à partir de la ligne de commande.

Avant tout, vous devez positionner les variables d’environnement nécessaires pour l’exécution des tâches Ant de configuration.

Rendez-vous dans le répertoire de l’application YapsON et exécutez le fichier de commande « » :

Sous GlassFish, vous allez créer le domaine « petstore » dans lequel seront déployés les projets de l’application YapsON.

Les propriétés du domaine « petstore » sont les suivantes :

Exécutez la commande « asadmin » suivante afin de créer le domaine « petstore »:

La procédure de création du domaine « petstore » vous demande de définir les mots de passe « admin » et « master » :

Pour rester conforme au livre de référence, vous allez introduire les mots de passe suivants:

•    adminpwd pour le « admin » password

•    masterpwd pour le « master » password

Pour terminer, la procédure vous informe des numéros de ports assignés au domaine « petstore » :

À ce stade, le domaine “petstore” est physiquement créé sous le répertoire « domains » de GlassFish :

Le domaine « petstore » que vous venez de créer doit être démarré afin de poursuivre la configuration du serveur GlassFish.

L’application YapsON fournit le fichier « » contenant des tâches qui permettent de démarrer et stopper le domaine.

Placez-vous dans le répertoire de l’application YapsON:

Exécuter la tâche « start-domain » pour démarrer le domaine « petstore » :

Les traces doivent indiquer que le domaine « petstore » est correctement démarré :

À ce stade, il est possible d’accéder à la console d’administration du domaine « petstore » au travers du lien suivant : 

http://localhost:8282

L’écran de login suivant apparaît :

Figure 5-1: Écran de login

Sur base de notre configuration (voir section 5.2), les informations suivantes doivent être introduites :

• User Name :            admin

• Password :              adminpwd

La console d’administration apparaît à l’écran :

Figure 5-2: Console d'administration

Par défaut, la console d’administration de GlassFish utilise la localisation définie sur le système.

Nous allons décrire comment changer la localisation sous GlassFish:

•   Ouvrez la console d’administration accessible à l’adresse http://localhost:8282.

•   Connectez-vous avec votre compte administrateur.

•   Sélectionnez le noeud Application Server.

•   Sélectionnez l’onglet Advanced et ensuite Domain Attributes.

•   Changez la valeur de l’entrée Locale pour y définir le code langue que vous souhaitez utiliser.

•   Sauvez vos modifications.

La modification du code langue nécessite un redémarrage du serveur GlassFish.

La figure suivante illustre l’application de l’anglais (en-UK) comme langue de travail :

Figure 5-3: Localisation sous GlassFish

Les données de l’application Yaps sont maintenues dans une base de données de type Sun Java DB.

Cette section décrit le processus de création de l’ensemble des ressources requises pour accéder et manipuler la base de données « petstoreDB ».

Commencez par vous placer dans le répertoire de l’application YAPS:

Exécutez la tâche « create-connection-pool » pour créer le pool de connexions « petstorePool » :

En recherchant le statut « BUILD SUCCESSFUL », on s’assure que l’exécution de la tâche s’est correctement déroulée.

La tâche « list-connexion-pool » permet de vérifier que le pool de connexion JDBC a été correctement créé :

Une autre manière 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

Figure 5-4: Pool de connexions JDBC

N’hésitez pas à inspecter les propriétés du pool de connexion « petstorePool ». 

Les propriétés définies dans l’onglet « Additional Properties » seront utilisées plus tard lors de la création de la base de données :

Figure 5-5: Propriétés du pool de connexion

Avant de poursuivre le processus, il est nécessaire de démarrer le serveur de base de données Derby.

Exécutez la tâche « start-db » pour démarrer Derby :

La base de données est créée en exécutant un « ping » vers le pool de connexion.

Exécutez la tâche « ping-connection-pool » pour créer la base de données « petstoreDB » :

La base de données « petstoreDB » est maintenant créée sous le répertoire « javadb » de GlassFish :

{glassfish_home}\javadb\petstoreDB

Figure 5-6: Base de données petstoreDB

La source de données (data source) permet à l’application d’accéder à la base de données.

Exécutez la tâche « create-datasource » pour créer la source de données « petstoreDS » :

Utilisez la tâche « list-datasource » pour vérifier que la data source a bien été créée :

Une autre manière 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

Figure 5-7: JDBC Resources

Vous allez maintenant créer les ressources JMS que sont la file d'attente (JMS topic) et la fabrique de connexion (Connection Factory).

Exécutez la tâche « create-jms-connection-factory » pour créer la fabrique de connexion JMS (Connection Factory) « jms/petstoreConnectionFactory » :

Exécutez la tâche « create-jms-topic » pour créer la file d'attente (JMS topic) « jms/topic/order »:

Utilisez la tâche « list-jms-resources » pour énumérer les ressources JMS définies sous GlassFish :

Vous devez vous assurer que la file d’attente « jms/topic/order » et la fabrique de connexion « jms/petstoreConnectionFactory » ont bien été créées.

Une autre manière 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

Figure 5-8: JMS Resources

Les loggers sont utilisés par l’application pour générer des traces (messages d’erreur, informations de debug, audit, etc.).

Exécutez la tâche « set-loggers » pour créer les loggers de chaque composant (petsore, barkbank, petex) :

La console d’administration de GlassFish vous permet de vérifier la présence des loggers.

Rendez-vous à l’emplacement suivant :

                            Application Server ? Logging ? Log Level

La page « Log Levels » présente la section « Additional Properties » dans laquelle sont définis les loggers :

Figure 5-9: Loggers de Yaps

À ce stade, nos environnements GlassFish et Derby sont configurés 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 données Derby et le domaine « petstore ». Ceux-ci seront démarrés en temps voulu sous NetBeans.

Exécutez la tâche Ant « stop-db » pour stopper le serveur de base de données Derby :

Exécutez la tâche Ant « stop-domain » pour stopper le domaine applicatif « petstore » :

Avant de procéder au portage des projets Yaps sous NetBeans, il est nécessaire de configurer l’IDE.

Veuillez démarrer NetBeans comme décrit dans la section 3.2.3.

Vous allez procéder à l’ajout d’un serveur de type GlassFish v2 qui sera lié au domaine « petstore » que vous avez précédemment créé.

Par défaut, le serveur GlassFish v2 défini sous NetBeans est configuré avec le domaine « domain1 ».

Sélectionnez l’onglet « Services » et ensuite un clic droit sur le nœud « Servers » :

Figure 6-1: Liste des Services

Le menu contextuel apparaît et vous permet d’ajouter un nouveau serveur.

Cliquez sur l’option « Add Server… ».

La première étape du wizard consiste à définir 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 définie sous NetBeans.

Cliquez sur « Next » pour continuer.

Dans cette étape, vous allez lier notre domaine « petstore » au serveur « Petstore ».

Sélectionnez l’option « Register Local Default Domain » et ensuite le domaine « petstore » :

Cette étape consiste à identifier le profil de l’administrateur :

Figure 6-4: Paramètres de l'administrateur

Veillez à introduire le mot de passe que vous avez défini plus haut lors de la création du domaine (voir section 5.2).

Cliquez sur le bouton « Finish » pour terminer le processus de création du serveur applicatif.

La liste des serveurs fait maintenant apparaître notre serveur « Petstore » :

Figure 6-5: Liste des serveurs

Avant de démarrer 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 :

Figure 6-6: Afficher les traces

Vous pouvez maintenant démarrer le serveur « Petstore » en sélectionnant l'option « Start » du menu contextuel :

Figure 6-7: Démarrer le serveur

La fenêtre « Output » de NetBeans permet de suivre le processus de démarrage du domaine « petstore » :

Figure 6-8: Fenêtre "Output"

Vous constaterez que la fenêtre « Output » contient deux sous-fenêtres :

•   Petstore: affiche les traces du domaine « petstore »

•   Java DB Database Process: affiche les traces de la base de données Derby

Si l'on explore la sous-fenêtre « Java DB Database Process », on constate que le démarrage du domaine « petstore » a automatiquement démarré le serveur de base de données Derby : 

Figure 6-9: Démarrage automatique de Derby

Une exploration du serveur « Petstore » permet de découvrir les éléments déployés dans le domaine tels que les applications, les ressources JMS ou les ressources JDBC :

Figure 6-11: Exploration du serveur Petstore

L’option « View Admin Console » du menu contextuel du serveur permet d’accéder à la console d’administration :

Figure 6-12: Accès à la console d'administration

NetBeans utilise le browser pour ouvrir la console d’administration : http://localhost:8282

En modifiant les options de NetBeans, il est possible de changer le browser par défaut.

Sélectionnez le menu « Tools ?  Options » :

Figure 6-13: Options de NetBeans

Dans les options générales (General), vous êtes libre d’opter pour un browser et même d’en définir en cliquant sur le bouton « Edit… » :

Figure 6-14: Options du browser

On constate qu’il est notamment possible d’ajouter les définitions d’autres browsers.

Le nœud « Databases » de l’onglet « Services » répertorie les serveurs de base de données et les connexions:

Figure 6-15: Databases sous NetBeans

Vous avons vu que le démarrage du serveur “Petstore” démarrait automatiquement le serveur de base de données Java DB. 

Il peut être utile de démarrer et stopper manuellement le serveur Java DB.

Ces opérations sont accessibles au travers du menu contextuel lié au nœud Java DB :

Figure 6-16: Menu contextuel de Java DB

Pour vérifier les propriétés définies sur un serveur de base de données, sélectionnez l’option « Properties » du menu contextuel :

Figure 6-17: Accès aux propriétés de Java DB

Le menu « Properties » permet d’accéder aux propriétés définies par NetBeans pour le serveur de base de données.

Figure 6-18: Propriétés de Java DB

Les propriétés de Java DB vous apprennent que NetBeans utilise des répertoires autres que ceux attendus par notre configuration.

Pour être conforme à notre déploiement (voir section 5.5.3), vous devez vérifier et modifier le cas échéant les répertoires suivants :

• Java DB Installation :                     %GLASSFISH_HOME%\javadb • Database Location :             %GLASSFISH_HOME%\javadb

Figure 6-19: Modification des propriétés

Appuyez sur le bouton “OK” pour valider la modification.

Bien que la data source et le schéma de la base soit déjà créée, il est possible d’utiliser NetBeans pour consulter et manipuler les données du schéma de la base « petstoreDB ».

Mais à ce stade, le schéma de base de données n’a pas encore été créé. 

Cette opération sera réalisée plus tard lorsque les directives JPA attachées aux Entity auront généré les différentes tables de l’application Yaps.

NetBeans est configuré et prêt à accueillir les projets de l’application Yaps.

Dans la suite du document, nous allons décrire le processus d’importation des projets suivants :

•   BarkBank

•   PetEx

•   Yaps-Server

•   Yaps-Client

Le projet BarkBank est une application Web (« Web Applications ») exposant le Web Service « ValidationService » chargé de simuler le processus de validation des cartes de crédit.

Nous allons décrire les différentes étapes nécessaires pour importer le projet BarkBank de l’application Yaps vers NetBeans.

L’ensemble des opérations qui suivent est réalisé sous NetBeans.

Vous allez créer un nouveau de groupe de projets qui sera spécifique à BarkBank.

Si c’est le cas, il y a d’abord lieu de fermer l’ensemble des projets actuellement ouverts sous NetBeans.

Sélectionnez l’onglet « Projects ». 

Un clic droit fait apparaître le menu contextuel. L’option « Project Group ? (none) » permet de fermer l’ensemble des projets ouverts :

Figure 7-1: Fermer les projets ouverts

Créez un nouveau projet de type « Web Application ».

Pour cela, sélectionnez l'onglet « Project » et créez un nouveau projet via le menu « File  ? New Project ».

Le projet que vous allez créer est de type « Java Web ? Web Application » :

Figure 7-2: Nouveau projet Web Application Cliquez sur le bouton « Next » pour continuer.

L'écran suivant vous permet de nommer le projet, et de définir le dossier cible:

Figure 7-3: Nom du projet et répertoire Les informations à introduire sont les suivantes:

Cliquez sur le bouton « Next » pour continuer.

Cette étape vous permet d’identifier le serveur d’applications « PetStore » (voir section 6.1) sur lequel sera déployée l’application BarkBank :

Figure 7-4: Configuration du serveur La configuration utilisée pour le déploiement est la suivante :

Cliquez sur le bouton « Next » pour continuer.

La dernière étape consiste à spécifier les frameworks à utiliser.

Dans le cadre du projet « BarkBank », aucun framework spécifique n’est employé :

Figure 7-5: Frameworks

Appuyez sur le bouton « Finish » pour terminer le processus de création du projet.

Le projet est maintenant généré et présente l’ensemble des dossiers suivants :

Figure 7-6: Dossiers du projet

Vous êtes prêt à importer le code source du projet BarkBank de l’application Yaps vers l’arborescence de NetBeans.

L’opération de transfert du projet BarkBank consiste à copier les fichiers de l’application Yaps vers l’application YapsON.

Pour faciliter cette opération, le script Ant « » (décrit dans la section 3.5) automatise la copie des fichiers.

Assurez-vous d’avoir configuré le fichier « yapson.properties » tel que décrit dans la section 4.

Les commandes que vous allez exécuter nécessitent de positionner les variables d’environnement pour l’exécution des tâches Ant.

Rendez-vous dans le répertoire de l’application YapsON et exécutez le fichier de commande « » :

À partir de la ligne de commande, exécutez la tâche « transferBarkBank » chargée de transférer le projet sous NetBeans :

L'exécution du script Ant commence par demander une confirmation avant de procéder au remplacement des fichiers : 

Dans l’affirmative, la tâche Ant copie respectivement les codes sources Java, les fichiers de ressources Web et les descripteurs :

NetBeans rafraîchit automatiquement le projet BarkBank :

Figure 7-7: Projet BarkBank après le transfert

NetBeans offre la possibilité de créer des groupes de projets pour faciliter le passage d'un projet à l'autre sans avoir à redémarrer l'IDE.

À partir du menu « File » ou via un clic droit dans la fenêtre « Projects », NetBeans offre la capacité de créer le nouveau groupe de projet:

Figure 7-8: Créer un groupe de projet

Sélectionnez l’option « New group ».

La fenêtre suivante permet de nommer le groupe de projet qui est dans notre cas BarkBank :

Figure 7-9: Nouveau groupe de projet

Les options par défaut indiquent que les projets en cours de chargement dans l’IDE seront automatiquement ajoutés au groupe de projet BarkBank.

Cliquez sur le bouton « Create Group ».

Un clic droit sur le projet fait apparaître le menu contextuel proposant les options pour compiler le projet (« Build » ou « Clean and Build ») :

Figure 7-10: Compiler le projet

Cliquez sur l’option « Clean and Build ».

Le fenêtre « Output » affiche les traces de la compilation :

Figure 7-11: Résultat de la compilation Les messages intéressants sont les suivants :

Ces traces indiquent que le projet a été correctement compilé (« BUILD SUCCESSFUL ») et archivé dans le fichier « ».

Vous allez maintenant procéder au déploiement du projet sous GlassFish.

Un clic droit sur le projet fait apparaître le menu contextuel proposant l’option de déploiement (« Deploy ») :

Figure 7-12: Déployer le projet

Cliquez sur l’option « Deploy ».

Si nécessaire, NetBeans se charge de démarrer le serveur d’applications « PetStore ».

Si l’application BarkBank était déjà déployée sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version.

La fenêtre « Output » trace les messages suivants :

Le déploiement terminé, vous pouvez explorer le contenu de l’application BarkBank sur le serveur PetStore.

Rendez-vous sur l’onglet “Services” et sélectionnez le serveur “Petstore”.

Le nœud « Applications ?  Web Applications ? BarkBank » affiche les ressources et services exposés par l’application :

Figure 7-13: Application BarkBank sous GlassFish

L’application BarkBank est accessible à l'adresse http://localhost:8080/barkbank et se présente comme suit:

Figure 7-14: Page d’accueil de BarkBank

À ce stade, vous pouvez inspecter le WSDL ou tester le service tel que décrit dans le livre de référence.

Vous êtes maintenant en mesure de tester l’application BarkBank en invoquant le Web Service « ValidationService ».

Un Web Service peut être testé de différentes manières. Nous allons ici nous contenter de quelques unes d’entre elles disponibles sous NetBeans.

Au travers de la fenêtre « Projects », un clic droit sur le Web Service « Validation » propose le menu contextuel suivant: 

Figure 7-15: Tester le Web Service

L'option « Test Web Service » invoque le mécanisme 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 mécanisme est largement décrit dans le livre de référence.

Cette méthode consiste à enregistrer le Web Service sous NetBeans afin de bénéficier d’un outil de test un peu plus évolué que celui offert par GlassFish.

Les Web Services sont répertoriés dans la fenêtre « Services » sous le nœud « Web Service » :

Figure 7-16: Liste des Web Services sous NetBeans Pour ajouter un Web Service, procédez comme suit.

Vous devez avant tout créer un groupe dans lequel seront stockés les Web Service du projet YapsON.

Un click droit sur le noeud « Web Services » propose un menu contextuel dans lequel vous allez créer le groupe « YapsON » par l’option « Create Group » :

Figure 7-17: Groupe de Web Services

Figure 7-18: Ajout du groupe de Web Service

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

Figure 7-19: Ajout d'un Web Service

Le formulaire permet d'identifier le Web Service à partir de son WSDL:

Figure 7-20: Localiser le 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 référence du Web Service sous NetBeans.

Le Web Service « ValidationService » est maintenant ajouté à la liste des Web Service :

Figure 7-21: Référence de ValidationService

Un clic droit sur l'opération « ValidateCard » permet de tester la méthode au travers de l’écran suivant :

Figure 7-22: Écran de test du Web Service

La partie supérieure concerne la requête à émettre tandis que la partie inférieure se charge d’afficher le message de retour. Le bouton « Submit » permet d’envoyer la requête au Web Service.

Testez le Web Service avec les données suivantes:

Figure 7-23: Requête de test

Cliquez sur le bouton « Submit » pour envoyer la requête au Web Service « ValidationService ».

Les données sont considérées comme valides par le service et le résultat est un message « OK » :

Figure 7-24: Message de retour

Si l'on omet par exemple la date d'expiration, le Web Service retourne un message d'erreur explicite composé par l’application BarkBank :

Figure 7-25: Message d'erreur

Les sources de l’application BarkBank ont été transférées sous NetBeans dans une arborescence conforme au format préconisé par le Java Blueprints.

Les tests que nous avons réalisés attestent que le Web Service de l'application BarkBank a été correctement compilé et est déployé sur le serveur.

Le projet PetEx est une application Web (« Web Applications ») exposant le Web Service « DeliveryService » chargé de simuler le processus de transport des marchandises achetées en ligne.

Nous allons décrire les différentes étapes nécessaires 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 opérations qui suivent est réalisé sous NetBeans.

Vous allez créer un nouveau de groupe de projets qui sera spécifique à PetEx.

Si c’est le cas, il y a d’abord lieu de fermer l’ensemble des projets actuellement ouverts sous NetBeans.

Sélectionnez l’onglet « Projects ». 

Un clic droit fait apparaître le menu contextuel. L’option « Project Group ? (none) » permet de fermer l’ensemble des projets ouverts :

Figure 8-1: Fermer les projets ouverts

Créez un nouveau projet de type « Web Application ».

Pour cela, sélectionnez l'onglet « Project » et créez un nouveau projet via le menu « File  ? New Project ».

Le projet que vous allez créer est de type « Java Web ? Web Application » :

Figure 8-2: Nouveau projet Web Application Cliquez sur le bouton « Next » pour continuer.

L'écran suivant vous permet de nommer le projet, et de définir le dossier cible:

Figure 8-3: Nom du projet et répertoire Les informations à introduire sont les suivantes:

Cliquez sur le bouton « Next » pour continuer.

Cette étape vous permet d’identifier le serveur d’applications « PetStore » (voir section 6.1) sur lequel sera déployée l’application PetEx :

Figure 8-4: Configuration du serveur La configuration utilisée pour le déploiement est la suivante :

Cliquez sur le bouton « Next » pour continuer.

La dernière étape consiste à spécifier les frameworks à utiliser.

Dans le cadre du projet « PetEx », aucun framework spécifique n’est employé :

Figure 8-5: Frameworks

Appuyez sur le bouton « Finish » pour terminer le processus de création du projet.

Le projet est maintenant généré et présente l’ensemble des dossiers suivants :

Figure 8-6: Dossiers du projet

Vous êtes prêt à importer le code source du projet PetEx de l’application Yaps vers l’arborescence de NetBeans.

L’opération de transfert du projet PetEx consiste à copier les fichiers de l’application Yaps vers l’application YapsON.

Pour faciliter cette opération, le script Ant « » (décrit dans la section 3.5) automatise la copie des fichiers.

Assurez-vous d’avoir configuré le fichier « yapson.properties » tel que décrit dans la section 4.

Les commandes que vous allez exécuter nécessitent de positionner les variables d’environnement pour l’exécution des tâches Ant.

Rendez-vous dans le répertoire de l’application YapsON et exécutez le fichier de commande « » :

À partir de la ligne de commande, exécutez la tâche Ant « transferPetEx » chargée de transférer le projet sous NetBeans :

L'exécution du script Ant commence par demander une confirmation à l'utilisateur avant de procéder au remplacement des fichiers : 

Dans l’affirmative, la tâche Ant copie respectivement les codes sources Java, les fichiers de ressources Web et les descripteurs :

NetBeans rafraîchit automatiquement le projet PetEx :

Figure 8-7: Projet PetEx après le transfert

À partir du menu « File » ou via un clic droit dans la fenêtre « Projects », NetBeans offre la capacité de créer le nouveau groupe de projet:

Figure 8-8: Créer un groupe de projet

Sélectionnez l’option « New group ».

La fenêtre suivante permet de nommer le groupe de projet qui est dans notre cas PetEx :

Figure 8-9: Nouveau groupe de projet

Les options par défaut indiquent que les projets en cours de chargement dans l’IDE seront automatiquement ajoutés au groupe de projet PetEx.

Cliquez sur le bouton « Create Group ».

Un clic droit sur le projet fait apparaître le menu contextuel proposant les options pour compiler le projet (« Build » ou « Clean and Build ») :

Figure 8-10: Compiler le projet

Cliquez sur l’option « Clean and Build ».

La fenêtre « Output » affiche les traces de la compilation :

Figure 8-11: Résultat de la compilation Les messages intéressants sont les suivants :

Ces traces indiquent que le projet a été correctement compilé (« BUILD SUCCESSFUL ») et archivé dans le fichier « ».

Vous allez maintenant procéder au déploiement du projet sous GlassFish.

Un clic droit sur le projet fait apparaître le menu contextuel proposant l’option de déploiement (« Deploy ») :

Figure 8-12: Déployer le projet

Cliquez sur l’option « Deploy ».

Si nécessaire, NetBeans se charge de démarrer le serveur d’applications « PetStore ».

Si l’application PetEx était déjà déployée sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version.

La fenêtre « Output » trace les messages suivants :

Le déploiement terminé, vous pouvez explorer le contenu de l’application PetEx sur le serveur PetStore.

Rendez-vous sur l’onglet “Services” et sélectionnez le serveur “Petstore”.

Le nœud « Applications ?  Web Applications ?  PetEx» affiche les ressources et services exposés par l’application :

Figure 8-13: Application PetEx sous GlassFish

L’application PetEx est accessible à l'adresse http://localhost:8080/petex et se présente comme suit:

Figure 8-14: Page d’accueil de PetEx

À ce stade, vous pouvez inspecter le WSDL ou tester le service tel que décrit dans le livre de référence.

Nous sommes maintenant en mesure de tester l’application PetEx en invoquant le Web Service « DeliveryService ».

Un Web Service peut être testé de différentes manières. Nous allons ici nous contenter de quelques unes d’entre elles disponibles sous NetBeans.

Au travers de la fenêtre « Projects », un clic droit sur le Web Service « Delivery » propose le menu contextuel suivant: 

Figure 8-15: Tester le Web Service

L'option « Test Web Service » invoque le mécanisme 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 mécanique de test n’est pas vraiment appropriée pour tester le Web Service

« DeliveryService ». La raison est que la requête à transmettre contient un message complexe.

Cette méthode consiste à enregistrer le Web Service sous NetBeans afin de bénéficier d’un outil de test un peu plus évolué que celui offert par GlassFish.

Les Web Services sont répertoriés dans la fenêtre « Services » sous le nœud « Web Service » :

Figure 8-16: Liste des Web Services sous NetBeans

Le groupe de Web Service « YapsON » a déjà été créé précédemment.

Nous allons nous concentrer sur l’ajout de la référence 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:

Figure 8-17: Ajout d'un Web Service

Le formulaire permet d'identifier le Web Service à partir de son WSDL:

Figure 8-18: Localiser le 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 référence au Web Service sous NetBeans.

Le Web Service « DeliveryService » est maintenant ajouté à la liste des Web Service :

Figure 8-19: Référence de DeliveryService

Un clic droit sur l'opération « deliveryItems » permet de tester la méthode au travers de l’écran suivant :

Figure 8-20: Écran de test du Web Service

La partie supérieure concerne la requête à émettre tandis que la partie inférieure se charge d’afficher le message de retour. Le bouton « Submit » permet d’envoyer la requête au Web Service.

Testez le Web Service avec les données suivantes:

Figure 8-21: Requête de test

Cliquez sur le bouton « Submit » pour envoyer la requête au Web Service « DeliveryService ».

La réponse retournée par le Web Service est vide :

Figure 8-22: Message de réponse

En effet, le code de retour du Web Service « DeliveryService » est de type « void ». 

Par contre, le Web Service trace la requête en utilisant le « logger » applicatif défini pour « com.petex.transport ».

Si l’on se reporte sur la fenêtre « Output » et en particulier sur les traces générées par le serveur « Petstore », on retrouvera les traces suivantes :

Ces traces montrent que le Web Service a bien reçu le message de requête.

Les sources de l’application « PetEx » ont été transférées sous NetBeans dans une arborescence conforme au format préconisé par le Java Blueprints.

Les tests que nous avons réalisés attestent que le Web Service de l'application PetEx a été correctement compilé et est déployé sur le serveur.

Le projet Yaps-Server est une application de type « Enterprise Applications » qui a pour fonction d’héberger 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 opérations qui suivent est réalisé sous NetBeans.

Vous allez créer un nouveau de groupe de projets qui sera spécifique à Yaps-Server.

Si c’est le cas, il y a d’abord lieu de fermer l’ensemble des projets actuellement ouverts sous NetBeans.

Sélectionnez l’onglet « Projects ». 

Un clic droit fait apparaître le menu contextuel. L’option « Project Group ? (none) » permet de fermer l’ensemble des projets ouverts :

Figure 9-1: Fermer les projets ouverts

Créez un nouveau projet de type Enterprise Application ».

Pour cela, sélectionnez l'onglet « Project » et créez un nouveau projet via le menu « File  ? New Project ».

Le projet que vous allez créer est de type « Java EE > Enterprise Application » :

Figure 9-2: Nouveau projet Enterprise Application Cliquez sur le bouton « Next » pour continuer.

L'écran suivant vous permet de nommer le projet, et de définir le dossier cible:

Figure 9-3: Nom du projet et répertoire

Les informations à introduire sont les suivantes:

Cliquez sur le bouton « Next » pour continuer.

Cette étape vous permet d’identifier le serveur d’applications « PetStore » (voir section 6.1) sur lequel sera déployée l’application PetEx ainsi que les modules (EJB et Web) associés au projet:

Figure 9-4: Server settings La configuration utilisée pour le déploiement est la suivante :

Cliquez sur le bouton « Finish » pour terminer le processus de création du projet.

Le projet est maintenant généré et présente l’ensemble des dossiers suivants :

Figure 9-5: Dossiers du projet

Vous êtes prêt à importer le code source du projet Yaps (côté serveur) de l’application Yaps vers l’arborescence de NetBeans.

L’opération de transfert du projet Yaps consiste à copier les fichiers de la partie serveur de l’application Yaps vers l’application YapsON.

Pour faciliter cette opération, le script Ant « » (décrit dans la section 3.5) automatise la copie des fichiers.

Assurez-vous d’avoir configuré le fichier « yapson.properties » tel que décrit dans la section 4.

Les commandes que vous allez exécuter nécessitent de positionner les variables d’environnement pour l’exécution des tâches Ant.

Rendez-vous dans le répertoire de l’application YapsON et exécutez le fichier de commande « » :

À partir de la ligne de commande, exécutez la tâche Ant « transferYapsServer » chargée de transférer le projet sous NetBeans :

L'exécution du script Ant commence par demander une confirmation à l'utilisateur avant de procéder au remplacement des fichiers : 

La tâche Ant copie ensuite les éléments requis pour le module « Yaps-Server-ejb » : 

Ensuite, les ressources nécessaires pour le module “Yaps-Server-war” sont transférées :

Pour terminer, les ressources utilitaires sont transférées (dans notre cas le fichier SQL contenant les données de test) :

NetBeans rafraîchit automatiquement le projet Yaps-Server :

Figure 9-6: Projet Yaps-Server après le transfert

Des erreurs apparaissent dans les modules “Yaps-Server-ejb » et « Yaps-Server-war ».

La cause de ces erreurs est que les références des Web Service des projets « BarkBank » et « PetEx » sont manquantes.

Dans le module « Yaps-Server-ejb », la classe « OrderBean » injecte la référence 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 apparaître le menu contextuel dans lequel vous devez sélectionner l’option « New ? Web Service Client » : 

Figure 9-9: Ajout d'un client Web Service

L’écran suivant vous demande de localiser le WSDL du Web Service :

Figure 9-10: Localisation du WSDL

Dans notre cas, vous devez fournir l’URL du WSDL relatif à l’application PetEx:

http://localhost:8080/petex/DeliveryService?WSDL

Cliquer sur « Finish » pour générer le code du Proxy client du Web Service.

À la fin du processus de génération, le dossier « Web Service References » est ajouté au module « Yaps-Server-ejb » et contient le Proxy client du Web Service :

Figure 9-11: Proxy client de DeliveryService

NetBeans va ensuite automatiquement rafraîchir le projet et faire disparaître les erreurs de références repérées dans la classe « OrderBean ».

Dans le module « Yaps-Server-war », la classe « ShoppingCartController » injecte la référence 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 apparaître le menu contextuel dans vous devez sélectionner l’option « New ? Web Service Client » : 

Figure 9-12: Ajout d'un client Web Service

L’écran suivant vous demande de localiser le WSDL du Web Service :

Figure 9-13: Localisation du WSDL

Dans notre cas, vous devez fournir l’URL du WSDL relatif à l’application BarkBank:

http://localhost:8080/barkbank/ValidationService?WSDL

Cliquer sur « Finish » pour générer le code du Proxy client du Web Service.

À la fin du processus de génération, le dossier « Web Service References » est ajouté au module « Yaps-Server-war » et contient le Proxy client du Web Service :

Figure 9-14: Proxy client de ValidationService

NetBeans va ensuite automatiquement rafraîchir le projet et faire disparaître les erreurs de références repérées dans la classe « ShoppingCartController ».

À partir du menu « File » ou via un clic droit dans la fenêtre « Projects », NetBeans offre la capacité de créer le nouveau groupe de projet:

Figure 9-15: Créer un groupe de projet

Sélectionnez l’option « New group ».

La fenêtre suivante permet de nommer le groupe de projet qui est dans notre cas Yaps-Server :

Figure 9-16: Nouveau groupe de projet

Les options par défaut indiquent que les projets en cours de chargement dans l’IDE seront automatiquement ajoutés au groupe de projet.

Cliquez sur le bouton « Create Group ».

Pour être conforme au livre de référence, vous allez changer le Context Root de l’application Web qui a été défini par défaut dans le module « Yaps-Server-war ».

Le Context Root est défini dans le fichier de déploiement « » qui se trouve sous :

Yaps-Server-war ? Configuration Files ?

Figure 9-17: Fichier de déploiement « »

Le fichier « » est le descripteur de déploiement Web pour SUN GlassFish.

Éditez ce fichier et modifiez l’entrée « Context Root » pour y placer la valeur « /petstore »:

Figure 9-18: Modification du context root

Avant de déployer l’application, il vous reste à générer le fichier de déploiement standard « ».

Pour cela, un clic droit sur le projet « Yaps-Server » propose le menu contextuel suivant dans lequel vous allez pouvoir ajouter le descripteur de déploiement standard (Standard Deployment Descriptor) :

Figure 9-19: Ajouter le fichier « »

L’écran suivant apparaît précisant où résidera le fichier de déploiement :

Figure 9-20: Localisation du fichier « »

Cliquez sur « Finish » pour générer le fichier de déploiement.

Le fichier « » est généré et associé au projet :

Figure 9-21: Fichier « »

Si l’on consulte le fichier « », on constate que la section « web » du fichier met en relation l’URI du projet Web (« ») avec le Context Root « /petstore » que vous avez défini précédemment.

Un clic droit sur le projet fait apparaître le menu contextuel proposant les options pour compiler le projet (« Build » ou « Clean and Build ») :

Figure 9-22: Compiler le projet

Cliquez sur l’option « Clean and Build ».

La fenêtre « Output » affiche les traces de la compilation :

Figure 9-23: Résultat de la compilation

Les messages intéressants sont les suivants :

Ces traces indiquent que les modules ont été correctement compilés de même que l’archive de type EAR.

Vous allez maintenant procéder au déploiement du projet sous GlassFish.

Un clic droit sur le projet fait apparaître le menu contextuel proposant l’option de déploiement (« Deploy ») :

Figure 9-24: Déployer le projet

Cliquez sur l’option « Deploy ».

Si nécessaire, NetBeans se charge de démarrer le serveur d’applications « PetStore ».

Si l’application Yaps-Server était déjà déployée sur le serveur, NetBeans se charge de la supprimer (Undeploying) pour la remplacer par la nouvelle version.

La fenêtre « Output » trace les messages suivants :

Le déploiement terminé, vous pouvez explorer le contenu de l’application Yaps-Server sur le serveur PetStore.

Rendez-vous sur l’onglet “Services” et sélectionnez le serveur “Petstore”.

Le nœud « Applications ?  Enterprise Applications ? Yaps-Server » affiche les ressources et services exposés par l’application :

Figure 9-25: Application Yaps-Server sous GlassFish

Le déploiement de l’application Yaps-Server a eu pour effet de supprimer et de créer les tables de la base de données « petstoreDB ».

Ces opérations sont réalisées par le biais d’annotations JPA apposées dans les différentes Entity.

Dans cette section, nous allons montrer comment - au travers de NetBeans - accéder à la structure et aux données de la base de données « petstoreDB ».

La première étape consiste à créer une connexion vers la base de données.

Sélectionnez l’onglet « Services » et ensuite un clic droit sur « Databases ».

Le menu contextuel suivant apparaît offrant la possibilité de créer une nouvelle connexion :

Figure 9-26: Nouvelle connexion DB

Cliquez sur « New Connection ».

L’écran suivant apparaît dans lequel vous allez identifier les propriétés de la base de données « petstoreDB » :

Figure 9-27: Nouvelle connexion DB

Dans le formulaire, introduisez les informations suivantes :

Cliquez sur le bouton « OK » pour créer la connexion.

Avant de fermer la fenêtre, NetBeans peut vous demander de préciser le schéma de la base de données :

Figure 9-28: Choix du schéma de la DB

Veuillez préciser « DBUSER » et cliquez ensuite sur « OK ».

Le nœud « Databases » présente la nouvelle connexion

Figure 9-29: Connexion vers petstoreDB

Chaque connexion est préfixée par une icône qui précise un statut :

•   Une connexion DB est en cours  

•   Pas de connexion DB  

Un clic droit sur la connexion fait apparaître le menu contextuel par lequel vous pouvez vous connecter à la base de données :

Figure 9-30: Connexion à la DB

Cliquez sur « Connect » pour vous connecter à la base de données.

Le système vous demande d’introduire le mot de passe :

Figure 9-31: mode de passe de la DB

En cochant l’option « Remember password », le mot de passe ne vous sera plus demandé.

Vous êtes maintenant connecté à la base de données :

Figure 9-32: Base de données connectée à NetBeans

Les nœuds de la connexion peuvent être ouverts pour explorer la structure de la base de données « petstoreDB » :

Figure 9-33: Structure de petstoreDB

Un clic droit sur une table fait apparaître le menu contextuel qui permet de visualiser le contenu de la table ou d’altérer sa structure :

Figure 9-34: Opérations sur la table

Si vous cliquez sur l’option « View Data », une fenêtre apparaît et vous donnez la possibilité d’exécuter des requêtes de type SQL et obtenir le résultat de la requête :

Figure 9-35: Option "View Data"

Vous constaterez que les tables de la base de données sont vides.

Nous allons maintenant présenter les méthodes pour charger les données de test de livrées avec le projet Yaps original.

Dans le fichier « » du projet original Yaps, la tâche « db-insert-data » insère des données de test dans la base de données.

Ce processus d’insertion des données de test est exécuté à chaque déploiement de l’application.

Durant la phase de transfert (voir section 9.2.2), les données de test ont été transférées à l’emplacement suivant :

{yapson_home}\Yaps-Server\

Nous allons montrer deux méthodes que l’on peut utiliser sous NetBeans pour charger ces données de test.

Cette méthode décrit comment charger manuellement les données de test dans la base de données en utilisant les opérations offertes dans le service « Database ».

Un clic droit sur le nœud « Table » de la base de données « petstoreDB » présente le menu contextuel suivant :

Figure 9-36: Exécuter une commande SQL

Sélectionnez l’option « Execute Command ».

Copiez le contenu du fichier « » pour le coller dans la fenêtre de commande :

Figure 9-37: Fenêtre de commande SQL

Exécutez les requêtes SQL en cliquant sur l’icône  de la toolbar.

La fenêtre « Output » trace le résultat de chaque requête SQL.

Vous pouvez maintenant visualiser le contenu de chaque table en invoquant l’option « View Data » décrite plus haut.

Par exemple, nous obtenons le résultat suivant pour la table « CUSTOMER » :

Figure 9-38: Contenu de la table "CUSTOMER"

On se rend vite compte que le chargement manuel est quelque peu contraignant, car il vous oblige à répéter les opérations de chargement après chaque déploiement de l’application.

Nous allons montrer une autre méthode qui automatise le processus de chargement des données de test.

Cette seconde méthode est beaucoup plus élégante, car elle automatise le chargement des données de test conformément au projet original Yaps.

En inspectant les fichiers de projet Netbeans, vous aurez compris que NetBeans utilise Ant pour compiler et déployer les applications.

NetBeans offre la possibilité de personnaliser le processus de construction et de déploiement des applications en offrant au développeur la liberté de modifier le fichier « » du projet afin d’exploiter les targets Ant suivants :

Nous allons enrichir le processus de construction de l’application Yaps-Server afin d’y insérer une tâche pour ajouter les données de test dans la base de données petstoreDB.

Le fichier « » va être enrichi afin d’insérer les données de test après chaque déploiement de l’application (post-run-deploy).

Sélectionnez l’onglet « Files » et ouvrez le nœud du projet Yaps-Server :

Figure 9-40: Fichiers du projet Yaps-Server

Vous constatez la présence du fichier « » qui a été transféré du projet original.

Vous allez créer le script Ant « » qui sera utilisé pour charger les données de test.

Sélectionnez le dossier « yaps-Server.

Un clic droit affiche le menu contextuel suivant dans lequel vous allez sélectionner l’option « New ? Other » :

Figure 9-41; Création d'un nouveau fichier

Pour créer un fichier de type Ant, vous allez choisir l’option « Other ? Ant Build Script» :

Figure 9-42: Type de fichier « Ant Build Script » Cliquez sur « Next » pour poursuivre.

Ensuite, entrez le nom du fichier qui sera dans notre cas « » :

Figure 9-43: Nom du fichier Ant

Cliquez sur « Finish » pour terminer le processus.

Le fichier « » s’ouvre maintenant dans l’éditeur de NetBeans pour vous permettre de le compléter :

Figure 9-44: Fichier

Nous fournissons ci-dessous le contenu à appliquer au fichier « » :

Nous allons décrire le fichier Ant.

Le script Ant « Yaps-Data » commence par définir un ensemble de propriétés pour identifier :

•   Database properties : les propriétés de la base de données « petstoreDB ».

•   Derby Library location: le chemin vers les librairies de Derby.

•   Classpath : la librairie Derby nécessaire pour importer les données.

Ensuite, la cible « load-data » fournit la tâche SQL utilisée pour charger les données dans la base de données « petstoreDB » à partir du fichier « ». Sauvez les modifications et vérifiez la structure XML du fichier. 

Pour cela, un clic droit dans le fichier fait apparaître le menu contextuel offrant l’option « Check XML » :

Figure 9-45: Vérifier le fichier XML

Maintenant, vous allez modifier le fichier « » du projet « Yaps-Server » pour invoquer le script Ant « » après la phase de déploiement du projet.

Toujours à partir de l’onglet « Files », ouvrez le fichier « » du projet « YapsServer » :

Figure 9-46: Fichier « » de Yaps-Server

L’objectif étant d’insérer les données de test après le déploiement du projet, vous allez ajouter la target Ant « post-run-deploy » dans le fichier « » :

La target « post-run-deploy » se charge d’invoquer la cible « load-data » du fichier « ».

Pour vérifier le bon déroulement du processus, l’instruction « echo » permet d’afficher une trace sur la console.

Vérifiez la structure du fichier en invoquant l’option « Check XML » comme décrite précédemment.

Sauvez vos modifications.

Si vous déployez le projet comme décrit plus haut (voir section 9.6), vous verrez apparaître la trace suivante sur la console :

Ces informations indiquent que 91 requêtes SQL du fichier « » ont été exécutées durant la phase « post-run-deploy ».

Avec cette méthode, les données de tests seront automatiquement injectées dans la base de données à chaque déploiement du projet « Yaps-Server ».

Le test du projet est largement décrit dans le livre de référence.

On rappellera que l’application Web est accessible à l’adresse suivante :

http://localhost:8080/petstore

Figure 9-47: Page web de l'application

N’oubliez pas de créer un compte utilisateur afin de pouvoir valider le comportement de l’application :

•   Ajout d’articles dans le panier.

•   Création et envoi d’un bon de commande.

•   Réception d’un email de confirmation.

•   Messages de trace produits sur le serveur et mentionnant la réception 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 invoqués.

Les sources du serveur de l’application « Yaps» ont été transférées sous NetBeans dans une arborescence conforme au format préconisé par le Java Blueprints.

Les tests que nous avons réalisés attestent que l’application Web, la logique métier et les Web Services communiquent correctement ensemble.

Le projet YAPS Pet Store est composé de deux interfaces clientes. L’une dite légère et composée d’une interface Web (JSF) et l’autre dite lourde (Java Swing).

Comme nous l’avons vu (voir section 9), le client « léger » de type Web est déployé avec les composants du serveur de l’application Yaps.

Nous allons décrire le processus d’importation du client « lourd » (Java Swing) sous le projet de type « Java Applications » baptisé Yaps-Client.

L’ensemble des opérations qui suivent est réalisé sous NetBeans.

Vous allez créer un nouveau de groupe de projets qui sera spécifique à Yaps-Client.

Si c’est le cas, il y a d’abord lieu de fermer l’ensemble des projets actuellement ouverts sous NetBeans.

Sélectionnez l’onglet « Projects ». 

Un clic droit fait apparaître le menu contextuel. L’option « Project Group ? (none) » permet de fermer l’ensemble des projets ouverts :

Figure 10-1: Fermer les projets ouverts

Créez un nouveau projet de type « Java Application ».

Pour cela, sélectionnez l'onglet « Project » et créez un nouveau projet via le menu « File  ? New Project ».

Le projet que vous allez créer est de type « Java > Java Application » :

Figure 10-2: Nouveau projet Java Application Cliquez sur le bouton « Next » pour continuer.

L'écran suivant nous permet de nommer le projet, et de définir le dossier cible :

Figure 10-3: Nom du projet et répertoire

Les informations à introduire sont les suivantes :

Il n’est pas nécessaire de cocher l’option « Create Main Class », car nous allons importer nos propres codes sources.

Cliquez sur le bouton « Finish » pour terminer le processus.

Le projet est maintenant généré et présente l’ensemble des dossiers suivants :

Figure 10-4: Dossiers du projet

Vous êtes prêt à importer le code source du projet Yaps (côté client) de l’application Yaps vers l’arborescence de NetBeans.

L’opération de transfert du projet Yaps consiste à copier les fichiers de la partie serveur de l’application Yaps vers l’application YapsON.

Pour faciliter cette opération, le script Ant « » (décrit dans la section 3.5) automatise la copie des fichiers.

Assurez-vous d’avoir configuré le fichier « yapson.properties » tel que décrit dans la section 4.

Les commandes que vous allez exécuter nécessitent de positionner les variables d’environnement pour l’exécution des tâches Ant.

Rendez-vous dans le répertoire de l’application YapsON et exécutez le fichier de commande « » :

À partir de la ligne de commande, exécutez la tâche Ant « transferYapsClient » chargée de transférer le projet sous NetBeans :

L'exécution du script ANT commence par demander une confirmation à l'utilisateur avant de procéder au remplacement des fichiers : 

La tâche Ant copie code source Java du projet : 

Pour terminer, les librairies sont copiées dans un répertoire spécifique :

NetBeans rafraîchit automatiquement le projet Yaps-Client :

Figure 10-5: Projet Yaps-Client après le transfert

Comme on peut le constater, des erreurs apparaissent dans le code source du projet.

Ces erreurs sont causées 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 références à ces libraires se réalisent en modifiant les propriétés du projet.

Nous allons décrire comment référencer chacune de ces libraires ainsi que la manière de créer certaines d’entre elles sous NetBeans.

L’application Yaps-Client référence un ensemble de classes définies dans le projet Yaps-Server : entity, stateless, util, exception.

Vous allez ajouter la référence à la librairie contenant les classes construites dans le cadre de l’application Yaps-Server et plus spécifiquement les classes du module Yaps-Server-ejb.

Un clic droit sur le projet Yaps-Client fait apparaître le menu contextuel dans lequel vous allez activer l’option Properties :

Figure 10-6: Menu propriétés

Dans l’écran des propriétés du projet, sélectionnez la catégorie Libraries :

Figure 10-7: Librairies

Dans la partie de droite, cliquez sur le bouton « Add JAR/Folder ».

La boîte de dialogue permet de sélectionner la librairie à référencer dans le projet.

Dans notre cas, vous devez retrouver la librairie qui se trouve sous le répertoire Build du projet Yaps-Server :

{yapson_home}\build\

Figure 10-8: Librairie de Yaps-Server-ejb

À ce stade, les librairies référencées dans le projet sont les suivantes :

Figure 10-9: Liste des libraires

Cliquez sur « OK » afin d’ajouter la référence de la libraire au projet.

En consultant le projet, on constate la disparition des erreurs relatives au référencement des classes du projet Yaps-Server.

En utilisant la méthode décrite précédemment, vous allez référencer les deux librairies utilitaires transférées du projet Yaps.

Ces deux librairies sont localisées sous le répertoire suivant :

{yapson_home}\Tools\Libs\ {yapson_home}\Tools\Libs\

Figure 10-10: Librairies utilitaires

À ce stade, les librairies référencées dans le projet sont les suivantes:

Figure 10-11: Liste des librairies

Cliquez sur « OK » afin d’ajouter la référence des libraires au projet.

En consultant le projet, on constate la disparition des erreurs relatives au référencement des classes d’Apache Commons et du framework XSwing.

L’application cliente met en œuvre un MessageListener JMS pour être à l’écoute de la file de messages.

Il est donc nécessaire de référencer 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 références aux libraires JMS livrées avec Sun GlassFish.

Sous NetBeans, sélectionnez le menu « Tools > Libraries » :

Figure 10-12: Menu Libraries

L’écran suivant montre l’ensemble des librairies définies sous NetBeans :

Figure 10-13: Librairies 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 sélectionnée.

En utilisant le bouton « Add Jar/Folder », vous allez ajouter l’ensemble des fichiers suivants localisés sous le répertoire de Sun GlassFish :

1.   {glassfish-home}

2.   {glassfish-home}

3.   {glassfish-home}

4.   {glassfish-home}

5.   {glassfish-home}

Figure 10-14: Liste des fichiers pour JMS

Les boutons « Move Up » et « Move Down » permettent d’agencer l’ordre des fichiers tel que nous l’avons décrit plus haut.

Cliquez sur le bouton OK pour appliquer vos modifications.

Maintenant que la librairie JMS est prête à l’emploi, vous allez ajouter sa référence au projet Yaps-Client.

Ouvrez les propriétés du projet Yaps-Client et sélectionnez la catégorie « Libraries » :

Figure 10-15: Propriés du projet

Cliquez sur le bouton « Add Library » :

Figure 10-16: Référence à la librairie JMS

Dans la liste des librairies, sélectionnez « JMS » et cliquez sur le bouton « Add Library » :

Figure 10-17: Librairie JMS dans le projet

Cliquez sur « OK ».

La librairie JMS est maintenant référencée dans le projet Yaps-Client.

NetBeans va automatiquement compiler le projet et résoudre les références manquantes.

À ce stade, plus aucune erreur ne doit être détectée dans le projet :

Figure 10-18: Résolution des problèmes

Durant la phase d’exécution du l’application Yaps-Client, des objets de type Entity sont manipulés pour lesquelles les classes du framework TopLink sont requises.

Vous allez référencer les classes du framework TopLink pour éviter les erreurs d’exécution.

Ouvrez les propriétés du projet et sélectionnez la catégorie « Libraries » :

Figure 10-19: Librairies du projet

Cliquez sur le bouton “Add Library” et sélectionnez la librairie TopLink Essentials :

Figure 10-20: Libraire TopLink Essentials

Cliquez sur « Add Library ».

Cliquez ensuite sur OK afin d’ajouter la référence de la libraire TopLink :

Figure 10-21: Référence à TopLink Essentials

Avant de tester l’application, il vous reste à localiser la classe principale « Main Class » qui sera invoquée à l’exécution.

Ouvrez les propriétés du projet et rendez-vous sur la catégorie « Run » :

Figure 10-22: Propriétés du projet (Run)

Le champ « Main Class » permet d’identifier la classe principale.

Cliquez sur le bouton « Browse » pour sélectionner la classe principale « .PetstoreFrame » :

Figure 10-23: Sélection de la classe principale

Cliquez sur le bouton « Select Main Class ».

Cliquez ensuite sur OK afin de sauver vos modifications dans les propriétés du projet :

Figure 10-24: Classe principale identifiée

À partir du menu « File » ou via un clic droit dans la fenêtre « Projects », NetBeans offre la capacité de créer le nouveau groupe de projet :

Figure 10-25: Créer un groupe de projet

Sélectionnez l’option « New group ».

La fenêtre suivante permet de nommer le groupe de projet qui est dans notre cas « Yaps– Client » :

Figure 10-26: Nouveau groupe de projet

Les options par défaut indiquent que les projets en cours de chargement dans l’IDE seront automatiquement ajoutés au groupe de projet.

Cliquez sur le bouton « Create Group ».

Un clic droit sur le projet fait apparaître le menu contextuel proposant les options pour compiler le projet (« Build » ou « Clean and Build ») :

Figure 10-27: Compiler le projet Cliquez sur l’option « Clean and Build ».

La fenêtre « Output » affiche les traces de la compilation :

Figure 10-28: Résultat de la compilation

En analysant en détail les traces de la compilation, on relève les messages suivants :

Ces traces indiquent que l’application Yaps-Client a été correctement compilée et qu’il est possible de l’exécuter à partir de la ligne de commande en invoquant la commande suivante :

java –jar {yapson_home}\Yaps-Client\dist\

Nous allons décrire les spécificités de NetBeans en matière d’exécutions d’applications Java.

Avant de démarrer l’application Yaps-Client, il est nécessaire de démarrer le serveur « PetStore ».

Rendez-vous sur l’onglet « Services » et démarrez le serveur PetStore :

Figure 10-29: Démarrez le serveur PetStore

Sous NetBeans, l’application Yaps-Client peut-être démarrée de différentes façons :

•   En appuyant sur la touche « F6 »

•   À partir du menu « Run ? Run Main project » :

•   À partir de l’option « Run » du menu contextuel du projet :

•

L’application apparaît à l’écran :

Figure 10-30: Application Yaps-Client

Reportez-vous au livre de référence qui décrit les fonctionnalités de l’application client.

La barre de statut de NetBeans (en bas et à droite) affiche le statut de l’application en cours d’exécution :

Pour stopper l’exécution de l’application, un clic droit sur la barre de statut propose un menu contextuel permettant de stopper l’application :

Figure 10-31: Annuler l'exécution

Les sources du client de l’application « Yaps» ont été transférées sous NetBeans dans une arborescence conforme au format préconisé par le Java Blueprints.

Les tests que nous avons réalisés attestent que l’application cliente Swing communique correctement avec les composants déployés sur le serveur.

Nous voilà arrivés 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 bénéficiant de la richesse et de la souplesse de NetBeans 6.5.x/6.7.x.

Couplé au livre de référence, vous êtes paré à vous lancer dans l’élaboration d’application

JEE5 ou de réaliser des POC (Proof Of Concept) nettement plus riches qu’un simple « Hello World ». L’application Yaps Pet Store peut servir d’excellent point de départ pour vos expérimentations.

Bien entendu, nous n’avons qu’effleuré les différentes facettes de NetBeans. Le site vous sera d’un grand secours tant les informations qui s’y trouvent sont nombreuses.

Et maintenant, à vous de jouer !

---