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>