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
public class App {
public static void main(String[] args) {
System.out.println("Hello Maven!");
}
}
Classe de test AppTest.java:
Exemple
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
| Commande | Objectif |
|---|---|
mvn compile | Compiler le code source |
mvn test | Exécuter les tests |
mvn package | Package (génère.jarfichier) |
mvn install | Installer dans le dépôt local (pour que d'autres projets puissent en dépendre) |
mvn clean | Propretargetré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
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é
Créer un projet:
mvn archetype:generateGénérer une structure standard.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.
Commandes de construction:
mvn compile→mvn test→mvn package。
Exécutez:
java -jaroujava -cpExecute.jarfichier.