YAPS Pet Store sous NetBeans

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 vous devez sélectionner l'option « New -> Web Service Client » :

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

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

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

Démarrage du serveur PetStore

Assurez-vous que le serveur « Petstore » est démarré, car dans le cas contraire la tâche de création du client Web Service ne pourra localiser l'URL du WSDL.

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

Localisation du WSDL

Nous aurions pu localiser le WSDL soit par projet ou par fichier.
Par Projet, cela aurait impliqué que le projet PetEx soit également ouvert dans l'IDE.
Par Fichier, cela nécessite de localiser le fichier WSDL généré dans le projet PetEx.
Nous avons préféré illustrer le mode URL pour simuler la situation où le Web Service serait déployé sur un serveur distant ?

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

Code source du Proxy client

Le code source Java du Proxy client est généré sous le répertoire suivant :

{yapson_home}/Yaps-Server/Yaps-Server-ejb/build/generated/wsimport/client

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

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

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

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

Cliquer sur « Finish » pour 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 :

Code source du Proxy client

Le code source Java du Proxy client est généré sous le répertoire suivant :

{yapson_home}/Yaps-Server/Yaps-Server-war/build/generated/wsimport/client

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

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 noeud « Table » de la base de données « petstoreDB » présente le menu contextuel suivant :

Sélectionnez l'option « Execute Command ».
Copiez le contenu du fichier « data.sql » pour le coller dans la fenêtre de commande :

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

Exécuter une sélection de commandes SQL

Il vous est également loisible d'exécuter un ensemble de commande.
Dans la fenêtre de commande SQL, sélectionnez les commandes à exécuter.
Un clic droit fait apparaître le menu contextuel avec l'option « Run Selection » :

On se rend vite compte que le chargement manuel est quelque peu contraignant, car il vous oblige à 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 « build.xml » du projet afin d'exploiter les targets Ant suivantes :

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.

Nous allons montrer comment enrichir le fichier « build.xml » 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 noeud du projet Yaps-Server :

Vous constatez la présence du fichier « data.sql » qui a été transféré du projet original.
Vous allez créer le script Ant « yaps-data.xml » qui sera utilisé pour charger les données de test.

Fichier « yaps-data.xml »

L'archive de l'application YapsON est livrée avec le fichier « yaps-data.xml ».
Il n'est donc pas nécessaire de créer ce fichier. Vous êtes libres de le déplacer du répertoire principal vers le répertoire du projet « Yaps-Server » :

C:\> cd {yapson_home}
{yapson_home}> copy yaps-data.xml Yaps-Server

Sélectionnez le dossier « yaps-Server.

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

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

Cliquez sur « Next » pour poursuivre.

Ensuite, entrez le nom du fichier qui sera dans notre cas « yaps-data.xml » :

Cliquez sur « Finish » pour terminer le processus.

Le fichier « yaps-data.xml » s'ouvre maintenant dans l'éditeur de NetBeans pour vous permettre de le compléter :

Nous fournissons ci-dessous le contenu à appliquer au fichier « yaps-data.xml » :

<?xml version="1.0"?>
<!-- This Ant script is used to load test data on the Yaps Pet Store Database -->
<project name="Yaps-Data" default="load-data" basedir=".">
<!-- Database properties -->
<property name="db-url" value="jdbc:derby://localhost:1527/petstoreDB" />
<property name="db-driver" value="org.apache.derby.jdbc.ClientDriver" />
<property name="db-userid" value="dbuser" />
<property name="db-password" value="dbpwd" />
<!-- Derby Library location -->
<property name="derby.home" value="C:/Program Files/glassfish-v2ur2/javaDB"/>
<property name="derby.lib" value="${derby.home}/lib"/>
<!-- Classpath -->
<path id="classpath">
<!-- Derby classes -->
<pathelement location="${derby.lib}/derbyclient.jar"/>
</path>
<!-- Ant task used to load data on the Yaps Pet Store Database -->
<target name="load-data">
<sql driver="${db-driver}"
url="${db-url}"
userid="${db-userid}"
password="${db-password}"
autocommit="yes"
onerror="continue"
caching="yes"
src="data.sql">
<classpath refid="classpath"/>
</sql>
</target>
</project>

Nous allons 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 « data.sql ».
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 » :

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

Toujours à partir de l'onglet « Files », ouvrez le fichier « build.xml » du projet « 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 « build.xml » :

...
<!-- After deploying the application, we populate the database with test data -->
<target name="post-run-deploy">
<echo>Load Data on the Yaps Pet Store Database ... </echo>

<ant antfile="yaps-data.xml" target="load-data"/>
</target>
</project>

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

Pour 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 ici), vous verrez apparaître la trace suivante sur la console :

...
post-run-deploy:
Load Data on the Yaps Pet Store Database ...
load-data:
Executing resource: C:\Projects\YapsON\Yaps-Server\data.sql
91 of 91 SQL statements executed successfully
...

Ces informations indiquent que 91 requêtes SQL du fichier « data.sql » 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 ».