Modèle de projet Maven

Maven utilise des archétypes pour créer des structures de projet personnalisées, formant des modèles de projet Maven.

Dans les chapitres précédents, nous avons appris que Maven utilise la commande suivante pour créer rapidement un projet Java :

mvn archetype:generate

Qu'est-ce qu'un archétype ?

Un archétype est un prototype, un plugin Maven, ou plus précisément un modèle de projet. Sa tâche est de créer une structure de projet basée sur un modèle. Nous utiliserons le plugin d'archétype quickstart pour créer une application Java simple.


Utilisation des modèles de projet

Ouvrons la console de commande, naviguons vers le répertoire C:\> MVN et exécutons la commande mvn suivante :

C:\MVN> mvn archetype:generate 

Maven commencera le traitement et vous demandera de sélectionner l'archétype souhaité :

[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'archetype'.
[INFO] -------------------------------------------------------------------
[INFO] Building Maven Default Project
[INFO]task-segment: [archetype:generate] (aggregator-style)
[INFO] -------------------------------------------------------------------
[INFO] Preparing archetype:generate
...
600: remote -> org.trailsframework:trails-archetype (-)
601: remote -> org.trailsframework:trails-secure-archetype (-)
602: remote -> org.tynamo:tynamo-archetype (-)
603: remote -> org.wicketstuff.scala:wicket-scala-archetype (-)
604: remote -> org.wicketstuff.scala:wicketstuff-scala-archetype 
Basic setup for a project that combines Scala and Wicket,
depending on the Wicket-Scala project. 
Includes an example Specs test.)
605: remote -> org.wikbook:wikbook.archetype (-)
606: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-glassfish (-)
607: remote -> org.xaloon.archetype:xaloon-archetype-wicket-jpa-spring (-)
608: remote -> org.xwiki.commons:xwiki-commons-component-archetype 
(Make it easy to create a maven project for creating XWiki Components.)
609: remote -> org.xwiki.rendering:xwiki-rendering-archetype-macro 
(Make it easy to create a maven project for creating XWiki Rendering Macros.)
610: remote -> org.zkoss:zk-archetype-component (The ZK Component archetype)
611: remote -> org.zkoss:zk-archetype-webapp (The ZK wepapp archetype)
612: remote -> ru.circumflex:circumflex-archetype (-)
613: remote -> se.vgregion.javg.maven.archetypes:javg-minimal-archetype (-)
614: remote -> sk.seges.sesam:sesam-annotation-archetype (-)
Choose a number or apply filter 
(format: [groupId:]artifactId, case sensitive contains): 203:

Appuyez surEntréeChoisissez l'option par défaut (203:maven-archetype-quickstart).


Maven vous demandera la version de l'archétype

Choose org.apache.maven.archetypes:maven-archetype-quickstart version:
1: 1.0-alpha-1
2: 1.0-alpha-2
3: 1.0-alpha-3
4: 1.0-alpha-4
5: 1.0
6: 1.1
Choose a number: 6:

Appuyez surEntréeChoisissez l'option par défaut (6:maven-archetype-quickstart:1.1)

Maven vous demandera les détails du projet. Saisissez les détails du projet comme demandé. Si vous souhaitez utiliser les valeurs par défaut, appuyez simplement sur Entrée. Vous pouvez également saisir vos propres valeurs.

Define value for property 'groupId': : com.companyname.insurance
Define value for property 'artifactId': : health
Define value for property 'version': 1.0-SNAPSHOT
Define value for property 'package': com.companyname.insurance

Maven vous demandera de confirmer les détails du projet, appuyez surEntréeou appuyez sur Y

Confirm properties configuration:
groupId: com.companyname.insurance
artifactId: health
version: 1.0-SNAPSHOT
package: com.companyname.insurance
Y:

Maintenant, Maven va commencer à créer la structure du projet, comme indiqué ci-dessous :

[INFO] -----------------------------------------------------------------------
[INFO] Using following parameters for creating project 
from Old (1.x) Archetype: maven-archetype-quickstart:1.1
[INFO] -----------------------------------------------------------------------
[INFO] Parameter: groupId, Value: com.companyname.insurance
[INFO] Parameter: packageName, Value: com.companyname.insurance
[INFO] Parameter: package, Value: com.companyname.insurance
[INFO] Parameter: artifactId, Value: health
[INFO] Parameter: basedir, Value: C:\MVN
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] project created from Old (1.x) Archetype in dir: C:\MVN\health
[INFO] -----------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] -----------------------------------------------------------------------
[INFO] Total time: 4 minutes 12 seconds
[INFO] Finished at: Fri Jul 13 11:10:12 IST 2012
[INFO] Final Memory: 20M/90M
[INFO] -----------------------------------------------------------------------

Le projet créé

Maintenant, allez dans le répertoire C:\ > MVN. Vous verrez un projet d'application Java nommé health, correspondant à l'artifactId défini lors de la création du projet. Maven créera un projet avec une structure de répertoires standard, comme indiqué ci-dessous :


Création de pom.xml

Maven génère automatiquement un fichier pom.xml pour le projet, comme indiqué ci-dessous :

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.companyname.insurance</groupId> <artifactId>health</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>health</name> <url>http://maven.apache.org</url> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dépendance> </dépendances> </projet>

App.java

Maven générera automatiquement un fichier Java de test, App.java.

Chemin :C:\MVN\consumerBanking\src\main\java\com\companyname\bank

package com.companyname.insurance; /** * Bonjour le monde ! * */ public class App { public static void main( String[] args ) { System.out.println( "Hello World!" ); } }

AppTest.java

Maven générera automatiquement un fichier Java, AppTest.java.

Le chemin est :C:\MVN\consumerBanking\src\test\java\com\companyname\bank

package com.companyname.insurance; import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; /** * Test unitaire pour l'application simple. */ public class AppTest extends TestCase { /** * Créer le cas de test * * @param testName nom du cas de test */ public AppTest( String testName ) { super( testName ); } /** * @return la suite de tests en cours de test */ public static Test suite() { return new TestSuite( AppTest.class ); } /** * Test rigoureux :-) */ public void testApp() { assertTrue( vrai ); } }

C'est tout. Maintenant, vous pouvez voir la puissance de Maven. Vous pouvez utiliser de simples commandes Maven pour créer n'importe quel type de projet et commencer votre développement.

Autres extensions