1 novembre 2007

Tester Grails et son déploiement sur Tomcat

1. Installation

J'ai téléchargé la derniere version de Grails sur cette page : http://grails.codehaus.org/Download
(J'ai choisi le zip binary release)
J'ai dezippé l'archive dans mon répértoire Program Files, ajouté une variable d'environnement GRAILS_HOME désignant le répertoire de Grails et ajouté %GRAILS_HOME%\bin au path.
Pour tester mon installation, j'ai tapé dans une invite de commandes
grails -help

2. Création d'une première application

Tout d'abord, j'ai créé un répertoire "Projets Grail" pour stocker mes futures applications.
Avec l'invite de commandes, je me suis placé dans ce répertoire et j'ai lancé la commande :
grails create-app
Un script de création d'application se lance et demande un nom d'application:
Application name not specified. Please enter:
annuaire

Mon application "annuaire" qui servira de premier test grails va gérer une liste de personnes et leurs coordonnées.
Lorsque le script est terminé, je peux lancer la commande:
cd annuaire
grails run-app
Un serveur d'applications Jetty est lancé et on peut acceder à l'application via l'url http://localhost:8080/annuaire
On doit arriver à cette page:

3. Codage d'une première classe

Pour gérer la liste de personnes, j'ai besoin d'une classe.... Personne!
Pour créer cette classe, il faut lancer la commande :
grails create-domain-class Personne

Un fichier annuaire/grails-app/domain/Personne.groovy est créé que je vais modifier pour décrire une personne:

class Personne {
String nom
String prenom
Date dateNaissance
Integer nombreEnfants
}

Il faut maintenant créer le controleur qui gérera cette liste de personnes.
Pour se faire, il faut éxecuter la commande:
grails create-controller Personne
Cela créé le fichier annuaire\grails-app\controllers\PersonneController.groovy
Pour avoir une interface de CRUD classique, je vais modifier ce fichier comme ceci:

class PersonneController {
def scaffold = Personne
}

Il ne reste plus qu'à tester en relançant le serveur de test:
grails run-app
et aller à l'url http://localhost:8080/annuaire/personne
Voilà une première application Grails fonctionnelle réalisée en moins de 30 minutes!

4. Test d'une application Grails sur un serveur Tomcat
Reste une dernière chose: déployer cette application sur un serveur Tomcat et ne plus se servir du serveur de test Jetty.
Dans le répertoire "annuaire", je lance la commande
grails war
et cela me créé un fichier war (équivalent des jar pour une application web).
Pour le déployer simplement dans Tomcat, il suffit d'aller dans l'interface Manager de tomcat et utiliser l'interface de déploiement

Dans "Select WAR file to upload", je sélectionne mon fichier war et je clique sur Deploy.
Après le chargement (qui peut être un peu long), l'application est disponible sur le serveur tomcat à travers l'URL http://localhost:8080/annuaire

Aucun commentaire: