IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

YAPS Pet Store sous NetBeans


précédentsommairesuivant

VII. Importer le projet BarkBank

Le projet BarkBank est une application Web (« Web Applications ») exposant le Web Service « ValidationService » chargé de simuler le processus de validation des cartes de 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.

LLVII-A. Créer un nouveau projet

LLVII-A-1. Fermeture des projets

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 :

Image non disponible

LLVII-A-2. Type de projet

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

Image non disponible

Cliquez sur le bouton « Next » pour continuer.

LLVII-A-3. Nom et répertoires

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

Image non disponible

Les informations à introduire sont les suivantes:

Project Name:  BarkBank
Project Folder:  C:\Projects\YapsON\BarkBank

Project Folder

Le répertoire du projet est donné ici à titre d'exemple et doit correspondre au répertoire où vous avez décompressé le fichier d'archives de l'application YapsON (voir ici).

Cliquez sur le bouton « Next » pour continuer.

LLVII-A-4. Configuration du serveur

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

Image non disponible

La configuration utilisée pour le déploiement est la suivante :

Server:  Petstore
Context Path:  /barkbank

Cliquez sur le bouton « Next » pour continuer.

LLVII-A-5. Les frameworks

La dernière étape consiste à spécifier les frameworks à utiliser.
Dans le cadre du projet « BarkBank », aucun framework spécifique n'est employé :

Image non disponible

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

LLVII-A-6. Génération du projet

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

Image non disponible

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

LLVII-B. Transférer le projet sous 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 « yapson.xml » (décrit dans la section 3.5) automatise la copie des fichiers.

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

LLVII-B-1. Positionner les variables d'environnement

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 « setenv-yaps.cmd » :

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

LLVII-B-2. Transférer le projet

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

 
Sélectionnez
{yapson_home}> ant -f yapson.xml transferBarkBank
Buildfile: yapson.xml
transferBarkBank:
[echo] Transfer the BarkBank projet to NetBeans
...

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

 
Sélectionnez
...
[input] The target source files will be overwritten by the original YAPS project. Do you
want to continue? (y, n)
y
...

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

 
Sélectionnez
...
[echo] === Copy Java Sources ===
[copy] Copying 1 file to c:\Projects\YapsON\BarkBank\src\java
[echo] === Copy Web Resources ===
[copy] Copying 2 files to c:\Projects\YapsON\BarkBank\web
[echo] === Copy Web Descriptors ===
[copy] Copying 1 file to c:\Projects\YapsON\BarkBank\web\WEB-INF
BUILD SUCCESSFUL

NetBeans rafraîchit automatiquement le projet BarkBank :

Image non disponible

LLVII-B-3. Créer le groupe de projet

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:

Image non disponible

Sélectionnez l'option « New group ».
La fenêtre suivante permet de nommer le groupe de projet qui est dans notre cas BarkBank :

Image non disponible

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

LLVII-C. Compiler le projet

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

Image non disponible

Cliquez sur l'option « Clean and Build ».
Le fenêtre « Output » affiche les traces de la compilation :

Image non disponible

Les messages intéressants sont les suivants :

 
Sélectionnez
...
compile:
compile-jsps:
Created dir: C:\Projects\YapsON\BarkBank\dist
Building jar: C:\Projects\YapsON\BarkBank\dist\BarkBank.war
do-dist:
dist:
BUILD SUCCESSFUL (total time: 2 seconds)

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

LLVII-4. Déployer le projet

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

Image non disponible

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 :

 
Sélectionnez
...
deployment started : 0%
deployment finished : 100%
Deploying application in domain completed successfully
...
All operations completed successfully
run-deploy:
BUILD SUCCESSFUL (total time: 4 seconds)

Le 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 noeud « Applications -> Web Applications -> BarkBank » affiche les ressources et services exposés par l'application :

Image non disponible

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

Image non disponible

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

LLVII-E. Tester le projet

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

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

Client de test SOAP

Nous vous recommandons d'évaluer la solution soapUI (http://www.soapui.org) qui est un outil de test de Web Service.

soapUI est proposé sous deux licences. La version standard est gratuite et distribuée sous licence Open Source. La version Pro est payante.

soapUI peut-être intégré sous forme de plug-in tant sous Eclipse que sous NetBeans.

Mais nous avons toutefois constaté des problèmes de stabilités avec le plug-in pour NetBeans contrairement à la stabilité affichée par la version standalone.

LLVII-E-1. Méthode 1 : Web Service Tester de GlassFish

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

Image non disponible

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.

LLVII-E-2. Méthode 2 : Web Service Tester de NetBeans

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 noeud « Web Service » :

Image non disponible

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

Image non disponible

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

Image non disponible

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

Image non disponible

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 :

Image non disponible

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

Image non disponible

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:

creditCardNumber:  1234567890
creditCardType:  MC
expiryDate:  11/09
Image non disponible

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

Image non disponible

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

Image non disponible

LLVII-F. Conclusion

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.


précédentsommairesuivant

Copyright © 2008,2009 Said Eloudrhiri Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.