Maven 学习整理

1. Maven 简介

Maven 是 Apache 基金会推出的一个用于管理和构建 Java 项目的工具。它基于项目对象模型 (Project Object Model , 简称: POM) 的概念，通过描述项目的依赖、结构、生命周期等，简化项目管理。

官网： https://maven.apache.org/

1.1 Maven 的主要功能

1.1.1 依赖管理

自动管理项目所需的 jar 包，避免版本冲突。

若没有通过maven进行大型项目的依赖管理，我们在开发项目时，需要引入大量的jar包。那么此时，jar包和jar包之间很多时候是需要版本匹配的，如果版本不匹配，此时很容易出现版本冲突问题。

1.1.2 统一项目结构

为项目提供统一的目录结构，便于跨平台、跨 IDE 的开发。

src/main/java: java 源代码目录

src/main/resources: 配置文件信息

src/test/java: 测试代码

src/test/resources: 测试配置文件信息

1.1.3 项目构建

通过标准化的命令如 `compile`、`test`、`package` 等，实现标准的、跨平台(Linux、Windows、MacOS) 的自动化构建流程。

2. Maven 模型和仓库

2.1 Maven 模型

Maven 的核心是基于 POM 模型，它定义了项目的结构、依赖和构建过程，主要包括：

2.1.1 项目对象模型 (POM)

描述项目的关键信息及其依赖。

以上图中紫色框起来的部分属于项目对象模型，就是将我们自己的项目抽象成一个对象模型，有自己专属的坐标，如下图所示是一个Maven项目：

坐标：就是资源(jar包)的唯一标识，通过坐标可以定位到所需资源(jar包)位置。

举例：

2.1.2 依赖管理模型(Dependency)

使用坐标（groupId、artifactId、version）来定位和管理项目所依赖的第三方库。

2.1.3 构建生命周期(Build lifecycle & phases)

提供一系列标准化的构建阶段，如清理、编译、测试、打包等。

以上图中紫色框起来的部分，就是用来完成标准化构建流程。当我们需要编译，Maven提供了一个编译插件供我们使用；当我们需要打包，Maven就提供了一个打包插件供我们使用等。

2.2 Maven 仓库

之前我们项目中需要jar包时，直接就把jar包复制到项目下的lib目录，而现在书写在pom.xml文件中的坐标又是怎么能找到所要的jar包文件的呢？通过Maven仓库。

Maven 仓库是存储项目依赖（jar 包）的地方，本质就是一个目录(文件夹)，这个目录被用来存储开发中所有依赖(就是jar包)和插件，分为三类：

2.2.1 本地仓库

自己计算机上的一个目录(用来存储jar包)。

2.2.2 中央仓库

由 Maven 团队维护的全球仓库，地址为 `https://repo1.maven.org/maven2/`。

2.2.3 远程仓库

如公司内部搭建的私有仓库，也可以使用阿里云的 Maven 私服。

当项目中使用坐标引入对应依赖jar包后，首先会查找本地仓库中是否有对应的jar包，如果有，则在项目直接引用；如果没有，则去中央仓库中下载对应的jar包到本地仓库；如果还可以搭建远程仓库(私服)，将来jar包的查找顺序则变为：本地仓库 --> 远程仓库--> 中央仓库。

3. POM 文件详解

POM (Project Object Model) ：指的是项目对象模型，用来描述当前的maven项目，使用pom.xml文件来实现。

pom.xml文件：

<?xml version="1.0" encoding="UTF-8"?>
<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>

    <!-- 当前项目坐标 -->
    <!-- groupId：定义当前Maven项目隶属组织名称（通常是域名反写，例如：com.cyt） -->
    <!-- artifactId：定义当前Maven项目名称（通常是模块名称） -->
    <!-- version：定义当前项目版本号 -->
    <groupId>com.itheima</groupId>
    <artifactId>maven_project1</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 打包方式 -->
    <!-- maven项目的打包方式，通常设置为jar或war（默认值：jar）-->
    <packaging>jar</packaging>
</project>

3.1 依赖配置

依赖：指当前项目运行所需要的jar包。一个项目中可以引入多个依赖。

例如：在当前工程中，我们需要用到logback来记录日志，此时就可以在maven工程的pom.xml文件中，引入logback的依赖。具体步骤如下：

（1）在pom.xml中编写标签

（2）在标签中使用引入坐标

（3）定义坐标的 groupId、artifactId、version

<dependencies>
    <!-- 第1个依赖 : logback -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.11</version>
    </dependency>
    <!-- 第2个依赖 : junit -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
</dependencies>

（4）点击刷新按钮，引入最新加入的坐标

搜索依赖的几种方式

（1）利用中央仓库搜索的依赖坐标

（2）利用IDEA工具搜索依赖

3.2 依赖传递

3.3.1 依赖具有传递性

没有使用maven时，向项目中添加依赖的jar包，需要把所有的jar包都复制到项目工程下。如果需要logback-classic时，由于logback-classic又依赖了logback-core和slf4j，所以必须把这3个jar包全部复制到项目工程下。

使用了maven，当项目中需要使用logback-classic时，只需要在pom.xml配置文件中，添加logback-classic的依赖坐标即可。

在pom.xml文件中只添加了logback-classic依赖，但由于maven的依赖具有传递性，所以会自动把

所依赖的其他jar包也一起导入。

依赖传递可以分为：

直接依赖：在当前项目中通过依赖配置建立的依赖关系

间接依赖：被依赖的资源如果依赖其他资源，当前项目间接依赖其他资源

projectA依赖了projectB。对于projectA 来说，projectB 就是直接依赖。而projectB依赖了projectC及其他jar包。那么此时，在projectA中也会将projectC的依赖传递下来。对于projectA 来说，projectC就是间接依赖。

3.3.2 排除依赖

依赖具有传递性。那么A依赖B，B依赖C，如果A不想将C依赖进来，是否可以做到？在maven项目中，我们可以通过排除依赖来实现。

被排除的资源无需指定版本。

<dependency>
    <groupId>com.itheima</groupId>
    <artifactId>maven-projectB</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--排除依赖, 主动断开依赖的资源-->
    <exclusions>
        <exclusion>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3.3 依赖范围

在项目中导入依赖的jar包后，默认情况下，可以在任何地方使用。

如果希望限制依赖的使用范围，可以通过标签设置其作用范围。

如上图所示，给junit依赖通过scope标签指定依赖的作用范围。那么这个依赖就只能作用在测试环

境，其他环境下不能使用。

scope标签的取值范围：

4. 生命周期详解

4.1 介绍

Maven的生命周期就是为了对所有的构建过程进行抽象和统一。描述了一次项目构建，经历哪些阶段。

这个生命周期包含了项目的清理，初始化，编译，测试，打包，集成测试，验证，部署和站点生成等几乎所有构建步骤。

Maven对项目构建的生命周期划分为3套（相互独立）：

（1）clean：清理工作。

（2）default：核心工作。如：编译、测试、打包、安装、部署等。

（3）site：生成报告、发布站点等。

我们看到这三套生命周期，里面有很多很多的阶段，这么多生命周期阶段，其实我们常用的并不多，主要关注以下几个：

• clean：移除上一次构建生成的文件

• compile：编译项目源代码

• test：使用合适的单元测试框架运行测试(junit)

• package：将编译后的文件打包，如：jar、war等

• install：安装项目到本地仓库

Maven 的生命周期是抽象的，这意味着生命周期本身不做任何实际工作。在 Maven 的设计中，实际任务 （如源代码编译）都交由插件来完成。

在同一套生命周期中，我们在执行后面的生命周期时，前面的生命周期都会执行。

当运行package生命周期时，clean、compile生命周期会不会运行？

clean不会运行，compile会运行。因为compile与package属于同一套生命周期，而clean与package不属于同一套生命周期。

4.2 执行

在日常开发中，当我们要执行指定的生命周期时，有两种执行方式：

（1）在idea工具右侧的maven工具栏中，选择对应的生命周期，双击执行

（2）在DOS命令行中，通过maven命令执行

5. Maven 安装和配置

5.1 Maven 安装和配置

5.1.1 下载

下载地址： https://maven.apache.org/download.cgi

5.1.2 解压安装

解压即安装，建议解压到没有中文、特殊字符的路径下。

bin目录：存放的是可执行命令。（mvn 命令重点关注）

conf目录：存放Maven的配置文件。（settings.xml配置文件后期需要修改）

lib目录：存放Maven依赖的jar包。（Maven也是使用java开发的，所以它也依赖其他的jar

包）

5.1.3 配置本地仓库

（1）在自己计算机上新一个目录（本地仓库，用来存储jar包）

（2）进入到conf目录下修改settings.xml配置文件，（55行左右）

用刚刚新建的本地仓库路径替换掉标签体内容

5.1.4 配置阿里云私服

由于中央仓库在国外，所以下载jar包速度可能比较慢，而阿里公司提供了一个远程仓库，里面基本也都有开源项目的jar包。

进入到conf目录下修改settings.xml配置文件。

定位到160行左右，在标签下为其添加子标签，内容如下：

<!-- 配置阿里云私服地址 -->
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>

5.1.5 配置环境变量

（1）在系统变量处新建一个变量MAVEN_HOME，MAVEN_HOME环境变量的值，设置为maven的解压安装目录

（2）在Path中进行配置

PATH环境变量的值，设置为：%MAVEN_HOME%\bin

（3）打开 DOS 命令提示符进行验证，出现如图所示表示安装成功

mvn -v

5.2 IDEA集成Maven

我们要想在 IDEA 中使用 Maven 进行项目构建，就需要在 IDEA 中集成 Maven。

5.2.1 当前工程设置

（1）选择 IDEA中 File => Settings => Build,Execution,Deployment => Build Tools => Maven

（2）设置IDEA使用本地安装的Maven，并修改配置文件及本地仓库路径

（3）配置工程的编译版本为11 ，Maven默认使用的编译版本为5（版本过低）

上述配置的 maven 环境，只是针对于当前工程的，如果我们再创建一个 project ，又恢复成默认的配置了。要解决这个问题，我们就需要配置全局的maven 环境。

5.2.2 全局设置

（1）进入到IDEA欢迎页面

选择 IDEA中 File => close project，进入欢迎界面。

（2）打开 All settings , 选择 Build,Execution,Deployment => Build Tools => Maven

（3）配置工程的编译版本为11

和上述3.2.1当前工程设置中配置工程的编译版本方法一致。

6. Maven项目示例

6.1 创建Maven项目

6.1.1 创建一个空项目

6.1.2 创建模块，选择Maven，点击Next

6.1.3 填写模块名称，坐标信息，点击finish，创建完成

6.1.4 在Maven工程下，创建HelloWorld类

6.1.5 编写 HelloWorld，并运行

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello Maven ...");
     }
}

6.2 导入Maven项目

6.2.1 方式1：使用Maven面板，快速导入项目

打开IDEA，选择右侧Maven面板，点击 + 号，选中对应项目的pom.xml文件，双击即可

说明：如果没有Maven面板，选择 View => Appearance => Tool Window Bars

6.2.2 方式2：使用idea导入模块项目

File => Project Structure => Modules => + => Import Module，选中对应项目的pom.xml文件，双击即可

6.3 问题记录

6.3.1 更新依赖索引

有时候给idea配置完maven仓库信息后，在idea中依然搜索不到仓库中的jar包。这是因为仓库中的 jar包索引尚未更新到idea中。这个时候我们就需要更新idea中maven的索引了，具体做法如下：

打开设置----搜索maven----Repositories----选中本地仓库-----点击Update

6.3.2 清理maven仓库

初始情况下，我们的本地仓库是没有任何jar包的，此时会从私服去下载（如果没有配置，就直接从中央仓库去下载），可能由于网络的原因，jar包下载不完全，这些不完整的jar包都是lastUpdated 结尾。此时，maven不会再重新帮你下载，需要你删除这些以lastUpdated结尾的文件，然后maven才会再次自动下载这些jar包。

如果本地仓库中有很多这样的以lastUpadted结尾的文件，可以定义一个批处理文件，在其中编写如下脚本来删除：

创建del_lastUpdated.bat文件（直接创建一个文本文件，命名为 del_lastUpdated，后缀名直接改为bat即可）

修改完毕后，双击运行即可删除maven仓库中的残留文件。

// 修改为本地仓库目录
set REPOSITORY_PATH=E:\develop\apache-maven-3.6.1\mvn_repo
rem 正在搜索...
del /s /q %REPOSITORY_PATH%\*.lastUpdated
rem 搜索完毕
pause