Création de la structure du projet à partir de l'archetype
Nous allons prendre pour l'exemple la création du projet portlet-réservation. Une portlet qui proposera la réservation de ressources (ex : salles, véhicules, matériel)
A completer
Notion d'archetype Maven
La structure du projet va être construite à partir d'un archétype maven dont voici les paramètres :
-DarchetypeRepository=https://mvn.esup-portail.org/content/repositories/releases
-DarchetypeGroupId=org.esupportail
-DarchetypeArtifactId=esup-blank-archetype
-DarchetypeVersion=numeroVersion
-DgroupId=org.esupportail
-DartifactId=nomProjet
-Dpackage=packageMonProjet
-Dversion=1.0-SNAPSHOT
Pour connaitre le numéro de version de l'archetype, merci de vous référer à cette page : Changelog
!! Attention !! En fait, au moment du mvn create il faut absolument que le groupId=org.esupportail.
Si vous utilisez Eclipse et que vous mettez pour l'atrifactId=qqchosecommeonveut ce dernier propose automatiquement un package en fonction de ça : org.esupportail.qqchosecommeonveut. On pourrait penser qu'il faut changer le groupId pour mettre un fr.uhp par exemple et avoir ensuite un package=fr.uhp.qqchosecommeonveut
En fait non, le groupId et le package sont complètement dissociés. Il faut laisser groupId=org.esupportail et taper à la main (sans garder ce qu'eclipse suggère par défaut) un fr.uhp.qqchosecommeonveut et normalement ça marche ! Il met les références vers les classes org.esupportail.commons. En fait, il construit les références en fonction de l'argument groupId passé.
Création depuis Eclipse
Se rendre dans le menu File => New => Project...
Choisir Maven Project
Laisser l'emplacement par défaut pour le projet
Il n'y a pas d'archétype
Cliquer sur Add Archetype
Remplir les champs correspondant à l'archétype que l'on souhaite utiliser
Choisir l'archétype que l'on vient d'ajouter
Créer le projet
Cliquer sur finish et voilà
Création en ligne de commande
mvn archetype:generate -B -DarchetypeRepository=https://mvn.esup-portail.org/content/repositories/releases
-DarchetypeGroupId=org.esupportail -DarchetypeArtifactId=esup-blank-archetype -DarchetypeVersion=0.2.0
-DgroupId=org.esupportail -DartifactId=ur1-test -Dpackage=fr.univrennes1.test -Dversion=1.0-SNAPSHOT
Démarrage du projet
Lancer Run => Run configurations...
Choisir le répertoire portlet-reservation et l'action jetty:run