formation-programmation-java/maven.ad at master · robusta-build/formation-programmation-java · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
= Introduction à Maven
:author: Arnaud Tournier
:email: [email protected]
:backend: revealjs
:deckjs_theme: neon
:revealjs_theme: beige
:revealjs_history: true
:imagesdir: images-javaee
:source-highlighter: highlightjs

== Introduction à Maven

=== Qu'est-ce que Maven ?

Un outil qui sert à :

- Organisation des projets,
- Compilation des projets,
- Gestion des dépendances,
- Tests unitaires, d'intégration, ...,
- etc !

=== Le POM

Chaque projet Maven est défini dans un fichier `pom.xml`.

Ce fichier est au format `xml`.

https://maven.apache.org/guides/introduction/introduction-to-the-pom.html[Introduction au modèle Maven].

=== Utilisation

Au lieu de créer nos projets dans Eclipse, nous allons déclarer dans un fichier `pom.xml` :

- l'identité de notre projet (GAV),
- la liste des bibliothèques dont il dépend,
- la façon dont on veut construire le projet.

Ensuite nous dirons à Eclipse d'utiliser les informations du `pom.xml` pour se configurer.

=== Principe fondamental

Nommage des _artefacts_ par :

- un _groupId_,
- un _artifactId_,
- un numéro de _version_.

Ceci constitue le _GAV_.

=== Allons-y !

Téléchargement de Maven ici :

https://maven.apache.org/download.html

=== On vérifie la version

		mvn --version

On obtient quelque chose comme :

[source]
----
Apache Maven 3.0.5 (r01de14724cdef164cd33c7c8c2fe155faf9602da; 2013-02-19 14:51:28+0100)
Maven home: D:\apache-maven-3.0.5\bin\..
Java version: 1.8.0_25, vendor: Sun Microsystems Inc.
Java home: C:\Program Files\Java\jdk1.8.0_25\jre
Default locale: nl_NL, platform encoding: Cp1252
OS name: "windows 12", version: "6.1", arch: "amd64", family: "windows"
----

=== Création d'un projet

[source]
----
mvn archetype:generate \
	-DarchetypeArtifactId=maven-archetype-quickstart \
	-DgroupId=fr.lteconsulting.formation \
	-DartifactId=exemple
----

Ceci crée un projet dans le sous-répertoire `exemple`.

=== La structure du projet

[source]
----
exemple
|-- pom.xml
`-- src
    |-- main
    |   `-- java
    |       `-- fr
    |           `-- lteconsulting
    |               `-- exemple
    |                   `-- App.java
    `-- test
        `-- java
            `-- fr
                `-- lteconsulting
                    `-- exemple
                        `-- AppTest.java
----

[%notitle]
=== .

*Examinons le fichier `pom.xml`...*

=== Construction du projet

Maven possède plusieurs _phases_ de travail correspondant au cycle de vie de la construction du projet.

		mvn package

Ceci déclenche l'exécution de la phase _package_ qui va de la compilation à la génération de l'artéfact binaire (`jar` ou `war` par exemple).

=== Lancement du projet

Avec la commande précédente, un fichier `jar` a été généré dans le répertoire `target`.

On peut le lancer ainsi :

		java -cp target/exemple-1.0-SNAPSHOT.jar fr.lteconsulting.exemple.App

=== Le dépôt local

Maven stocke l'ensemble des artifacts dont il s'est servi dans son _dépôt local_.

Pour placer le résultat de notre compilation dans le dépôt local, lancer

		mvn install

Allons voir le contenu du dépôt local dans `C:\Users\Moi\.m2`...

=== Génération du site de documentation

La commande :

		mvn site

génèrera un site de documentation dans le sous-répertoire `target/site`.

=== Les phases

https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html[Introduction]