Premier projet Maven

Créer un projet Maven

Générer un projet à l'aide d'un archétype Maven

Maven fournit des modèles de projet (archétypes) pour générer rapidement une structure de projet standard. Le plus couramment utilisé est maven-archetype-quickstart (modèle de projet Java de base).

Exécutez la commande :

mvn archetype:generate \
    -DgroupId=com.example \
    -DartifactId=my-first-app \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DinteractiveMode=false

Description des paramètres :

Paramètre Description
-DgroupId Nom de l'organisation (par exemple, domaine de l'entreprise inversé)
-DartifactId Nom du projet (devient le nom du dossier du projet)
-DarchetypeArtifactId Le modèle utilisé (quickstartest un projet Java de base)
-DinteractiveMode=false Mode non interactif (éviter la confirmation manuelle)

La structure du projet générée après exécution :

my-first-app/
├── pom.xml           # Maven 项目配置文件
├── src/
│   ├── main/         # 主代码目录
│   │   └── java/     # Java 源代码
│   │       └── com/example/App.java  # 自动生成的示例类
│   └── test/        # 测试代码目录
│       └── java/     # 测试类
│           └── com/example/AppTest.java  # 自动生成的测试类

Analyse de la structure du projet

Explication détaillée du pom.xml

Il s'agit du fichier de configuration principal de Maven, définissant les informations de base et les dépendances du projet.

Exemple du pom.xml généré :

<project>
    <!-- POM 模型版本,固定 4.0.0 -->
    <modelVersion>4.0.0</modelVersion>

    <!-- 项目坐标(唯一标识) -->
    <groupId>com.example</groupId>
    <artifactId>my-first-app</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 项目打包方式(默认 jar,也可以是 war、pom 等) -->
    <packaging>jar</packaging>

    <!-- 项目名称和 URL(可选) -->
    <name>my-first-app</name>
    <url>http://www.example.com</url>

    <!-- 依赖管理 -->
    <dependencies>
        <!-- JUnit 测试依赖 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>  <!-- 仅用于测试 -->
        </dependency>
    </dependencies>
</project>

Structure du code source

Répertoire Objectif
src/main/java Code source Java principal
src/main/resources Fichiers de configuration (tels queapplication.properties)
src/test/java Code de test
src/test/resources Fichiers de ressources de test

Exemple de code :

Classe principale App.java

Exemple

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello Maven!");
    }
}

Classe de test AppTest.java:

Exemple

package com.example;

import org.junit.Test;
import static org.junit.Assert.*;

public class AppTest {
    @Test
    public void testApp() {
        assertTrue(true);  // Exemple de test
    }
}

Compilation et exécution

Commandes Maven courantes

CommandeObjectif
mvn compileCompiler le code source
mvn testExécuter les tests
mvn packagePackage (génère.jarfichier)
mvn installInstaller dans le dépôt local (pour que d'autres projets puissent en dépendre)
mvn cleanPropretargetrépertoire

Processus de construction complet

1. Compiler le projet :

mvn compile

Les fichiers .class compilés seront placés dans le répertoire target/classes.

2. Exécuter les tests :

mvn test

Exécuter les classes de test dans src/test/java.

Les rapports de tests sont générés dans target/surefire-reports.

3. Empaqueter :

mvn package

Génère target/my-first-app-1.0-SNAPSHOT.jar.

4. Exécuter le programme :

java -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App

5. Sortie :

Hello Maven!

Extension : Modification du projet

Ajout de dépendances

Par exemple, ajoutezGsonpour le traitement JSON :

Modifiez pom.xml :

<dependencies>
    <!-- 原有 JUnit 依赖 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>

    <!-- 新增 Gson 依赖 -->
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.8.9</version>
    </dependency>
</dependencies>

Exécutez mvn compile, Maven téléchargera automatiquement Gson.

Modifiez la classe principale pour utiliser Gson

Exemple

package com.example;

import com.google.gson.Gson;

public class App {
    public static void main(String[] args) {
        Gson gson = new Gson();
        String json = gson.toJson("Hello Maven with Gson!");
        System.out.println(json);
    }
}

Réempaquetez et exécutez :

mvn package
java -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App

Sortie :

"Hello Maven with Gson!"

Problèmes courants

Échec du téléchargement des dépendances

Cause : problème de réseau ou dépôt indisponible.

Solution :

Vérifiez la connexion réseau.

Configurez un dépôt miroir local (par ex., Alibaba Cloud) :

<!-- 在 settings.xml 或 pom.xml 中配置 -->
<mirror>
    <id>aliyun</id>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
</mirror>

Présentation du dépôt Alibaba Cloud :https://developer.aliyun.com/mvn/guide。

Problème de version de compilation

Erreur : javac : version cible non valide : 11

Solution : spécifier la version de Java dans pom.xml :

<properties>
    <maven.compiler.source>11</maven.compiler.source>
    <maven.compiler.target>11</maven.compiler.target>
</properties>

Résumé

  1. Créer un projet:mvn archetype:generateGénérer une structure standard.

  2. Structure du projet:

    • pom.xmlDéfinir les dépendances et la configuration.

    • src/main/javaPlacer le code principal,src/test/javaPlacer le code de test.

  3. Commandes de construction:

    • mvn compile → mvn test → mvn package。

  4. Exécutez:java -jaroujava -cpExecute.jarfichier.

Autres extensions