Débuter avec le graal

Création d’une application

Pour créer une application Grails, utilisez la commande grails create-app. La commande suivante crée une application Grails, nommée myapp dans le répertoire courant :

grails create-app fancy-app

L’exécuter est aussi simple que de visiter le répertoire de l’application nouvellement créé :

cd fancy-app

et alors

grails run-app 
// in order to run the app on a different port, e.g. 8888, use this instead
grails run-app -port 8888
// in order to run the app with a secure communication
grails run-app -https

Grails Installation

Remarque : GRAILS nécessite l’installation d’un JDK Java (un environnement d’exécution JRE n’est pas suffisant) sur votre système, avant de configurer Grails. Veuillez vous référer à [comment installer JDK][1]. Au moment d’écrire ces lignes, il est recommandé d’installer le dernier JDK.


Pour Mac OSX, Linux, Cygwin, Solaris et FreeBSD :

Le moyen le plus simple de gérer les versions de Grails consiste à utiliser sdkman. Si sdkman est installé, vous pouvez alors installer n’importe quelle version de Grails en utilisant

sdk install grails [version]

Cela prendra soin de toutes les étapes pour bien faire les choses. Si vous sautez la version, la dernière version de grails sera installée. Pour plus d’informations sur l’utilisation de sdkman, reportez-vous à [page d’utilisation de sdkman][2].


Pour Linux :

    GRAILS_HOME=$HOME/bin/grails/current
    # abbreviating it using "..." for brevity
    PATH=$GRAILS_HOME/bin:$JAVA_HOME/bin: ... :$PATH

Pour les fenêtres:

  1. Téléchargez un JDK Java depuis [Oracle][3] et installez-le sur votre machine Windows. Prenez note du dossier d’installation.
  2. Téléchargez manuellement une version de Grails depuis la page Téléchargements.
  3. Extrayez le fichier Grails, où vous voulez.
  4. Important : Vous devez configurer 2 nouvelles variables d’environnement JAVA_HOME et GRAILS_HOME (pour Windows 10 trouvées sous *Panneau de configuration \ Système et sécurité \ Système \ Paramètres système avancés \ onglet Avancé \ Variables d’environnement) * , pointant vers les répertoires extraits, par ex.

Nom : JAVA_HOME

Valeur : C:\Programmes\Java\jdk1.8.0_31

Nom : GRAILS_HOME

Valeur : c:\grails\grails-3.2.4

  1. Important : Vous devez étendre la variable Windows “PATH” pour inclure à la fois JAVA_HOME et GRAILS_HOME. La variable de chemin se trouve également dans le panneau de configuration (voir 4), par ex. ajouter ce qui suit à la fin :

;C:\Programs\Java\jdk1.8.0_31\bin;c:\grails\grails-3.2.4;c:\grails\grails-3.2.4\bin

  1. Pour vérifier que votre installation est correcte, ouvrez une invite de commande et tapez GRAILS -VERSION. Vous devriez obtenir quelque chose comme :
| Grails Version: 3.2.4
| Groovy Version: 2.4.6
| JVM Version: 1.8.0_65

[1] : https://www.wikiod.com/fr/java/debuter-avec-le-langage-java#Définition de %PATH% et %JAVA_HOME% après l’installation sous Windows [2] : http://sdkman.io/usage.html [3] : http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Tester une application

Les commandes create-* de Grails créent automatiquement des tests unitaires ou d’intégration pour vous dans le répertoire src/test/groovy. Il vous appartient bien sûr de remplir ces tests avec une logique de test valide, dont les informations se trouvent dans la section Tests unitaires et d’intégration.

Pour exécuter des tests, exécutez la commande test-app comme suit :

grails test-app

Création d’un modèle

Un modèle (voir : modèle Modèle-Vue-Contrôleur) dans Grails est représenté par une soi-disant Domain Class. Les classes de domaine peuvent définir à la fois la persistance et la présentation des informations dans les graals. Les classes de domaine peuvent également contenir des validations.

Pour gérer une flotte de voitures dans votre application Grails, vous pouvez définir une classe de domaine pour décrire, stocker et représenter différentes voitures de votre flotte.

Pour créer un stub pour une classe de domaine, exécutez la commande suivante dans votre dossier d’application :

grails create-domain-class org.fleetmanager.Car

Ensuite, ouvrez le fichier car.groovy généré et modifiez votre classe de domaine comme suit :

package org.fleetmanager

class Car {
   String      manufacturer
   String      model
   String      color
   Integer     year
   Date        acquisitionDate
   Boolean     isElectric
}

Enfin, générez un contrôleur pour votre domaine automobile et une vue à l’aide de la commande Grails suivante :

grails generate-all org.fleetmanager.Car

Maintenant, vous pouvez exécuter vos applications, sélectionner le contrôleur de voiture et gérer votre flotte.