Первый проект 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

Пример

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Привет, Maven!");
    }
}

Тестовый класс AppTest.java:

Пример

package com.example;

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

public class AppTest {
    @Test
    public void testApp() {
        assertTrue(true);  // Пример теста
    }
}

Сборка и запуск

Основные команды Maven

КомандаНазначение
mvn compileСкомпилировать исходный код
mvn testЗапустить тесты
mvn packagePackage (генерирует.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

Пример

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);
    }
}

Пересоберите и запустите:

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>

Итог

  1. Создать проект:mvn archetype:generateСгенерировать стандартную структуру.

  2. Структура проекта:

    • pom.xmlОпределите зависимости и конфигурацию.

    • src/main/javaПоместите основной код,src/test/javaПоместите тестовый код.

  3. Команды сборки:

    • mvn compile → mvn test → mvn package。

  4. Запустите:java -jarилиjava -cpExecute.jarфайл.

Другие расширения