Maven笔记-超详细 - ⎝⎛CodingNote.cc ⎞⎠

Maven笔记—超详细

2022 年 6 月 7 日
笔记
JAVA, 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>//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>//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="//maven.apache.org/POM/4.0.0"
xmlns:xsi="//www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="//maven.apache.org/POM/4.0.0 //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>

Tags: JAVA maven相关