[TOC]

Maven 入门

介绍

Maven 是Java项目的自动化构建工具，依托于项目对象模型POM(即Project Object Model)，为项目的全生命周期管理提供全方位支持。

官网下载并安装

Download Apache Maven

Windows 选择 Binary zip archive 下载apache-maven-x.x.x-bin.zip

解压压缩包并安装到指定目录，比如 Windows 可以解压安装到 "D:\Program\apache-maven-x.x.x\"

P.S. 其中 x.x.x 是版本号，下同

配置环境变量

Windows 桌面右键 “此电脑”，选择 “属性”，之后点击 “高级系统设置”，选择 “环境变量”

① 先新建系统变量MAVEN_HOME

  • 变量名 MAVEN_HOME

  • 变量值 D:\Program\apache-maven-x.x.x

P.S. 从 Maven 3.5.0 起，M2_HOME已废弃使用

② 再编辑系统变量Path,添加

  • 变量值 %MAVEN_HOME%\bin

③ 检查 Maven 是否安装成功

Win+R 输入cmd回车 或 Win+R 输入powershell回车

1
mvn -version

安装目录结构

bin

存放 Maven 的可执行文件

  • mvn 和 mvn.cmd：用于执行Maven构建命令来完成编译、测试、打包、部署等操作的脚本
  • mvnDebug 和 mvnDebug.cmd：用于以调试模式启动 Maven 构建过程的脚本

boot

存放 Maven 启动时所需的类加载器相关的 JAR 文件

  • plexus-classworlds-x.x.x.jar：用于实现类加载隔离机制的一个 Java 类库

conf

存放 Maven 的配置文件

  • settings.xml：Maven 的全局配置文件。全局级配置在 Maven 安装目录的conf文件夹下，用户级配置在用户目录下的.m2文件夹里，用户级配置会覆盖全局级配置
  • toolchains.xml： 工具链配置文件，用于解决在项目构建过程中对不同版本工具（如 JDK、Ant 等）的使用需求
  • logging：日志配置文件，用于控制 Maven 构建过程中的日志输出级别和格式

lib

存放 Maven 运行时所依赖的各种 Java 类库（JAR 文件）

配置settings.xml

配置本地仓库 LocalRepository

本地仓库默认位置在：C:/Users/当前用户名/.m2/repository

先在 Maven 安装目录下新建repo文件夹,然后编辑settings.xml文件

1
2
3
<settings>
    <localRepository>D:\Program\apache-maven-x.x.x\repo</localRepository>
</settings>

配置阿里云 Maven 镜像

1
2
3
4
5
6
7
8
9
10
<settings>
    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <mirrorOf>*</mirrorOf>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>
  • <id>：镜像仓库唯一标识符，用于区分不同的镜像配置
  • <name>：镜像仓库描述性名称
  • <url>：镜像仓库 URL 地址
  • <mirrorOf>：指定代理的远程仓库，* 表示替代所有仓库

请参考：阿里云 Maven 仓库

IntelliJ IDEA 配置 Maven

IntelliJ IDEA 每次打开一个项目后，文件==>设置==>构建、执行、部署==>构建工具==>Maven，选择好Maven主路径后勾选用户设置文件和本地仓库的重写还有使用.mvn/maven.config中的设置

1
2
3
4
用户设置文件：
D:\Program\apache-maven-x.x.x\conf\settings.xml
本地仓库：
D:\Program\apache-maven-x.x.x\repo

每次创建并打开新的 Maven 项目后，项目都需要重新这样配置，其实有个方法，如下：
文件==>关闭项目==>自定义==>所有设置==>构建、执行、部署==>构建工具==>Maven，选择好Maven主路径后勾选用户设置文件和本地仓库的重写还有使用.mvn/maven.config中的设置

最后控制台输出系统属性和环境变量信息
Win+R 输入cmd回车 或 Win+R 输入powershell回车

1
mvn help:system

IntelliJ IDEA 使用模板 archetype 创建 Maven 项目

Maven 项目模板 archetype 推荐：
① maven-archetype-quickstart
② maven-archetype-webapp

文件==>新建==>项目==>Maven Archetype
填写项目信息并选择合适模板后创建

Maven 标准项目目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Maven 项目名
├── pom.xml
├── src
│   ├── main
│   │   ├── java
│   │   ├── resources
│   │   └── webapp
│   │       ├── index.jsp
│   │       └── WEB-INF
│   │           ├── lib
│   │           └── web.xml
│   └── test
│       ├── java
│       └── resources
└── target
    ├── classes
    └── test-classes

项目配置文件pom.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<!-- XML 命名空间和模式声明 -->
<project xmlns = "http://maven.apache.org/POM/4.0.0"
    xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation = "http://maven.apache.org/POM/4.0.0
    http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <!-- 指定 POM 模型版本 -->
    <modelVersion>4.0.0</modelVersion>
    <!-- 项目的组 ID，项目所属的组织或公司，一般采用反向域名的形式 -->
    <groupId>com.companyname.project-group</groupId>
    <!-- 项目的 artifact ID，项目的唯一标识符，一个groupId下面可能多个artifactId -->
    <artifactId>project</artifactId>
    <!-- 项目打包方式 -->
    <packaging>war</packaging>
    <!-- 项目版本号 -->
    <version>1.0</version>
    <!-- 项目名称 -->
    <name>MavenProject</name>
    <!-- 项目描述 -->
    <description>This is a Maven project.</description>
    
    <!-- 项目所需的各种依赖项 -->
    <dependencies>
        <!-- https://mvnrepository.com/artifact/jakarta.servlet/jakarta.servlet-api -->
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.1.0</version>
        </dependency>
    </dependencies>

    <!-- 项目构建配置 -->
    <build>
        <!-- 指定最终生成的项目打包文件的名称 -->
        <finalName>MavenProject</finalName>
        <!-- 项目构建过程中所需的各种插件 -->
        <plugins>
            <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.1</version>
                    <configuration>
                        <source>1.8</source>
                        <target>1.8</target>
                    </configuration>
                </plugin>
        </plugins>
    </build>

    <!-- 项目属性 -->
    <properties>
        <!-- 指定 Java 源代码和编译生成字节码的版本 -->
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

</project>

请参考：

POM Reference

Maven Repository

Available Plugins

P.S. 2017 年，Oracle 把 JavaEE 移交给了 Eclipse 基金会。不过，由于“Java”这一名称的商标权归 Oracle 持有，Eclipse 基金会后续不能再沿用 javax.* 和 java.* ，在此背景下，项目正式更名为 Jakarta EE。

Maven 生命周期

clean 生命周期

clean
（清理）

default 生命周期

validate==>compile==>test==>package==>verify==>install==>deploy
（验证==>编译==>测试==>打包==>验证==>安装==>部署）

site 生命周期

site和site-deploy
（站点生成和站点部署）

Maven 常见命令

清除项目构建产生的文件与目录

1
mvn clean

验证项目是否正确，并且所有必要的信息是否可用

1
mvn validate

编译项目源代码

1
mvn compile

运行项目单元测试

1
mvn test

把编译后的代码打包成可分发的格式，例如 JAR 或 WAR

1
mvn package

进行额外的检查以确保质量,例如集成测试

1
mvn verify

将打好的包安装到本地 Maven 仓库

1
mvn install

把打好的包发布到远程 Maven 仓库

1
mvn deploy

为项目生成站点文档

1
mvn site

为项目生成站点文档并发布到远程服务器

1
mvn site-deploy