| Astuce | ||
|---|---|---|
| ||
...
Sommaire :
| Sommaire | ||
|---|---|---|
|
...
Création de la structure du projet à partir de l’archetype esup-commons
...
Qu'est-ce
...
qu'un
...
archetype
...
Maven
...
?
...
Dans
...
le
...
contexte
...
de
...
esup-commons
...
,
...
un
...
archetype
...
est
...
une
...
structure
...
complète
...
d'un
...
projet
...
à
...
déployer.
...
Toute
...
l'organisation
...
des
...
fichiers,
...
des
...
classes
...
et
...
des
...
projets
...
Eclipse
...
sera
...
mise
...
en
...
place
...
par
...
l'archetype.
...
L'objectif
...
est
...
de
...
proposer
...
une
...
structure
...
standard
...
à
...
tous
...
les
...
développeurs.
...
Le
...
développeur
...
aura
...
"uniquement"
...
à
...
sa
...
charge
...
le
...
remplissage
...
de
...
cette
...
structure.
...
La
...
structure
...
du
...
projet
...
va
...
être
...
construite
...
à
...
partir
...
d’un archétype
...
maven
...
dont
...
voici
...
les
...
paramètres
...
:
...
archetypeRepository=
...
...
archetypeGroupId=org.esupportail.blank
...
archetypeArtifactId=esup-blank-archetype
...
archetypeVersion=
...
numeroVersionArchetype
...
groupId=
...
domaineMonProjet
...
artifactId=
...
nomProjet
...
package=
...
packageMonProjet
...
version=
...
numeroVersionMonProjet
où :
- numeroVersionArchetype : numéro de version de l'archetype
...
- à
...
- utiliser
...
- (version
...
- 0.2.8
...
- à
...
- l'heure
...
- où
...
- sont
...
- écrites
...
- ces
...
- lignes).
...
- Pour
...
- connaître
...
- le
...
- numéro
...
- de
...
- version
...
- de
...
- l'archetype,
...
- merci
...
- de
...
- vous
...
- référer
...
- à
...
- cette
...
- page
...
- :
...
- Changelog
- domaineMonProjet : nom de domaine du projet à développer. Par exemple : fr.univ pour un projet local ou org.esup-portail
...
- pour
...
- un
...
- projet
...
- communautaire
...
- 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
| Balise Wiki |
|---|
{htmlcomment}{note} En attendant qu'une version stable soit tagguée, vous pouvez récupérer la version en cours de développement (version 0.2.3-SNAPSHOT à l'heure où sont écrites ces lignes), en pensant à modifier l'URL du repository en [https://mvn.esup-portail.org/content/repositories/snapshots] {note}{ |
...
htmlcomment} |
...
Il
...
y
...
a
...
2
...
méthodes
...
possible
...
pour
...
créer
...
un
...
nouveau
...
projet
...
eclipse
...
à
...
partir
...
de
...
l'archetype
...
blank
...
:
...
Soit
...
directement
...
via
...
l'interface
...
d'Eclipse,
...
soit
...
en
...
ligne
...
de
...
commande
...
puis
...
importation
...
dans
...
Ecplise.
| Remarque | ||||
|---|---|---|---|---|
| =
| |||
| } Nous avons constaté quelques soucis dans la création de projet à partir d'un archetype avec le plugin maven d'eclipse : m2eclipse. Si vous rencontrez des messages d'erreurs indiquant qu'eclipse ne parvient pas à trouver l'archetype (voir erreur ci-dessous) n'hésitez pas à relancer complètement Eclipe. Toutefois nous vous recommandons d'utiliser la méthode par ligne de commande qui elle fonctionne bien. |
Création en ligne de commande
Récupération du projet : se positionner dans le répertoire workspace de Eclipse et lancer la commande suivante :
| Bloc de code |
|---|
Eclipe. !Capture d'e?cran 2011-05-26 a? 11.09.29.png|align=center,thumbnail! *Toutefois nous vous recommandons d'utiliser la méthode par ligne de commande qui elle fonctionne bien.* {note} h3. Création en ligne de commande Récupération du projet : se positionner dans le répertoire workspace de Eclipse et lancer la commande suivante : {code}mvn archetype:generate -B -DarchetypeRepository=https://mvn.esup-portail.org/content/repositories/releases -DarchetypeGroupId=org.esupportail.blank -DarchetypeArtifactId=esup-blank-archetype -DarchetypeVersion=numeroVersionArchetype -DgroupId=fr.univ -DartifactId=nomProjet -Dpackage=packageMonProjet -Dversion=numeroVersionMonProjet{code} |
Une
...
fois
...
l'archetype
...
récupéré,
...
il
...
faut
...
se
...
positionner
...
dans
...
le
...
répertoire
...
parent
...
(là
...
où
...
se
...
trouve
...
le
...
pom.xml),
...
et
...
lancer
...
la
...
commande
...
suivante
...
:
| Bloc de code |
|---|
}mvn eclipse:eclipse{code} |
Voila
...
le
...
résultat
...
dans
...
la
...
console
...
:
Cette commande va configurer les projets pour que ce soient des projets WTP dans Eclipse. Une fois cette étape terminée, il faut les importer dans Eclipse en tant que projets Maven.
Dans Eclipse : File => New => Maven => Existing Maven Projects
Il faut alors choisir le répertoire parent du Blank que l'on vient de récupérer. Eclipse va automatiquement sélectionner tous les modules présents.
On valide en cliquant sur Finish.
Le projet est maintenant prêt à être utilisé.
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 le projet est créé avec vos choix.
Pour préparer un projet, toutes les dépendances doivent être satisfaites. Chaque module Maven dépendant d'un autre, il faut donc compiler chaque module afin de générer les jar qui seront utilisés par les autres modules.C'est le but de la target Install de Maven.
Lancer la tache Maven via un clic droit sur le projet parent : Run as => Maven install
Voila le résultat dans la console de Eclipse ?:
Le projet est maintenant prêt à être utilisé.
Utilisation du projet
Une fois le projet prêt, vous pouvez supprimer les modules web qui ne vous intéressent pas. Pour rappel, dans cette page : 1.2 Méthodologie de développement, vous trouverez toutes les informations pour choisir le module web à garder. Ce n'est pas une obligation de supprimer les modules web que vous ne souhaitez pas utiliser, vous pouvez les garder pour un usage ultérieur. Ils ne poseront pas de problème dans votre travail de développement.
Pour tester votre module et donc votre développement, il faut utiliser les fonctionnalités WTP de Eclipse. Il faut ajouter le module web dans un des serveurs déclarés dans votre Eclipse.
Pour cela, faire un clic-droit sur le serveur que vous souhaitez utiliser, et choisissez "Add and Remove ...".
Vous devez alors choisir le module web sur lequel vous souhaitez travailler.
Et une fois vos choix validés, le contexte de votre module est accessible dans le serveur choisi.
Dans notre exemple, pour y accéder, vous devrez alors taper l'URL : http://localhost:8080/portlet-reservation-web-jsf-servlet
...
...
...
Il
...
ne
...
vous
...
reste
...
alors
...
plus
...
qu'à
...
démarrer
...
le
...
serveur.