« Démonstration de Grails | Page d'accueil | Script et code du video sur Grails »
19 mars 2009
Script et code du video sur Grails
Un menuisier à plus d’un outil dans son coffre. A l’inverse, quand on a seulement un marteau, tous les problèmes ressemblent à un clou. C’est un peu l’état de la situation pour notre développement Java dans les petits développements et à la limite pour les projets de moyennes envergures. Dans le but de garnir notre coffre à outils, nous en sommes à évaluer divers cadres logiciel (framework). Un des plus prometteurs est Grails (http://www.grails.org ), un framework inspiré de Rails, que j’ai beaucoup aimé, mais qui est un peu compliqué à introduire dans une grande entreprise en raison du langage sous-jacent : Ruby.
Grails utilise la même philosophie de « convention over configuration » que Rails, mais fonctionne dans un environnement Java (JEE) standard. Comme nous utilisons Tomcat et WebSphere comme environnement de déploiement, Grails est très intéressant. C’est cependant sa simplicité et sa rapidité de développement qui en font un outil de premier plan pour nos besoins.
Dans la suite du document nous allons bâtir une application simple de suivi d'un portefeuille de projet.
Un environnement de développement en 20 minutes
Pour débuter le développement, il s’agit d’installer le JDK le plus récent (1.6.0_12) et spécifier les deux variables d’environnement PATH et Java_Home et de vérifier que Java peu être invoqué à la ligne de commande.
java
Ensuite, on installe Grails et on ajuste le PATH et on spécifie le Grails_Home et on vérifie que Grails est correctement installé.
grails help
Pour les besoins de rapportage nous allons utiliser JasperReport. Pour créer les rapports nous installerons iReport.
Comme nous utiliserons la base de données HSQLDB pour la démo, il faut copier le driver HSQLDB (1.0.8) de Grails dans celui de HSQLDB (1.0.7) afin que les deux utilisent la même version.
En incluant les temps de téléchargement, vous devriez être à pied d’œuvre en une vingtaine de minutes.
Une première page avec validations
Pour la majorité du développement nous allons utiliser une fenêtre de commande DOS.
Créez un nouveau répertoire pour l’application :
mkdir demos
Créez l’arborescence, le squelette, de la nouvelle application (appelons là « gest »)
grails create-app gest
Allez dans le nouveau répertoire
cd gest
Créez une classe pour l’entité de projet
grails create-domain-class projet
Avec un éditeur de texte ajoutez les attributs de la classe projet (dans /grails-app/domain) et sauvegarder les modifications.
String nom
String unite
Integer noProposition
String urlProposition
Integer mehari
A ce point ci nous avons une classe de « model » du pattern MVC (model-view-controller). Cet objet persistant peut déjà être utilisé par programmation. Nous allons cependant ajouter le contrôleur et la vue qui nous permettrons d’interagir avec la classe via une page web en trois ligne.
D’abord, créez le contrôleur :
grails create-controller projet
Avec un éditeur de texte modifier le code du contrôleur de projet (dans /grails-app/controller) et sauvegarder les modifications. Inscrivez :
def scaffold = Projet
Cette ligne de code va créer les vues du MVC de façon dynamique.
Il ne reste plus qu’à lancer l’application
grails run-app
Maintenant que l’application tourne, ouvrez le fureteur à l’adresse suivante, et ajouter un projet.
Voilà, une application fonctionnelle en quelques minutes!
Oui, mais notre travail n’est pas terminé. Nous allons d’abord ajoutez quelques validations. Modifiez la classe de domaine pour « projet ».
static constraints = {
nom(blank :false, maxSize :10, unique:true)
mehari(range:1..4)
noProposition()
urlProposition(url:true)
unite()
}
Sauvegardez les modifications et actualisez la fenêtre du fureteur. Saisissez un nouveau projet sans nom de projet ou avec plus de 10 caractères de long.
On a créé une application fonctionnelle en une dizaine de minutes.
Ajouter une liste déroulante
Nos « projets » sont associés à un « marché ». Nous allons donc ajouter une nouvelle classe et son contrôleur (« marche ») et l’associer à la classe « projet ».
grails create-domain-class marche
Ajouter la propriété « nom » dans la classe « marche »
String nom
Créez le contrôleur
grails create-controller marche
Modifiez le code du contrôleur de « marche » pour que la vue se gère automatiquement.
def scaffold = Marche
Sauvegarder les modifications.
Pour associer Projet et Marche, modifiez la classe Projet en ajoutant la propriété suivante :
Marche marche
Pour que ces modifications prennent effet il faut arrêter l’application et la redémarrer dans la fenêtre de commande.
Ctrl-C
O
grails run-app
Lorsque l’application est redémarrée, rafraîchissez la fenêtre du fureteur.
Ajouter deux marchés, puis un projet.
Notez la liste déroulante qui montre le nom de la classe et l’identifiant.
Comme ce n’est pas très joli, nous allons corriger la situation. Ajouter le code suivant à la classe « marche » (dans /grails-app/domain).
String toString() { return nom}
Notez qu’à chaque modification l’application est réinitialisée. Donc ajoutez deux marchés, puis un projet. Remarquez la liste déroulante.
Pour établir la relation dans l’autre sens, ajouter le code suivant à la classe de domaine « marche ».
static hasMany = [projet :Projet]
Pour s’assurer que les projets sont détruits lorsqu’on supprime un marché, ajoutez le code suivant à la classe du domaine « projet ».
static belongsTo = [marche :Marche]
Voilà une application fonctionnelle en quelques lignes de code. Pour savoir combien, arrêter l’application, dans le fenêtre de commande et faites la commande suivante :
grails stats
Le tout nous aura pris une dizaine de minutes supplémentaires.
Modifier l’apparence
L’application que nous avons créée ne respecte pas nos normes visuelles. Pour les fins de la démonstration, j’ai modifié légèrement la feuille de style. Le but ici n’est pas montrer le produit final, mais simplement comment il est facile de modifier le look de l’application. Essentiellement, j’ai supprimé les images, changé la police de caractère et les couleurs.
Copier le fichier main.css dans /web-app/css
Lancer l’application pour voir l’effet du changement.
grails run-app
Grails supporte divers type de données, pour en faire la démonstration, ajoutez les propriétés suivantes à la classe de domaine « projet ».
Boolean implicationDpas
Date dateDeDemande
Dans le fureteur notez comment les libellés sont construits.
Vous avez remarqué que l’application « perd » ses données à chaque redémarrage, déclenché par les modifications que nous apportons au code. La raison de ce comportement est simple. Par défaut, en développement, Grails utilise une base de données HSQLDB mémoire qui est en mode de recréation. Pour rendre les données persistantes entre les redémarrages, modifiez le fichier de configuration (/grails-app/conf/DataSource).
dbCreate = "update"
url = "jdbc:hsqldb:file:devBD"
Grails peu utiliser toutes les bases de données que Hibernate supporte car sous Grails c’est ce composant qui est utilisé. Dans le même ordre d’idée, on trouve aussi le framework Spring sous le capot. Deux composants qui ont fait leurs preuves dans les grandes entreprises.
Un autre petit dix minutes bien utilisé.
Rapportage et recherche
Nous allons maintenant ajouter un rapport à la page de liste de projet. Pour ce faire nous utiliserons JasperReport qui est fournit en plugin. Pour l’installer :
grails install-plugin jasper
Pour modifier la vue de liste de projet, il faut avoir le code. Actuellement, il est généré dynamiquement à l’aide du « scaffolding » de Grails.
grails generate-all projet
A la fin de la page de liste, ajouter le tag suivant :
<g :jasperReport jasper= «ListeProjet » format= « PDF » name= « Rapport » />
Créez un rapport avec IReport nommé ListeProjet.jrxml et sauvegardé dans le répertoire :
/web-app/reports/
Pour ajoutez une recherche à la page de liste, modifiez le code de list.gsp (en haut de la liste) pour ajouter :
<g:form action="search" method="post" >
<div class="dialog">
<table>
<tr class="prop">
<td class="name">
<label for="nom">Nom de projet</label>
</td>
</tr>
<tr class="value">
<td class="name">
<input type="text" name="nom" value=""/>
</td>
</tr>
</table>
<div class="buttons">
<input type="submit" value="Rechercher"/>
<g:link action="list">Tout afficher</g:link>
</div>
</div>
</g:form>
Ensuite il faut modifier le contrôleur de Projet afin d'ajouter l'action "search" et modifier "list" pour passer le critère de recherche via un flash.
def search = {
flash.nom = params.nom
redirect(action:list)
}
def list = {
if (!flash.nom)
[projetInstanceList: Projet.list(params), projetInstanceTotal:Projet.count()]
else
[projetInstanceList: Projet.findAllByNomLike("%" + flash.nom + "%"), projetInstanceTotal:Projet.count()]
}
Il ne reste qu'a le déployer sur notre environnement de test
grails war
08:43 Lien permanent | Commentaires (2) | Trackbacks (0) | Envoyer cette note | Tags : grails
Trackbacks
Voici l'URL pour faire un trackback sur cette note : http://agile.blogspirit.com/trackback/1727810
Commentaires
Hi,
Great introduction, though I must say that I find the mixture of English and French painful to read. I'm referring to identifiers like:
Projet.findAllByNomLike
Grails conventions won't let you use:
Project.trouverTouteParNomSemblable
so wouldn't it better just to write:
Project.findAllByNameLike
Ecrit par : Donal | 28 juillet 2009
By the way, you might be interested in this group for Groovy/Grails developers in Montreal:
http://ggmontreal.groupsite.com/
Ecrit par : Donal | 29 juillet 2009