【JavaEE】从 0 到 1 学 Maven：构建 Java 项目的智慧密钥，开启 Java 项目高效管理的奇幻之门

环境准备

Idea版本:
社区版: 2021.1 -2022.1.4
专业版: ⽆要求

1. 什么是Maven？

官⽅对于Maven的描述:

Apache Maven is a software project management and comprehension tool.

Based on the concept of a project object model (POM), Maven can manage

a project's build, reporting and documentation from a central piece of

information.

引⽤来⾃: 点击跳转

翻译过来就是:
Maven是⼀个项⽬管理⼯具。基于POM(Project Object Model,项⽬对象模型)的概念，Maven可以通过⼀⼩段描述信息来管理项⽬的构建，报告和⽂档的项⽬管理⼯具软件。

⼤⽩话: Maven是⼀个项⽬管理⼯具, 通过pom.xml⽂件的配置获取jar包，⽽不⽤⼿动去添加jar包

Maven既然是一个软件，但是我们为什么下载Idea后没有主动下载呢？

答：IntelliJ IDEA 自带了 Maven 插件，安装 IDEA 时，它会默认安装并启用该插件。Maven安装在：Idea路径/plugins/下，Idea路径/plugins/中的maven文件就是。该插件并不包含完整的 Maven 软件，而是提供了 Maven 集成环境，允许用户在 IDEA 中使用 Maven 功能来构建和管理项目。

2.为什么要学Maven？

Maven 可以自动化项目的构建过程，包括编译源代码、运行测试、打包、生成文档等。它通过配置文件 pom.xml 来定义构建流程，并可以让你在不同的环境中一致地执行这些步骤，避免了手动构建的繁琐和易出错。

⼀句话: 简单, ⽅便, 提⾼我们的开发效率, 减少我们的开发Bug。

3.创建一个Maven项目

IDEA本⾝已经集成了Maven, 我们可以直接使⽤, ⽆需安装

以下截图的idea版本为: 2024.1.2, 不同版本的idea界⾯展⽰会有所不同

然后点击Create，第一创建需要等的时间比较长。

创建好的项目结构：

4.Maven的核心功能

4.1项目构建

Maven 提供了标准的,跨平台(Linux, Windows, MacOS等)的⾃动化项⽬构建⽅式。当我们开发了⼀个项⽬之后, 代码需要经过编译, 测试, 打包, 发布等流程, 每次代码的修改, 都需要经过这些流程, 如果代码反复调试修改, 这个流程就需要反复进⾏, 就显得特别⿇烦, ⽽Maven 给我们提供了⼀套简单的命令来完成项⽬的构建。

点击项目结构的pom.xml，然后点击右侧的M:

框住的是Maven命令，Maven是一个工具，和idea没有关系，idea只是把maven集成了。

也可以在不使用idea的情况下不使用Maven，这时需要使用Maven命令

⽐如, 点击package, 就可以完成项⽬的打包操作

运行后的结果：

打包就是把所有的class⽂件, 全部放在⼀起, 打成jar包或者war包，jar包和war包都是⼀种压缩⽂件。

jar包就是把开发⼈员已经写好的⼀些代码进⾏打包。 打好的jar包就可以引⼊到其他项⽬中, 也可以直接使⽤这些jar包中的类和属性。 另外也可以打成可执⾏jar包, 这样的包就可以通过java -jar命令来执⾏。

war包可以理解为是⼀个web项⽬，⾥⾯是项⽬的所有东西, 通常⽤于⽹站。

4.2依赖管理

怎么理解依赖呢 ？

答：依赖就是第三方的jar包，第三方的框架，等等，使用第三的依赖后就不用我们自己创建；

比如：我们想吃大米，我们不用自己种大米，用市场上卖的大米来做米饭。

之前JDK中没有Maven，需要提前下载好jar包，然后添加到项目结构中

上⾯说到, Maven是⼀个项⽬管理⼯具, 通过pom.xml⽂件的配置获取jar包，⽽不⽤⼿动去添加jar包获取的jar包, 其实就是依赖。

pom.xml文件就是maven 的配置⽂件，⽤以描述项⽬的各种信息进行依赖配置。

依赖: 指当前项⽬运⾏所需要的jar包.

⽐如前⾯学习JDBC时, 我们需要⼿动下载mysql-connector-java的包，并且添加到项⽬中。

如果使⽤Maven, 我们只需要在pom.xml中引⼊mysql-connector-java的依赖就可以了

<dependencies>
	<!--⾥⾯放置项⽬的依赖坐标, 可为多个 -->
</dependencies>

比如：在pom⽂件标签内, 添加使用MySQL所需要的配置文件

1. 在pom⽂件标签内, 添加依赖坐标

   <dependency>
   	<groupId>mysql</groupId> 
   	<artifactId>mysql-connector-java</artifactId>
   	<version>8.0.30</version>
   </dependency>

2. 点击刷新按钮, 引⼊新加⼊的依赖jar包
   

后续有添加新的jar包, 或者修改jar包版本, 都需要通过该⽅式在项⽬中添加依赖。

刷新后就可以在项目中看到下载的jar包

4.2.1 依赖传递

早期我们没有使⽤maven时, 向项⽬中添加依赖的jar包，需要把所有的jar包都复制到项⽬⼯程下。

⽐如 A 依赖B, B依赖C, 那么== A项⽬引⼊B 的同时, 也需要引⼊C==, 如果我们⼿动管理这个依赖, 这个过程就会⽐较⿇烦, 我们需要知道每个库都依赖哪些库, 以及这些依赖之间的版本是如何关联的

⽐如我们要吃⽕锅, 需要有锅, 有调料, 有⻝材, 以及确认什么样的锅, 什么样的⻝材.

⽐如去医院看病, 需要带上以往的病历, 检查结果, 处⽅等, 并且要确认带的资料是正确的, 如果⽇期错了, 或者患者错了, 带少了, 就需要回去重新拿。

但使⽤maven的话, 就可以避免管理所需依赖的关系。我们只需要在pom⽂件中, 定义直接依赖就可以了, 由于maven的依赖具有传递性，所以会⾃动把所依赖的其他jar包也⼀起导⼊。

⽐如吃⽕锅, 现在我们可以点⼀个海底捞外卖, 直接就把所有⻝材都送过来了, 包括什么锅, 配什么菜。

⽐如去医院看病, 借助"互联⽹", 实现了信息共享, 只需要带上⾝份证, 以往的病历和检查结果就都可以看到了。

如上图, 项⽬A 通过Maven 引⼊ Jar A 时, 会⾃动引⼊ Jar B 和Jar C. Jar A 和项⽬B就是项⽬A的直接依赖.

Jar B, Jar C是间接依赖.

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

我们也可以下载插件MavenHelp来查看依赖的关系

间接依赖：被依赖的资源如果依赖其他资源，当前项⽬间接依赖其他资源
比如：MySQL依赖protobuf，当引入mysql的同时也自动引入了protobuf

下载成功后按下面的步骤

4.2.2 依赖排除

当前阶段我们需要依赖的库并不多, 但随着项⽬的越来越复杂, 库之间的依赖关系也会变得越来越复杂. 如上图中, 如果项⽬A不需要Jar B,也可以通过排除依赖的⽅式来实现.

排除依赖:

指主动断开依赖的资源。（被排除的资源⽆需指定版本）

⽐如, 我下了⼀个快递单⼦, 默认会有⼀个服务, 就是快递⼩哥会上⻔取件, 但是我刚好要出⻔, ⽽且顺路经过站点, 也可以选择⾃⼰送过去，不需要快递⼩哥会上⻔取件。

<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-core</artifactId>
	<version>6.0.6</version>
	<!--排除依赖-->
	<exclusions>
		<exclusion>
			<artifactId>spring-jcl</artifactId>
			<groupId>org.springframework</groupId>
		</exclusion>
	</exclusions>
</dependency>

maven还有⼀些功能是依赖调解, 可选依赖等 依赖调解:

当项⽬中的依赖存在依赖冲突时, 例如 存在这样的依赖： A->B->C->X(1.0)

A->D->X(2.0)

Maven会采⽤最短路径优先的原则去选择依赖，这⾥2的依赖路径更短，所以会选择X(2.0), 当然我们也可以选择指定某个依赖的版本

当然也可以指定X的版本

5.Maven 仓库

5.1 什么是Maven仓库

我们通过短短⼏⾏代码, 就把依赖jar包放在了项⽬⾥, 具体是如何做的呢?

<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>8.0.30</version>
</dependency>

这个个代码, 我们称之为 "坐标", 也就是唯⼀的。

在Maven中, 根据 groupId、artifactId、version 的配置, 来唯⼀识别⼀个 jar 包, 缺⼀不可.
当我们在pom⽂件中配置完依赖之后, 点击刷新, Maven会根据坐标的配置, 去仓库⾥寻找Jar包, 并把他下载下来, 添加到项⽬中。这个Jar包下载的地⽅就称为仓库。

仓库：⽤于存储资源，管理各种jar包

Maven仓库的本质就是⼀个⽬录(⽂件夹)，这个⽬录被⽤来存储开发中所有依赖(jar包, 插件等).

Maven仓库分为两⼤类: 本地仓库和远程仓库. 其中远程仓库⼜分为中央仓库, 私服 和其他公共库

如果没有maven，需要先自己找jar包下载到本地，然后把jar包放到项目中。有了maven后，只需要描述，maven根据描述从中央仓库下载合适jar包到本地仓库，然后把jar包放在项目中

5.2 本地仓库

本地仓库: ⾃⼰计算机上的⼀个⽬录(⽤来存储jar包)

==当项⽬中引⼊对应依赖jar包后，⾸先会查找本地仓库中是否有对应的jar包 ==

• 如果有，则在项⽬直接引⽤
• 如果没有，则去中央仓库中下载对应的jar包到本地仓库

本地仓库地址可以通过Maven配置查看: File -> Settings

查看该仓库⽬录, 可以看到该⽬录下有很多的jar(最开始是空的, 随着Maven的使⽤, 该仓库下⽂件会越来越多)

5.3中央仓库

中央仓库: maven 软件中内置⼀个远程仓库地址，就是中央仓库，服务于整个互联⽹. 由 Maven 团队维护，全球唯⼀。

仓库地址：https://repo1.maven.org/maven2/

可以通过https://mvnrepository.com 这个⽹站来查询并下载

我们可以把⾃⼰写好的Jar包上传到中央仓库(具备⼀定的要求), 也可以从中央仓库下载Jar包 查找Jar的坐标：

1. 访问 https://mvnrepository.com/
2. 进⾏查找, ⽐如mysql
   
3. 选择要添加的Jar包版本
   
4. 查看Jar包对应坐标
   

5.4私有服务器（私服）

私服: ⼀般由公司团队搭建的私有仓库 .

私服属于某个公司,或者某个部⻔, 往往需要⼀定权限. 有了私服之后, Maven依赖下载的顺序⼜发⽣了变化

当Maven需要下载资源的时候：

1. 先从本地仓库获取, 本地仓库存在, 则直接返回
2. 如果本地仓库没有, 就从私服请求, 私服存在该资源, 就直接返回
3. 如果私服上不存在该资源，则从中央仓库下载, 中央仓库不存在, 就报错了...
4. 如果中央仓库中存在, 就先缓存在私服上之后，再缓存到本地仓库⾥, 再为Maven的下载请求提供服务

私服是很多⼈在使⽤的, 所以只需要第⼀个使⽤者下载⼀次就可以了

5.5设置国内 Maven源

我们第一次创建Mave项目需要等待很长时间，其实就是使用的是远程仓库的原因（中央仓库在国外，jar包下载速度慢），我们也可以使用国内的远程仓库，比如阿里云的。

我的默认远程仓库和本地仓库在C盘，我的目的是把文件改到F盘中，因为我的idea在F盘中。

1. 先改中央仓库为阿里云仓库
   

   用idea打开settings.xml文件
   

   换成如下代码，保存

   <mirror>
     <id>alimaven</id>
     <mirrorOf>central</mirrorOf>
     <name>aliyun maven</name>
     <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
   </mirror>

   然后把刚才改的文件配置上
   

2. 改reposity

   然后再次查看maven仓库： File -> Settings
   
   

   进入修改settings.xml文集的目录
   

   把刚才粘贴的文件配置上
   

上述的国内maven源更改成功后也可以在创建Maven项目是选择国内源。