Maven 构建 Java 项目

简介

Maven 是一个基于项目对象模型（POM）的构建工具。它可以帮助我们管理项目的依赖、编译、测试、打包、部署等任务。使用 Maven 可以使 Java 项目的构建和管理更加易于操作和规范化。

安装

Maven 的安装非常简单。我们只需要在 Maven 官网下载最新版本的 Maven 安装文件，并解压到本地目录。然后将 Maven 的 bin 目录（example：/usr/local/maven/apache-maven-x.x.x/bin）添加到系统 PATH 环境变量中，即可在命令行中使用 mvn 命令。

配置

在使用 Maven 前，我们需要对其进行一些基本的配置。在 Maven 的安装目录下存在一个 conf 目录，进入该目录会发现有一个 settings.xml 文件。Maven 的全局配置文件就是这个文件。我们可以在该文件中做一些配置。

配置本地仓库

本地仓库是 Maven 存放依赖项的地方，通常位于本地文件系统上。可以通过在 settings.xml 文件中设置以下属性来配置本地仓库：

<settings>
  <localRepository>/path/to/local/repo</localRepository>
</settings>

指定代理

如果你在公司内部使用 Maven ，会发现下载速度很慢，设置代理有利于加速 Maven 的下载。可以在 settings.xml 文件中设置代理：

<settings>
  <proxies>
    <proxy>
      <id>example-proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>proxypass</password>
      <nonProxyHosts>localhost|*.example.com</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

创建项目

在 Maven 中，我们使用 Maven Archetype 创建项目模板。Archetype 是 Maven 自带的项目模板工具。有许多预先定义好的模板，例如 Java 应用程序，Web 应用程序等。

生成项目模板

我们可以使用以下命令在命令行中使用 Archetype 工具来生成项目模板：

mvn archetype:generate

然后会出现许多选项，比如 groupId、artifactId、version、package 等。依据实际情况输入即可创建项目。

目录结构

Maven 采用标准的目录结构组织项目，其目录结构如下：

src/main/java：Java 代码目录
src/main/resources ：资源文件目录
src/test/java ：测试代码目录
src/test/resources ：测试资源文件目录
pom.xml ：项目的 POM 文件

POM 文件

POM（Project Object Model）是 Maven 的核心，它是一个 XML 文件，描述了项目的基本信息、构建设置和依赖项等。

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>my-app</artifactId>
  <version>1.0.0-SNAPSHOT</version>
  <dependencies>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>5.7.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

其中，groupId、artifactId、version 是项目的基本信息。dependencies 标签中则包含了项目依赖项。

使用 Maven 构建项目

Maven 的目标是简化项目构建，我们只需在项目根目录下运行以下命令即可：

mvn clean package

clean：清理 target 目录下的内容
package：打包项目为 jar（或 war）文件

执行以上命令后，便会在 target 目录下生成相应的 jar 包文件。

总结

Maven 是一种在项目开发过程中管理构建、文档描述信息和项目报告的工具。它能够使我们更高效地构建和管理 Java 项目。同时，Maven 也提供了强大的模板工具和标准的目录结构，能够帮助我们更好地组织和维护项目。

Maven 构建 & 项目测试 Maven 构建生命周期