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 :
archetypeRepository=https://mvn.esup-portail.org/content/repositories/releases
archetypeGroupId=org.esupportail
archetypeArtifactId=esup-blank-archetype
archetypeVersion=numeroVersionArchetype
groupId=org.esupportail
artifactId=nomProjet
package=packageMonProjet
version=numeroVersionMonProjet
où :
- numeroVersionArchetype : numéro de version de l'archetype a utiliser. Pour connaitre le numéro de version de l'archetype, merci de vous référer à cette page : Changelog
- nomProjet : nom de mon projet. Par exemple : portlet-reservation
- packageMonProjet : nom du package JAVA correspondant à mon projet. Par exemple : fr.uhp.reservation
- numeroVersionMonProjet : numéro de version de mon projet. Par exemple : 1.0-SNAPSHOT
- les autres paramètres ne sont pas à modifier
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
Au moment de la création de l'archetype, il faut absolument que groupId=org.esupportail.
Lorsque que vous mettez pour l'atrifactId=portlet-reservation, Eclipse propose automatiquement un package en fonction de cet artifactUd : org.esupportail.portlet_reservation. On pourrait penser qu'il faut changer le groupId pour mettre un fr.uhp par exemple et avoir ensuite un package=fr.uhp.portlet_reservation
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) fr.uhp.reservation.
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