Ce billet utilise un tutoriel présenté par Spring Source, en y ajoutant quelques remarques.
1. Installation et création d’un projet
Téléchargez la dernière version sur http://www.springsource.com/download/community. C'est un zip; une fois extrait vous obtiendrez l’arborescence suivante :
Ajoutez %INSTALL_DIRECTORY%\bin à votre PATH.
Puis j’ai suivi ce tutoriel : http://blog.springsource.com/2009/05/27/roo-part-2/.
Pour créer un projet, tapez la commande :
Cette commande initialise un projet avec les conventions maven. Il est quasiment vide, hormis l’applicationContext et le log4j.properties qui sont créés dans src/main/resources/META-INF/spring.
Trois types de persistence sont proposés : ECLIPSELINK, Hibernate et OpenJPA. J’ai choisi d’utiliser Hibernate. Plusieurs type de bases sont supportés MySQL, MSSQL, Oracle, POSTGre, pour ne citer que les plus utilisées.
Dans scr/main/META-INF, le fichier database.properties est créé, vous permettant de spécifier, l’url et les logins/mot de passe de la base à laquelle vous souhaitez vous connecter. Il y a des commandes roo qui vous permettront de modifier ce fichier depuis l’interface, mais vous pourrez très bien le faire à la main.
A cette étape, le pom est déjà très verbeux. Il faudra vous armer de patience si vous voulez le modifier. Pourtant, il se peut que vous en ayez besoin. Par exemple, le projet créé tire des dépendances vers les plugins tomcat et eclipse qui ne vous seront peut être pas utiles.
Autre information, le projet utiliser slf4j, avec le log4 over slf4.
2. Création d’une entité
Et là, je me dis tiens, je ne vais pas être original, je veux pouvoirs gérer des utilisateurs, je vais donc créer une entité User. Je tape donc la commande préconisée :
roo> entity --name ~.bo.User
Première erreur, ce n’est plus --name qu’il faut utiliser mais --class. Ce qui donne :
roo>entity –classe ~.bo.User
Retour à la réalité :
Reserved SQL keyword 'User' is not permitted as simple type name
Grrr ! Bon et bien on va mettre People. Ca passe, on continue.
La classe people a déjà plusieurs attributs, une version et un identifiant. Je choisi donc d’ajouter un simple champ email qui sera non null.
roo> field string email –notNull –sizeMax 30
Après avoir taper cette commande :
roo> test integration
Vous disposez d’une application qui permet de persister un objet et des classes de test correspondantes.
Attention, ROO utilise la programmation orientée aspect. Il peut donc être assez compliqué de faire des modifications si vous ne maitrisez cette technologie.
On peut, par exemple, penser à l’ajout d’un champ. Je pense qu’il sera préférable d’utiliser les commandes roo plutôt que de temps l’ajout manuel. J’ai ajouté des méthodes dans la classe que j’avais créée et le merge est effectué correctement. Je ne perds donc pas mes modifications. J’émettrais toutefois quelques réserves dans des cas plus compliqués que je n’ai pas testé.
Voici la commande que j’ai tapée :
roo> field number age --type java.lang.Integer --class ~.bo.People
On notera l’ajout de --class
Allé, on va un petit peu plus loin, Roo est capable de générer l’IHM, testons !
3. Génération de l’IHM
J’ai utilisé la commande fournit dans le tutoriel
roo> controller scaffold ~.web.PeopleController
La génération se passe sans souci. J’ai hate!
J’ai utilisé controller scaffold
roo>controller all ~.web
Roo aurait généré les IHM de toutes les entités.
Afin de customiser votre application, vous aurez peut être besoin de savoir à quoi correspondent, les différents dossiers générés. Voici la définition tirée du site de Spring Source :
4. Démarrage
Ensuite, on est presque au bout, alors : mvn clean install.
Puis, démarrez de votre serveur d’application préféré, déployez l’application.
Tada :
java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException
mince !
J’utilise un jdk 1.5, pas de panique, c’est un bug connu, ouf !
Pour le résoudre, il faut ajouter deux dépendances dans votre pom.xml :
<dependency>
</dependency>
<dependency>
</dependency>
Allé c’est reparti, mvn clean install, tout ca, tout ca.
Et là, c’est génial ca marche :
Il y a déjà des contrôles de surface, on clique sur save, et c’est persisté ! Une page est disponible pour lister le contenu de la table People. Et en plus la gestion de la langue est déjà prévue.
Il y a plein de petits trucs, par exemple, si on utilise un attribut de type Date, dans l’ihm il y a aura directement un calendrier de proposé.
5. Les logs
Le tutoriel nous donne la possibilité d’ajouter des loggers dans la partie Web. Il faut savoir que Roo est capable de l’ajouter dans les entités, dans l’AOP, bref, partout en fait !
6. La sécurité
La gestion simple de la sécurité passe aussi par une seule commande.
roo> security setup
Il faut noter qu’elle n’est disponible qu’au moment où vous aurez créé la couche Web. Je n’ai pu l’exécuter qu’une fois.
Je me suis arrêté là dans la lecture du tutoriel, et souhaite bon courage à ceux qui voudront en apprendre d’avantage.
En conclusion, je dirais que Spring Roo est simple à prendre en main, on peut tout à fait créer une application simple en 30 minutes. Mais la maintenance d’une application générée peut être complexe, encore plus quand on ne maitrise pas l’AOP.
Je m’interroge sur :
- Pourquoi un répertoire selenium avec des fichiers test* se trouve dans WEB-INF et sera donc déployé ?
- Aucune CSS n’est présente, il semble pourtant y avoir de la mise en page. L’IHM pourrait donc être à reprendre si vous voulez partir avec la génération d’IHM
- Je m’attendais à avoir des DAOs, c’est en regardant le chapitre sur l’architecture d’une application que j’ai eu la réponse.
- Qu’est ce qui se passe quand on veut créer un projet multimodule ? J’ai bien l’impression que la division doit être ensuite faite à la main, ce qui peut être très contraignant. Je n’ai pas trouvé d’informations sur ce sujet.
Aucun commentaire:
Enregistrer un commentaire