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>

巴特西