Первый проект Maven
Создание проекта Maven
Создание проекта с помощью Maven Archetype
Maven предоставляет шаблоны проектов (архетипы) для быстрого создания стандартной структуры проекта. Наиболее часто используется maven-archetype-quickstart (базовый шаблон Java-проекта).
Выполните команду:
mvn archetype:generate \
-DgroupId=com.example \
-DartifactId=my-first-app \
-DarchetypeArtifactId=maven-archetype-quickstart \
-DinteractiveMode=false
Описание параметров:
| Параметр | Описание |
|---|---|
-DgroupId |
Название организации (например, домен компании в обратном порядке) |
-DartifactId |
Название проекта (становится именем папки проекта) |
-DarchetypeArtifactId |
Используемый шаблон (quickstartпредставляет собой базовый Java-проект) |
-DinteractiveMode=false |
Неинтерактивный режим (без ручного подтверждения) |
Структура проекта, созданная после выполнения:
my-first-app/ ├── pom.xml # Maven 项目配置文件 ├── src/ │ ├── main/ # 主代码目录 │ │ └── java/ # Java 源代码 │ │ └── com/example/App.java # 自动生成的示例类 │ └── test/ # 测试代码目录 │ └── java/ # 测试类 │ └── com/example/AppTest.java # 自动生成的测试类
Анализ структуры проекта
Подробное объяснение pom.xml
Это основной конфигурационный файл Maven, определяющий базовую информацию о проекте и зависимости.
Пример сгенерированного pom.xml:
<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>
Структура исходного кода
| Каталог | Назначение |
|---|---|
src/main/java |
Основной исходный код Java |
src/main/resources |
Файлы конфигурации (например,application.properties) |
src/test/java |
Тестовый код |
src/test/resources |
Тестовые файлы ресурсов |
Пример кода:
Главный класс App.java
Пример
public class App {
public static void main(String[] args) {
System.out.println("Привет, Maven!");
}
}
Тестовый класс AppTest.java:
Пример
import org.junit.Test;
import static org.junit.Assert.*;
public class AppTest {
@Test
public void testApp() {
assertTrue(true); // Пример теста
}
}
Сборка и запуск
Основные команды Maven
| Команда | Назначение |
|---|---|
mvn compile | Скомпилировать исходный код |
mvn test | Запустить тесты |
mvn package | Package (генерирует.jarфайла) |
mvn install | Установить в локальный репозиторий (чтобы другие проекты могли зависеть от него) |
mvn clean | Очисткаtargetкаталога |
Полный процесс сборки
1. Скомпилируйте проект:
mvn compile
Скомпилированные файлы .class будут помещены в каталог target/classes.
2. Запустите тесты:
mvn test
Выполните тестовые классы в src/test/java.
Отчёты о тестах генерируются в target/surefire-reports.3. Соберите пакет:
mvn package
Создаёт target/my-first-app-1.0-SNAPSHOT.jar.
4. Запустите программу:
java -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App
5. Вывод:
Hello Maven!
Расширение: изменение проекта
Добавление зависимостей
Например, добавьтеGsonдля обработки JSON:
Измените 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>Запустите mvn compile, Maven автоматически загрузит Gson.
Измените главный класс, чтобы использовать Gson
Пример
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);
}
}
Пересоберите и запустите:
mvn package java -cp target/my-first-app-1.0-SNAPSHOT.jar com.example.App
Вывод:
"Hello Maven with Gson!"
Типичные проблемы
Ошибка загрузки зависимости
Причина: проблема с сетью или репозиторий недоступен.
Решение:
Проверьте подключение к сети.
Настройте локальный зеркальный репозиторий (например, Alibaba Cloud):
<!-- 在 settings.xml 或 pom.xml 中配置 -->
<mirror>
<id>aliyun</id>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
Введение в репозиторий Alibaba Cloud:https://developer.aliyun.com/mvn/guide。
Проблема с версией компиляции
Ошибка: javac: invalid target release: 11
Решение: укажите версию Java в pom.xml:
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
</properties>
Итог
Создать проект:
mvn archetype:generateСгенерировать стандартную структуру.Структура проекта:
pom.xmlОпределите зависимости и конфигурацию.src/main/javaПоместите основной код,src/test/javaПоместите тестовый код.
Команды сборки:
mvn compile→mvn test→mvn package。
Запустите:
java -jarилиjava -cpExecute.jarфайл.