Ok

En poursuivant votre navigation sur ce site, vous acceptez l'utilisation de cookies. Ces derniers assurent le bon fonctionnement de nos services. En savoir plus.

« Démonstration de Grails | Page d'accueil | Forum des architectes - MicroSoft 4 mai 2009 »

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.

 

http://localhost:8080/gest

 

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) | Tags : grails

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

Écrit 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/

Écrit par : Donal | 29 juillet 2009