Maven 构建分发包与依赖管理

Maven 是 Java 开发中广泛使用的构建和依赖管理工具，它不仅能帮助开发者高效地构建项目，还提供了强大的 依赖管理 和 版本控制 功能。通过 Maven，你可以轻松地构建并发布 JAR、WAR 等分发包，并管理不同版本的依赖。

本文将讲解如何使用 Maven 构建并发布 JAR/WAR 包，以及如何管理不同的发布版本，包括如何配置发布仓库、版本号管理和依赖范围。

1. Maven 构建分发包（JAR/WAR）

1.1 JAR 包构建

在 Maven 中，JAR 包通常用于 库 和 工具类 的打包。要构建 JAR 包，需要在 pom.xml 文件中设置相关的构建配置。

JAR 包构建配置

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifestEntries>
                        <Main-Class>com.example.Main</Main-Class> <!-- 设置主类 -->
                    </manifestEntries>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>

构建命令

mvn clean package

这条命令将生成 target/ 目录下的 my-app-1.0-SNAPSHOT.jar 文件。

1.2 WAR 包构建

WAR 包用于 Web 应用 的打包，通常包括 HTML、CSS、JS 文件 以及 Servlets、JSP 等 Web 组件。构建 WAR 包时，Maven 会自动将应用和依赖打包到一个可部署的 WAR 文件中。

WAR 包构建配置

<build>
    <finalName>my-web-app</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.1</version>
            <configuration>
                <webXml>src/main/webapp/WEB-INF/web.xml</webXml> <!-- 配置 Web.xml 文件 -->
            </configuration>
        </plugin>
    </plugins>
</build>

构建命令

mvn clean package

这条命令将生成 target/ 目录下的 my-web-app.war 文件。

1.3 构建多模块项目的分发包

在多模块 Maven 项目中，父模块通常不会直接生成 JAR 或 WAR 文件，而是通过子模块构建相应的分发包。

父模块的 pom.xml：

<modules>
    <module>module1</module>
    <module>module2</module>
</modules>

子模块（module1/pom.xml）：

<packaging>jar</packaging> <!-- 子模块构建 JAR 包 -->

子模块（module2/pom.xml）：

<packaging>war</packaging> <!-- 子模块构建 WAR 包 -->

通过 mvn clean install，父模块将自动构建所有子模块，并生成对应的 JAR 和 WAR 包。

2. 发布 JAR/WAR 包

2.1 配置 Maven 仓库

在 Maven 中，发布 JAR/WAR 包通常是通过上传到 远程仓库 来完成的。常见的远程仓库包括 Maven Central 和 私有仓库（如 Nexus、Artifactory）。

2.1.1 配置发布仓库

首先，确保在 pom.xml 中配置了远程仓库的信息：

<distributionManagement>
    <repository>
        <id>nexus-repository</id>
        <url>http://nexus.company.com/repository/maven-releases/</url>
    </repository>
    <snapshotRepository>
        <id>nexus-snapshot-repository</id>
        <url>http://nexus.company.com/repository/maven-snapshots/</url>
    </snapshotRepository>
</distributionManagement>

2.1.2 配置 Maven settings.xml 文件

在 Maven 的 settings.xml 文件中，配置你的远程仓库的凭证信息。该文件通常位于 ~/.m2/settings.xml。

<servers>
    <server>
        <id>nexus-repository</id>
        <username>your_username</username>
        <password>your_password</password>
    </server>
</servers>

2.1.3 使用 mvn deploy 发布到远程仓库

通过 mvn deploy 命令，可以将构建好的 JAR 或 WAR 包上传到远程仓库。

mvn clean deploy

此命令会将构建的包上传到远程仓库的 releases 或 snapshots 部分，取决于版本号。如果版本号是 SNAPSHOT，则上传到 snapshots 仓库，否则上传到 releases 仓库。

3. Maven 依赖管理与版本管理

3.1 依赖管理

Maven 依赖管理是 Maven 项目中的核心功能之一，它帮助开发者轻松管理项目中的各种依赖，包括第三方库和模块。

3.1.1 在 pom.xml 中声明依赖

在 pom.xml 中，依赖项通过 <dependencies> 元素声明。例如，声明一个 Spring Boot Web 依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.5.0</version>
    </dependency>
</dependencies>

3.1.2 版本范围

Maven 允许使用版本范围来指定依赖的版本。例如，指定一个版本范围，允许 1.0.0 到 2.0.0 的版本：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>example-lib</artifactId>
    <version>[1.0.0,2.0.0)</version>
</dependency>

Maven 会自动选择符合版本范围的最新版本进行构建。

3.2 依赖版本管理

在多模块项目中，父 POM 文件可以使用 <dependencyManagement> 来统一管理所有子模块的依赖版本，避免版本冲突。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>5.3.9</version>
        </dependency>
    </dependencies>
</dependencyManagement>

子模块可以在自己的 pom.xml 中直接引用依赖，而无需指定版本：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
</dependency>

4. Maven 发布不同版本

4.1 发布 SNAPSHOT 版本与发布版本

• SNAPSHOT 版本：用于开发过程中，表示尚未稳定的版本。SNAPSHOT 版本通常用于测试，且可以反复更新。
  • 例如：1.0.0-SNAPSHOT
• 正式发布版本：代表经过测试和验证的稳定版本，适用于生产环境。
  • 例如：1.0.0

4.1.1 发布 SNAPSHOT 版本

SNAPSHOT 版本通常用于持续开发和集成测试。当我们上传 SNAPSHOT 版本时，Maven 会在仓库中保留一个最新版的 SNAPSHOT。

mvn deploy -Dversion=1.0.0-SNAPSHOT

4.1.2 发布正式版本

发布正式版本时，Maven 会确保该版本不被再次更新。

mvn deploy -Dversion=1.0.0

5. 总结

• 构建 JAR/WAR 包：使用 Maven 构建 JAR 或 WAR 文件，并通过 mvn clean package 命令生成分发包。
• 发布 JAR/WAR 包：通过配置远程仓库和 mvn deploy 命令，将构建的包发布到远程仓库（如 Nexus、Maven Central）。
• 依赖管理：通过 Maven 的 dependencyManagement 和版本范围来管理项目中的依赖版本，避免版本冲突。
• SNAPSHOT 和发布版本：通过 Maven 管理不同版本的依赖，并使用 SNAPSHOT 和正式版本来区分开发中的版本和生产版本。

Maven 提供了强大的构建和发布管理功能，通过合理配置和使用 Maven，能够帮助开发者更高效地