7.maven

1 初始Maven

1.1 什么是Maven

Maven是Apache旗下的一个开源项目，是一款用于管理和构建java项目的工具。

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

Apache 软件基金会，成立于1999年7月，是目前世界上最大的最受欢迎的开源软件基金会，也是一个专门为支持开源项目而生的非盈利性组织。

开源项目：https://www.apache.org/index.html#projects-list

1.2 Maven的作用

• 方便的依赖管理：方便快捷的管理项目依赖的资源(jar包)，避免版本冲突问题

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

• 统一的项目结构：提供标准、统一的项目结构

  • 目录说明：

    • src/main/java: java源代码目录
    • src/main/resources: 配置文件信息
    • src/test/java: 测试代码
    • src/test/resources: 测试配置文件信息

• 标准的项目构建流程：maven提供了标准的、跨平台(Linux、Windows、MacOS) 的自动化项目构建方式

2 Maven概述

2.1 Maven模型

• 项目对象模型 (Project Object Model)：将我们自己的项目抽象成一个对象模型，有自己专属的坐标
  • 坐标，就是资源(jar包)的唯一标识，通过坐标可以定位到所需资源(jar包)位置
• 依赖管理模型(Dependency)：使用坐标来描述当前项目依赖哪些第三方jar包
• 构建生命周期/阶段(Build lifecycle & phases)

2.2 Maven仓库

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

仓库的本质就是一个目录(文件夹)，这个目录被用来存储开发中所有依赖(就是jar包)和插件

Maven仓库分为：

• 本地仓库：自己计算机上的一个目录(用来存储jar包)
• 中央仓库：由Maven团队维护的全球唯一的。仓库地址：https://repo1.maven.org/maven2/
• 远程仓库(私服)：一般由公司团队搭建的私有仓库
  

当项目中使用坐标引入对应依赖jar包后，首先会查找本地仓库中是否有对应的jar包

• 如果有，则在项目直接引用

• 如果没有，则去中央仓库中下载对应的jar包到本地仓库

如果还可以搭建远程仓库(私服)，将来jar包的查找顺序则变为： 本地仓库 --> 远程仓库–> 中央仓库

2.3 Maven安装

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

3 Maven项目

3.1 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>com.itheima</groupId><artifactId>maven_project1</artifactId><version>1.0-SNAPSHOT</version><!-- 打包方式 --><packaging>jar</packaging></project>

pom文件详解：

• ：pom文件的根标签，表示当前maven项目
• ：声明项目描述遵循哪一个POM模型版本
  • 虽然模型本身的版本很少改变，但它仍然是必不可少的。目前POM模型版本是4.0.0
• 坐标 ：、、
  • 定位项目在本地仓库中的位置，由以上三个标签组成一个坐标
• ：maven项目的打包方式，通常设置为jar或war（默认值：jar）

3.2 Maven坐标详解

什么是坐标？

• Maven中的坐标是资源的唯一标识 , 通过该坐标可以唯一定位资源位置
• 使用坐标来定义项目或引入项目中需要的依赖

Maven坐标主要组成

• groupId：定义当前Maven项目隶属组织名称（通常是域名反写，例如：com.yongzhi）
• artifactId：定义当前Maven项目名称（通常是模块名称，例如 order-service、goods-service）
• version：定义当前项目版本号

如下就是使用坐标表示一个项目：

<groupId>com.yongzhi</groupId>
<artifactId>studyMavenProject01</artifactId>
<version>1.0-SNAPSHOT</version>

注意：

• 上面所说的资源可以是插件、依赖、当前项目。
• 我们的项目如果被其他的项目依赖时，也是需要坐标来引入的。

4 依赖管理

4.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. 点击刷新按钮，引入最新加入的坐标

   • 刷新依赖：保证每一次引入新的依赖，或者修改现有的依赖配置，都可以加入最新的坐标

   [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-pk9RcXpo-1692427531530)(E:\javaweb\笔记\day04\img\屏幕截图 2023-08-18 202013.png)]

注意事项：

1. 如果引入的依赖，在本地仓库中不存在，将会连接远程仓库 / 中央仓库，然后下载依赖（这个过程会比较耗时，耐心等待）
2. 如果不知道依赖的坐标信息，可以到mvn的中央仓库（https://mvnrepository.com/）中搜索

添加依赖的几种方式：

1. 利用中央仓库搜索的依赖坐标
2. 利用IDEA工具搜索依赖：利用alt + insert弹出搜索依赖窗口

4.2 依赖传递

4.2.1 依赖具有传递性

依赖传递可以分为：

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

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

比如以上图中：

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

4.2.2 排除依赖

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

<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>

4.3 依赖范围

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

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

• 作用范围：

  1. 主程序范围有效（main文件夹范围内）

  2. 测试程序范围有效（test文件夹范围内）

  3. 是否参与打包运行（package指令范围内）

• 给junit依赖通过scope标签指定依赖的作用范围。 那么这个依赖就只能作用在测试环境，其他环境下不能使用。

• scope标签的取值范围：

scope值	主程序	测试程序	打包（运行）	范例
compile（默认）	Y	Y	Y	log4j
test	-	Y	-	junit
provided	Y	Y	-	servlet-api
runtime	-	Y	Y	jdbc驱动

4.4 生命周期

4.4.1 介绍

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

Maven从大量项目和构建工具中学习和反思，然后总结了一套高度完美的，易扩展的项目构建生命周期。这个生命周期包含了项目的清理，初始化，编译，测试，打包，集成测试，验证，部署和站点生成等几乎所有构建步骤。

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

  • clean（清理工作）：

    • pre-clean

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

    • post-clean

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

    • validate
    • initalize
    • generate-sources
    • process-resources
    • compile：编译项目源代码
    • process-classes
    • generate-test-sources
    • process-test-sources
    • generate-test-resources
    • process-test-resources
    • test-compile
    • process-test-classes
    • test：使用合适的单元测试框架运行测试junit
    • prepare-package
    • package：将编译后的文件打包，如：jar、war等
    • verify
    • install：安装项目到本地仓库
    • deploy

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

    • pre-site
    • site
    • post-site
    • site-deploy

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

生命周期的顺序是：clean --> validate --> compile --> test --> package --> verify --> install --> site --> deploy

我们需要关注的就是：clean --> compile --> test --> package --> install

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

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

ean --> validate --> compile --> test --> package --> verify --> install --> site --> deploy

我们需要关注的就是：clean --> compile --> test --> package --> install

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

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