Maven笔记---超详细

显眼位置标注来源：此文章为B站课程黑马程序员Maven全套教程笔记，由本人整理。

Maven简介

Maven的本质是一个项目管理工具，将项目开发和管理过程抽象成一个项目对象模型(POM)

POM (Project Object Model)：项目对象模型

Maven的作用：

• 项目构建：提供标准的、跨平台的自动化项目构建方式

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

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

---

Maven基础概念(重点)

仓库

用于存储资源，包含各种jar包

仓库分类

• 本地仓库
• 远程仓库（私服和中央仓库）

坐标

Maven中的坐标用于描述仓库中资源的位置

• 坐标的主要组成：

  • groupId：定义当前Maven项目隶属组织名称（通常是域名反写）
  • artifactId：定义当前Maven项目名称（通常是模块名称）
  • version：定义当前版本号
  • packaging：定义该项目的打包方式

• 坐标的作用：使用唯一的标识，唯一性定位资源位置，通过该标识可以将资源的识别与下载交由机器完成。

仓库配置

• 本地仓库配置：

  • 默认位置

    <localRepository>${user.home}/.m2/repository</localRepository>
  

  • 自定义位置

    <localRepository>D:\maven\repository</localRepository>
  

• 远程仓库配置：

<repositories>
  <repository>
	  <id>central</id>
	  <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
	  <snapshots>
			<enabled>false</enabled>
      </snapshots>
   </repository>
</repositories>

• 镜像仓库配置：

在setting文件中配置阿里云镜像仓库

<mirrors>
	<mirror>
    <!-- 此镜像的唯一标识符，用来区分不同的mirror元素 -->
		<id>nexus-aliyun</id>
    <!-- 对那种仓库进行镜像（就是替代哪种仓库）-->
		<mirrorOf>central</mirrorOf>
    <!-- 镜像名称 -->
		<name>Nexus aliyun</name>
    <!-- 镜像URL -->
		<url>http://maven.aliyun.com/nexus/content/groups/public</url>
	</mirror>
</mirrors>

---

第一个Maven项目(重点)

手动生成Maven项目

Maven工程目录结构：

在src同层目录下创建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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.itheima</groupId>
<artifactId>project-java</artifactId>
<version>1.0</version>
<packaging>jar</packaging>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
</project>

Maven项目构建命令

Maven构建命令使用mvn开头，后面加功能参数，可以一次执行多个命令，使用空格分隔

mvn compile #编译
mvn clean #清理
mvn test #测试
mvn package	#打包
mvn install #安装到本地仓库

使用插件生成工程

• 创建工程

  mvn archetype:generate
  -DgroupId={project-packaging}
  -DartifactId={project-name}
  -DarchetypeArtifactId=maven-archetype-quickstart
  -DinteractiveMode=false
  

• 创建java工程

  mvn archetype:generate -DgroupId=com.itheima -DartifactId=java-project -
  DarchetypeArtifactId=maven-archetype-quickstart -Dversion=0.0.1-snapshot -
  DinteractiveMode=false
  

• 创建web工程

  mvn archetype:generate -DgroupId=com.itheima -DartifactId=web-project -
  DarchetypeArtifactId=maven-archetype-webapp -Dversion=0.0.1-snapshot -
  DinteractiveMode=false
  

java工程与web工程目录对比：

---

IDEA生成Maven项目

• 原型创建Maven项目

  

  

---

依赖管理(重点)

1 依赖配置

依赖指的是当前项目运行所需要的jar，一个项目可以设置多个依赖

格式：

<!--设置当前项目所依赖的所有jar-->
<dependencies>
  <!--设置具体的依赖-->
  <dependency>
    <!--依赖所属群组id-->
    <groupId></groupId>
    <!--依赖所属项目id-->
    <artifactId></artifactId>
    <!--依赖版本号-->
    <version></version>
  </dependency>
</dependencies>

2 依赖传递

• 依赖具有传递性，包括直接传递和间接传递。

  • 直接传递：在当前项目中通过依赖配置建立的依赖关系（A使用B，A和B就是直接传递）
  • 间接传递：被依赖的资源如果依赖其他资源，当前项目间接依赖其他资源（比较拗口，意思是如果A依赖B，而B依赖C，那么A和C之间就是间接传递）

• 依赖传递的冲突问题

  • 路径优先：当依赖中出现相同的资源时，层级越深，优先级越低，层级越浅，优先级越高

  书本：1度--2度--spring1.0

  齿轮：1度--2度--3度--spring2.0

  深度不同，路径优先，与加载顺序无关。最终会使用2度中的spring1.0版本

  • 声明优先：当资源在相同层级被依赖时，配置顺序靠前的覆盖配置顺序靠后的

  书本：1度--2度--spring1.0

  齿轮：1度--2度--spring2.0

  深度相同，声明优先，如果书本的1度声明在齿轮的1度前面，则使用书本中的spring1.0版本

  • 特殊优先：当同级配置了相同资源的不同版本，后配置的覆盖先配置的

  书本：1度--2度--spring2.0

  书本：1度--2度--spring1.0

  同一个配置文件中，后配置的版本覆盖先配置的版本，与版本号大小无关，最终会使用spring1.0

3 可选依赖

• 可选依赖指的是对外隐藏当前所依赖的资源---不透明

true

<dependency>
  <groupId></groupId>
  <artifactId></artifactId>
  <version></version>
  <!--添加下面这一行-->
  <optional>true</optional>
</dependency>

4 排除依赖

• 排除依赖指主动断开依赖的资源，被排除的资源无需指定版本---不需要

<dependency>
  <groupId></groupId>
  <artifactId></artifactId>
  <version></version>
  <exclusions>
    <exclusion>
      <groupId></groupId>
      <artifactId></artifactId>
    </exclusion>
  </exclusions>
</dependency>

5 依赖范围

• 依赖的jar包默认情况可以在任何地方使用，可以通过scope标签设定其作用范围
• 作用范围：
  • 主程序范围有效（main文件夹范围内）
  • 测试程序范围有效（test文件夹范围内）
  • 是否参与打包（package文件夹范围内）

---

生命周期与插件

1 生命周期

• 项目构建生命周期

Maven项目构建生命周期描述的是一次构建过程经历了多少个事件

compile – test-compile – test – packege – Install

• Maven对项目构建的生命周期划分为3套

  • clean：清理工作

  • default：核心工作，例如编译、测试、打包、部署等

  • site：产生报告，发布站点等

2 插件

• 插件与生命周期内的阶段绑定，在执行到对应的生命周期时执行对应的插件功能
• 默认maven在各个生命周期上绑定有预设功能
• 通过插件可以自定义其他功能

<build>
  <plugins>
		<plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-source-plugin</artifactId>
      <version>2.2.1</version>
	  <executions>
		<execution>
          <goals>
			<goal>jar</goal>
          </goals>
		  <phase> generate-test-resources</phase>
		  </execution>
	</executions>
    </plugin>
	</plugins>
</build>

---

分模块开发与设计(重点)

1 ssm_pojo拆分

• 新建模块 ssm_pojo
• 拷贝原始项目中对应的相关内容到ssm_pojo模块中
  • 实体类(User)
  • 配置文件(无)

2 ssm_dao拆分

• 新建模块

• 拷贝原始项目中对应的相关内容到ssm_dao模块中

  • 数据层接口(UserDao)

  • 配置文件:保留与数据层相关配置文件(3个)

  注意:分页插件在配置中与SqlSessionFactoryBean绑定，需要保留

  • pom.xml:引入数据层相关坐标即可，删除springmvc相关坐标
  • spring
    • mybatis
    • spring 整合mybatismysql
    • druid
    • pagehelper
    • 直接依赖ssm_pojo ( 对ssm_pojo模块执行install指令，将其安装到本地仓库)

  如果没有对ssm_pojo模块执行install指令，本地仓库中找不到这个模块的jar包，就会报错

3 ssm_service拆分

• 新建模块

• 拷贝原始项目中对应的相关内容到ssm_service模块中

  • 业务层接口与实现类(UserService、UserServicelmpl)
  • 配置文件:保留与数据层相关配置文件(1个)
  • pom.xml: 引入数据层相关坐标即可，删除springmvc相关坐标
    • spring
    • junit
    • spring整合junit
    • 直接依赖ssm_dao (对ssm_dao模块执行install指令，将其安装到本地仓库)
    • 间接依赖ssm_pojo (由ssm_dao模块负责依赖关系的建立)

• 修改service模块spring核心配置文件名，添加模块名称，格式: applicationContext-service.xml

  • 修改dao模块spring核心配置文件名，添加模块名称，格式: applicationContext-dao.xml
  • 修改单元测试引入的配置文件名称，由单个文件修改为多个文件

4 ssm_control拆分

• 新建模块(使用webapp模板)

• 拷贝原始项目中对应的相关内容到ssm_controller模块中

  • 表现层控制器类与相关设置类(UserController、异常相关……)

  • 配置文件:保留与表现层相关配置文件(1个)、服务器相关配置文件 (1个)

  • pom.xml:引入数据层相关坐标即可，删除springmvc相关坐标

    • spring
    • springmvc
    • jackson
    • servlet
    • tomcat服务器插件
    • 直接依赖ssm_service (对ssm_service模块执行install指令，将其安装到本地仓库)
    • 间接依赖ssm_dao、ssm_pojo

  • 修改web.xml配置文件中加载spring环境的配置文件名称，使用*通配，加载所有applicationContext-开始的配置文件

---

聚合(重点)

• 模块打包类型

  • pom：聚合父模块
  • jar：springboot项目
  • war：web项目

• 作用：聚合用于快速构建Maven工程，一次性构建多个项目/模块。

• 制作方式：

  • 创建一个空模块，打包类型定义为pom

  <packaging>pom</packaging>
  

  • 定义当前模块进行构建操作时关联的其他模块名称(引入其他模块)

  <modules>
    <module>模块地址:ssm_controller</module>
    <module>模块地址:ssm_service</module>
    <module>模块地址:ssm_dao</module>
    <module>模块地址:ssm_pojo</module>
  </modules>
  

• 注意：参与聚合操作的模块最终执行顺序与模块间的依赖关系有关，与配置顺序无关

---

继承(重点)

• 作用：通过继承可以实现在子工程中沿用父工程中的配置（与Java类似）

• 制作方式：在子工程中生名其父工程坐标与对应的位置

<!--定义该工程的父工程-->
<parent>
  <groupId>com.itheima</groupId>
  <artifactId>ssm</artifactId>
  <version>1.0-SNAPSHOT</version>
  <!--填写父工程的pom文件(非必要)-->
  <relativePath>父工程pom文件地址:/ssm/pom.xml</relativePath>
</parent>

• 在父工程中定义依赖管理

<!--声明此处进行依赖管理-->
<dependencyManagement>
  <!--具体的所有依赖-->
  <dependencies>
	<!--具体的某个依赖，如：spring -->
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-context</artifactId>
		<version>5.1.9.RELEASE</version>
	</dependency>
  </dependencies>
</dependencyManagement>

• 继承依赖使用：

在子工程中定义依赖关系，无需声明依赖版本，版本参照父工程中依赖的版本

<dependencies>
	<!--具体的某个依赖，如：spring -->
	<dependency>
		<groupId>org.springframework</groupId>
		<artifactId>spring-context</artifactId>
	</dependency>
</dependencies>

---

---

继承与聚合

作用：

• 聚合用于快速构建项目
• 继承用于快速配置

相同点：

• 聚合与继承的pom.xml文件打包方式均为pom，可以将两种关系制作到同一个pom文件中
• 聚合与继承均属于设计型模块，并无实际的模块内容

不同点：

• 聚合是在当前模块中配置关系，聚合可以感知到参与聚合的模块有哪些
• 继承是在子模块中配置关系，父模块无法感知哪些子模块继承了自己

---

属性(重点)

1 自定义属性

• 作用：等同于定义变量，方便统一维护
• 定义格式：

<!--定义自定义属性-->
<properties>
    <spring.version>5.1.9.RELEASE</spring.version>
	<junit.version>4.12</junit.version>
</properties>

• 调用格式：

<dependency>
  <groupId>org.springframework</groupId>
  <artifactId>spring-context</artifactId>
  <version>${spring.version}</version>
</dependency>

2 内置属性

• 作用：使用Maven内置属性，快速配置
• 调用格式：

${basedir}
${version}

3 Setting属性

• 作用：使用Maven配置文件setting.xml中的标签属性，用于动态配置
• 调用格式：

${settings.localRepository}

4 Java系统属性

• 作用：读取Java系统属性
• 调用格式：

${user.home}

• 系统属性查询方式：

mvn help:system

5 环境变量属性

• 作用：使用Maven配置文件setting.xml中的标签属性，用于动态配置
• 调用格式：

${env.JAVA_HOME}

• 环境变量属性查询方式：

mvn help:system

---

版本管理

• SNAPSHOT（快照版本）
• RELEASE（发布版本）
• 工程版本号约定
  • 约定规范:
    • <主版本>.<次版本>.<增量版本>.<里程碑版本>
    • 主版本:表示项目重大架构的变更，如: spring5相较于spring4的迭代
    • 次版本:表示有较大的功能增加和变化，或者全面系统地修复漏洞
    • 增量版本:表示有重大漏洞的修复
    • 里程碑版本:表明一个版本的里程碑（版本内部)。这样的版本同下一个正式版本相比，相对来说不是很稳定，有待更多的测试
  • 范例:
    
    5.1.9.RELEASE

---

资源配置

配置文件引用pom属性

• 作用：在任意配置文件中加载pom文件中定义的属性
• 调用格式：${地址}

${jdbc.url}

• 开启配置文件加载pom属性

<!--配置资源文件对应的信息-->
<resources>
  <resource>
    <!--设定配置文件对应的位置目录，支持使用属性动态设定路径-->
    <directory>地址</directory>
    <!--开启对配置文件的资源加载过滤-->
    <filtering>true</filtering>
  </resource>
</resources>

---

多环境开发配置

• 作用：加载指定环境(开发环境和生产环境的配置文件不同)
• 调用格式

mvn 指令 –P 环境定义id
例如：mvn install –P pro_env

<!--创建多环境-->
<profiles>
  <!--定义具体的环境：生产环境-->
  <profile>
    <!--定义环境对应的唯一名称-->
    <id>开发环境名称:pro_env</id>
    <!--定义环境中的专用的属性值-->
    <properties>
      <jdbc.url>jdbc:mysql://127.1.1.1:3306/ssm_db</jdbc.url>
    </properties>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
  </profile>
  <!--定义具体的环境：开发环境-->
  <!--格式同上-->
    <id>dev_env</id>
	......
</profiles>

---

跳过测试(了解)

1 跳过测试环节的应用场景

• 整体模块功能未开发
• 模块中某个功能未开发完毕
• 单个功能更新调试导致其他功能失败
• 快速打包

2 使用命令跳过测试

• 命令

mvn 指令-D skipTests

• 注意事项
  • 执行的指令生命周期必须包含测试环节

3 使用界面跳过测试

4 使用配置跳过测试

<plugin>
	<artifactId>maven-surefire-plugin</artifactId>
	<version>2.22.1</version>
	<configuration>
		<skipTests>true</skipTests><!-- -->
		<includes> <!-- -->
			<include>**/User*Test.java</include>
		</includes>
		<excludes><!-- -->
			<exclude>**/User*TestCase.java</exclude>
		</excludes>
	</configuration>
</plugin>