Maven重点学习笔记(包入门 2万字)
Maven依赖管理项目构建工具
尚硅谷 5h 2023最新版
一,Maven简介
1.为什么学习Maven
1.1, Maven是一个依赖管理工具
1️⃣ jar包的规模
随着我们使用越来越多的框架,或者框架封装程度越来越高,项目中使用的jar包也越来越多。项目中,一个模块里面用到上百个jar包是非常正常的。
比如下面的例子,我们只用到SpringBoot、SpringCloud 框架中的三个功能:
- Nacos服务注册发现
- Web 框架环境
- 视图模板技术Thymeleaf
😱最终导入了106个jar包!!!
org.springframework.security:spring-security-rsa:jar:1.0.9.RELEASE:compile
com.netflix.ribbon: ribbon:jar:2.3.0:compile
org.springframework.boot:spring-boot-starter-thymeleaf:jar:2.3.6.RELEASE:compile
commons-configuration:commons-configuration:jar:1.8:compile
org.apache.logging.log4j:log4j-api:jar:2.13.3:compile
org.springframework:spring-beans:jar:5.2.11.RELEASE:compile
org.springframework.cloud:spring-cloud-starter-netflix-ribbon:jar:2.2.6.RELEASE:compile
org.apache.tomcat.embed:tomcat-embed-websocket:jar:9.0.39:compile
com.alibaba.cloud:spring-cloud-alibaba-commons:jar:2.2.6.RELEASE:compile
org.bouncycastle:bcprov-jdk15on:jar:1.64:compile
org.springframewqrk.security:spring-security-crypto:jar:5.3.5.RELEASE:compile
org.apache.httpcomponents:httpasyncclient:jar:4.1.4:compile
com.g0ogle.j2objc:j2objc-annotations:jar:1.3:compile
com.fasterxml.jackson.core:jackson-databind:jar:2.11.3:compile
io.reactivex:rxjava:jar:1.3.8:compile
ch.qos.logback:logback-classic:jar:1.2.3:compile
org.springframework:spring-web:jar:5.2.11.RELEASE:compile
io.reactivex:rxnetty-servo:jar:0.4.9:runtime
org.springframework:spring-core:jar:5.2.11.RELEASE:compile
io.github.openfeign.form:feign-form-spring:jar:3.8.0:compileio.github.openfeign.form:feign-form:jar:3.8.0:compile
com.netflix.ribbon:ribbon-loadbalancer:jar:2.3.0:compile
org.apache.httpcomponents:httpcore:jar:4.4.13:compile
org.thymeleaf.extras:thymeleaf-extras-java8time:jar:3.0.4.RELEASE:compile
org.slf4j:jul-to-slf4j:jar:1.7.30:compile
com.atguigu.demo:Jemo09-base-entity:jar:1.0-SNAPSHOT:compile
org.yaml:snakeyaml:jar:1.26:compile
org.springframework.boot:spring-boot-starter-logging:jar:2.3.6.RELEASE:compile
io.reactivex:rxnetty-contexts:jar:0.4.9:runtime
org.apache.httpcomponents:httpclient:jar:4.5.13:compile
io.github.openfeign:feign-core:jar:10.10.1:compile
org.springframework.boot:spring-boot-starter-aop:jar:2.3.6.RELEASE:compile
org.hdrhistogram:HdrHistogram:jar:2.1.9:compile
org.springframework:spring-context:jar:5.2.11.RELEASE:compile
commons-lang:commons-lang:jar:2.6:compileio.prometheus:simpledlient:jar:0.5.0:compile
ch.qos.logback:logback-core:jar:1.2.3:compile
org.springframework:spring-webmvc:jar:5.2.11.RELEASE:compile
com.sun.jersey:jersey-core:jar:1.19.1:runtime
javax.ws.rsijsr311-api:;jar:1.1.1:runtime
javax.inject:javax.inject:jar:1:runtime
org.springframework.cloud:spring-cloud-openfeign-core:jar:2.2.6.RELEASE:compile
com.netflix.ribbon:ribbon-core:jar:2.3.0:compile
com.netflix.hystrix:hystrix-core:jar:1.5.18:compile
com.netflix.ribbon:ribbon-transport:jar:2.3.0:runtime
org.springframework.boot:spring-boot-starter-json:jar:2.3.6.RELEASE:compile
org.springframework.cloud:spring-cloud-starter-openfelgn:jar:2.2.6.RELEASE:compile
com.fasterxml.jackson.module:jackson-module-parameter-names:jar:2.11.3:compile
com.sun.jersey.contribs:jersey-apache-client4:jar:1.19.1:runtime
io.github.openfeign:feign-hystrix:jar:10.10.1:compile
io.github.openfeign:feign-slf4j:jar:10.10.1:compile
com.alibabanacos:nacos-client:jar:1.4.2:compile中
org.apache.httpcomponents:httpcore-nlo:jar:4.4.13:compilecom.sun.jersey:jersey-client:jar:1.19.1:runtime
org.springframework.cloud:spring-cloud-context:jar:2.2.6.RELEASE:compile
org.glassfish:jakarta.el:jar:3.0.3:compile
org.apache.logging.log4j:log4j-to-slf4j:jar:2.13.3:compile
com.fasterxml.jackson.datatype:jackson-datatype-jsr310:jar:2.11.3:compile
org.springframework.cloud:spring-cloud-commons:jar:2.2.6.RELEASE:compile
org.asnectj:aspectjweavenjar1.9.G:compile
com.alibaba.cloud:spring-cloud-srarter-alibaba-nacos-discoveiy:jar.2.2:6.RElEASE:compille…包名可能会错😢
而如果使用Maven来引入这些jar包只需要配置三个[依赖]:
<!-- Nacos 服务注册发现启动器 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<!-- web启动器依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 视图模板技术thymeleaf -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
2️⃣ jar包的来源问题
- 个jar包所属技术的官网。官网通常是英文界面,网站的结构又不尽相同,甚至找到下载链接还发现需要通过特殊的工具下载。
- 第三方网站提供下载。问题是不规范,在使用过程中会出现各种问题。
- jar包的名称
- jar包的版本
- jar包内的具体细节
3️⃣ jar包导入问题
在web工程中,jar包必须存放在指定位置
在使用Maven之后,通过配置依赖(jar包)的坐标,查找本地仓库中相应jar包,若本地仓库没有,则统一从镜像网站或中央仓库中下载:
4️⃣ jar包之间的依赖
框架中使用的jar包,不仅数量庞大,而且彼此之间存在错综复杂的依赖关系。依赖关系的复杂程度,已经上升到了完全不能靠人力手动解决的程度。另外,jar包之间有可能产生冲突。进一步增加了我们在jar包使用过程中的难度。
下面是前面例子中jar包之间的依赖关系:
而实际上jar包之间的依赖关系是普遍存在的,如果要由程序员手动梳理无疑会增加极高的学习成本,而这些工作又对实现业务功能毫无帮助。
而使用Maven则几乎不需要管理这些关系,极个别的地方调整一下即可,极大的减轻了我们的工作量。
1.2, maven是一个构建工具
1️⃣ 你没有注意过的构建
你可以不使用Maven,但是构建工具必须要做。当我们使用IDEA进行开发时,构建是IDEA替我们做的。
2️⃣ 脱离IDE环境仍需构建
1.3, 结论 📨
- 管理规模庞大的jar包,需要专门工具。
- 脱离IDE环境执行构建操作,需要专门工具。
2.Maven介绍
官网:https://maven.apache.org/what-is-maven.html
Maven是一款为Java项目管理构建、依赖管理的工具(软件),使用Maven可以自动化构建、测试、打包和发布项目,大大提高了开发效率和质量。
Maven就是一个软件,掌握安装、配置、以及基本功能(项目构建、依赖管理)的理解和使用即可!
2.1依赖管理
Maven可以管理项目的依赖,包括自动下载所需依赖库、自动下载依赖需要的依赖并且保证版本没有冲突、依赖版本管理等。通过Maven,我们可以方便地维护项目所依赖的外部库,避免版本冲突和转换错误等,而我们仅仅需要编写配置即可。
2.2 构建管理
项目构建是指将源代码、配置文件、资源文件等转化为能够运行或部署的应用程序或库的过程。
Maven可以管理项目的编译、测试、打包、部署等构建过程。通过实现标准的构建生命周期,Maven可以确保每一个构建过程都遵循同样的规则和最佳实践。同时,Maven的插件机制也使得开发者可以对构建过程进行扩展和定制。主动触发构建,只需要简单的命令操作即可。
场景1:
如我们项目需要第三方依赖如:Druid连接池、MySQL数据库驱动和JacksonJSON等处理。那么我们可以将想要的依赖项的信息编写到Maven工程的配置文件,Maven就会自动下载并复制这些依赖项到项目中,无需自己导入jar包,管理jar!
场景2:
项目完成开发,我们想要打成war部署到服务器中,使用maven的构建命令可以快速打包!节省大量时间!
3.Maven软件工作原理模型图(了解)
二,Maven安装和配置(仅供参考)
1.Maven安装
官网: https://maven.apache.org/docs/history.html
各个工具选用版本(视频版本仅供参考)
工具 | 版本 |
---|---|
Maven | 3.8.8 |
JDK | 17 |
IDEA | 2022.2 |
安装条件:maven需要本机安装java环境、必需包含java_home环境变量!
软件安装:右键解压即可 (绿色免安装)
软件结构:
文件 | 作用 |
---|---|
bin | 含有Maven的运行脚本 |
boot | 含有plexus-classworlds类加载器框架 |
conf | 含有Maven的核心配置文件 |
lib | 含有Maven运行时所需要的Java类库 |
LICENSE,NOTICE,README.txt | 针对Maven版本,第三方软件等简要介绍 |
2.Maven环境配置
2.1配置MAVEN_HOME
2.2配置Path
3.命令测试(cmd窗口)
mvn -v
// 输出版本信息即可,如果错误,请仔细检查环境变量即可!
3.Maven功能配置
我们需要需改maven/conf/settings.xml配置文件,来修改maven的一些默认配置。我们主要休要修改的有
三个配置:1.依赖本地缓存位置 (本地仓库位置)
2.maven下载镜像
3.maven选用编译项目的jdk版本
3.1 配置本地仓库地址
<!--localRepository
| The path to the local repository maven will use to store artifacts.
| Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
<!--conf/settings.xml 55行-->
<localRepository>D:\maven-repository</localRepository> // 可以改成自己的地址
3.2 配置国内阿里镜像
<!--在mirrors节点(标签)下添加中央仓库镜像160行附近-->
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<ur1>http://maven.aliyun.com/nexus/content/groups/public/</ur1>
<mirrorof>central</mirrorof>
</mirror>
3.3 配置jdk17版本项目构建
<!--在profiles节点(标签)下添加jdk编译版本268行附近-->
<profile>
<id>jdk-17</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>17</jdk>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
</properties>
</profile>
4.IDEA配置本地Maven软件
我们需要将配置好的maven软件,配置到idea开发工具中即可!注意:idea工具默认自带maven配置软件,但是因为没有修改配置,建议替换成本地配置好的maven!
选择本地Maven软件
三,基于IDEA创建Maven工程
1.概念梳理Maven工程的GAVP
Maven工程相对之前的项目,多出一组gavp属性,gav需要我们在创建项目的时候指定,p有默认值,我们先行了解下这组属性的含义:
Maven 中的GAVP是指Groupld、Artifactld、Version、Packaging等四个属性的缩写,其中前三个是必要的,而Packaging属性为可选项。 这四个属性主要为每个项目在maven仓库中做一个标识,类似人的姓-名!有了具体标识,方便后期项目之间相互引用依赖等!
😄GAV遵循一下规则:
- GroupID 格式: com.{公司/BU}.业务线[子业务线],最多4级。
说明:{公司/BU}例如:alibaba/taobao/tmall/aliexpress 等 BU一级;子业务线可选。
正例:com.taobao.tddl 或 com.alibaba.sourcing.multilang - ArtifactID 格式: 产品线名-模块名。语义不重复不遗漏,先到仓库中心去查证一下。
正例:tc-client/uic-api/tair-tool/bookstore - Version版本号格式推荐: 主版本号.次版本号.修订号
- 主版本号:当做了不兼容的API修改,或者增加了能改变产品方向的新功能。
- 次版本号:当做了向下兼容的功能性新增(新增类、接口等)。
- 修订号:修复 bug,没有修改方法签名的功能加强,保持 API 兼容性。
- Packaging 定义规则:
指示将项目打包为什么类型的文件,idea根据packaging值,识别maven项目类型!
packaging 属性为 jar(默认值),代表普通的java工程,打包以后是 .jar 结尾的文件。
packaging 属性为 war ,代表Java的web工程,打包以后.war结尾的文件。
packaging 属性为 pom ,代表不会打包,用来做继承的父工程。
2.Idea构建Maven Java SE工程
⚠️ 此处省略了version,直接给了一个默认值:1.0-SNAPSHOT 自己后期可以在项目中随意修改!!
3.Idea构建Maven Java Web工程
3.1 直接创建
3.1.1新建模块
3.1.2 配置pom.xml
引入war包方式< packaging>war< /packagin>后重新打开项目即可
3.2安装插件
JBLJavaToWeb,单机项目右键
3.3 Maven骨架(xml版本较低,一般使用的是4.0版本)
4.Maven项目默认结构说明
4.1目录结构
4.2 pom.xml配置
根据官网进行配置 Maven Repository: Central (mvnrepository.com)
4.3 Maven页
5.Maven工程项目结构说明
Maven是一个强大的构建工具,它提供一种标准化的项目结构,可以帮助开发者更容易地管理项目的依赖、构建、测试和发布等任务。以下是Maven Web程序的文件结构及每个文件的作用:😦
- pom.xml: Maven项目管理文件,用于描述项目的依赖和构建配置等信息。
- src/main/java:存放项目的Java源代码。
- src/main/resources:存放项目的资源文件,如配置文件、静态资源等。
- src/main/webapp/WEB-INF:存放Web应用的配置文件。
- src/main/webapp/index.jsp:Web应用的入口页面。
- src/test/java:存放项目的测试代码。
- src/test/resources:存放测试相关的资源文件,如测试配置文件等。
四,基于IDEA进行Maven工程构建
1.构建概念和构建过程
项目构建是指将源代码、依赖库和资源文件等转换成可执行或可部署的应用程序的过程,在这个过程中包括编译源 代码、链接依赖库、打包和部署等多个步骤。
项目构建是软件开发过程中至关重要的一部分,它能够大大提高软件开发效率,使得开发人员能够更加专注于应用 程序的开发和维护,而不必关心应用程序的构建细节。
同时,项目构建还能够将多个开发人员的代码汇合到一起,并能够自动化项目的构建和部署,大大降低了项目的出错风险和提高开发效率。常见的构建工具包括Maven、Gradle、Ant等。
2.命令方式项目构建
命令 | 描述 |
---|---|
mvn compile | 编译项目,生成targe文件 |
mvn package | 打包项目,生成jar或war文件 |
mvn clean | 清理编译或打包后的项目结构 |
mvn install | 打包后上传到maven本地仓库 |
mvn deploy | 只打包,上传到maven私服仓库 |
mvn site | 生成站点 |
mvn test | 执行测试源码 |
war包打包插件和jdk版本不匹配:pom.xml添加以下代码即可
<build>
<!-- jdk17 和 war包版本插件不匹配 -->
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.2</version>
</plugin>
</plugins>
</build>
命令触发练习
mvn 命令 命令
#清理
mvn clean
#清理,并重新打包
mvn clean package
#执行测试代码
mvn test
3.可视化方式项目构建
⚠️ 打包(package)和安装(install)的区别是什么
打包是将工程打成jar或war文件,保存在target目录下
安装是将当前工程所生成的jar或war文件,安装到本地仓库,会按照坐标保存到指定位置。
4.构建插件,命令,生命周期命令之间关系
这种行为就是因为构建生命周期产生的!构建生命周期可以理解成是一组固定构建命令的有序集合,触发中, 后的命令,会自动触发周期前的命令!!!
例如:项目打包 mvn clean package 即可。
主要两个构建生命周期:
-
清理周期:主要是对项目编译生成文件进行清理
包含命令:clean -
默认周期:定义了真正构件时所需要执行的所有步骤,它是生命周期中最核心的部分
包含命令:compile - test - package - install - deploy -
插件,命令,周期, 三者关系(了解)
周期→包含若干命令→包含若干插件使用周期命令构建,简化构建过程!最终进行构建的是插件!
五,基于IDEA进行Maven管理依赖
1.依赖管理的概念
Maven依赖管理是Maven软件中最重要的功能之一。Maven 的依赖管理能够帮助开发人员自动解决软件包依赖问题,使得开发人员能够轻松地将其他开发人员开发的模块或第三方框架集成到自己的应用程序或模块中,避免出现版本冲突和依赖缺失等问题。
我们通过定义POM文件,Maven能够自动解析项目的依赖关系,并通过Maven仓库自动下载和管理依赖,从而避免了手动下载和管理依赖的繁琐工作和可能引发的版本冲突问题。
总之,Maven的依赖管理是Maven软件的一个核心功能之一,使得软件包依赖的管理和使用更加智能和方便, 简化了开发过程中的工作,并提高了软件质量和可维护性。
2.Maven工程核心信息配置和解读(GAVP)
位置:pom.xml
<!--模型版本-->
<mode1version>4.0.0</mode1version>
<!--公司或者组织的唯一标志,并且配置时生成的路径也是由此生成,如com.companyname.project-group,
maven会将该项目打成的jar包放本地路径:/com/companyname/project-group-->
<groupId>com.companyname.project-group</groupId>
<!--项目的唯一ID,一个groupId下面可能多个项目,就是靠artifactId来区分的-->
<artifactId>project</artifactId>
<!--版本号-->
<version>1.0.0</version>
<!--打包方式
默认:jar
jar指的是普通的java项目打包方式!项目打成jar包!
war指的是web项目打包方式!项目打成war包!
pom不会讲项目打包!这个项目作为父工程,被其他工程聚合或者继承!后面会讲解两个概念
-->
<packaging>jar/pom/war</packaging>
3.Maven工程依赖管理配置
位置: pom.xml 依赖管理和依赖添加
<!--
通过编写依赖jar包的gav必要属性,引入第三方依赖!
scope属性是可选的,可以指定依赖生效范围!
依赖信息查询方式:
1.maven仓库信息官网https://mvnrepository.com/
2.mavensearch插件搜索
-->
<dependencies>
<!--引入具体的依赖包-->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
<!--依赖范围-->
<scope>runtime</scope>
</dependency>
</dependencies>
依赖版本统一提取和维护
<!--声明版本-->
<properties>
<!--命名随便,内部制定版本号即可!-->
<junit.version>4.12</junit.version>
<!--也可以通过maven规定的固定的key,配置maven的参数!如下配置编码格式!-->
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<!--引用properties声明版本-->
<version>${junit.version}</version>
</dependency>
</dependencies>
4.依赖范围
通过设置坐标的依赖范围(scope),可以设置对应jar包的作用范围:编译环境、测试环境、运行环境
依赖范围 | 描述 |
---|---|
compile | 编译依赖范围,scope 元素的缺省值。使用此依赖范围的Maven依赖,**对于三种 classpath 均有效,**即该 Maven 依赖在上述三种 classpath 均会被引入。例如,log4j在编译、测试、运行过程都是必须的。 |
test | 测试依赖范围。使用此依赖范围的Maven依赖,只对测试classpath有效。例如,Junit依赖只有在测试阶段才需要。 |
provided | 已提供依赖范围。使用此依赖范围的Maven依赖,只对编译classpath和测试classpath有效。例如,servlet-api依赖对于编译、测试阶段而言是需要的,但是运行阶段,由于外部容器已经提供,故不需要Maven重复引入该依赖。 |
runtime | 运行时依赖范围。使用此依赖范围的Maven依赖,只对测试classpath、运行classpath有效。例如,JDBC驱动实现依赖,其在编译时只需JDK提供的JDBC接口即可,只有测试、运行阶段才需要实现了JDBC接口的驱动。 |
system | 系统依赖范围,其效果与provided的依赖范围一致。其用于添加非Maven仓库的本地依赖,通过依赖元素dependency中的systemPath元素指定本地依赖的路径。鉴于使用其会导致项目的可移植性降低,一般不推荐使用。 |
import | 导入依赖范围,该依赖范围只能与dependencyManagement元素配合使用,其功能是将目标中pom.xml文件中dependencyManagement的配置导入合并到当前pom.xml的 |
5.Maven工程依赖下载失败错误解决(重点)
在使用Maven构建项目时,可能会发生依赖项下载错误的情况,主要原因有以下几种:
-
下载依赖时出现网络故障或仓库服务器宕机等原因,导致无法连接至Maven仓库,从而无法下载依赖。
-
依赖项的版本号或配置文件中的版本号错误,或者依赖项没有正确定义,导致Maven下载的依赖项与实际需
要的不一致,从而引发错误。 -
本地Maven仓库或缓存被污染或损坏,导致Maven无法正确地使用现有的依赖项。
解决方案💁♂
- 检查网络连接和Maven仓库服务器状态。
- 确保依赖项的版本号与项目对应的版本号匹配, 并检查POM文件中的依赖项是否正确。
- 清除本地Maven仓库缓存 (lastUpdated文件),因为只要存在lastupdated缓存文件,刷新也不会重新下载。本地仓库中,根据依赖的gav属性依次向下查找文件夹,最终删除内部的文件,刷新重新下载即可!
pom.xml依赖
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.8</version>
</dependency>
将相关错误的文件删除即可
或者可以将清除 lastUpdated 文件的操作写在一个脚本文件中,手动创建文件 “clearLastUpdated.bat” ,名字任意,但是后缀必须是bat(windows 脚本文件),将以下内容复制到文件中
@ECHO OFF
chcp 65001
SET CLEAR_PATH=D
SET CLEAR_DIR=D:\maven-repository ##自己的仓库位置
color 0a
TITLE ClearLastUpdated For Windows
GOTO MENU
:MENU
CLS
ECHO.
ECHO. * * * * ClearLastUpdated For Windows * * * * *
ECHO. * *
ECHO. * 1 清理*.lastUpdated *
ECHO. * *
ECHO. * 2 查看*.lastUpdated *
ECHO. * *
ECHO. * 3 退出 *
ECHO. * *
ECHO. * * * * * * * * * * * * * * * * * * * * * * * *
ECHO.
ECHO. 请输入选择项目的序号
set /p ID=
IF "%ID%"=="1" GOTO cmd1
IF "%ID%"=="2" GOTO cmd2
IF "%ID%"=="3" EXIT
PAUSE
GOTO MENU
:cmd1
ECHO 开始清理...
for /r "%CLEAR_DIR%" %%f in (*.lastUpdated) do (
ECHO 删除 %%f
del "%%f"
)
ECHO 清理完成
PAUSE
GOTO MENU
:cmd2
ECHO 开始查看...
for /r "%CLEAR_DIR%" %%f in (*.lastUpdated) do (
ECHO 找到文件: %%f
)
ECHO 查看完成
PAUSE
GOTO MENU
6.Maven工程Build构建器配置
项目构建是指将源代码、依赖库和资源文件等转换成可执行或可部署的应用程序的过程,在这个过程中包括编译源 代码、链接依赖库、打包和部署等多个步骤。
默认情况下,构建不需要额外配置,都有对应的缺省配置。当然了,我们也可以在pom.xml定制一些配置,来修改默认构建的行为和产物!
例如:
- 指定构建打包文件的名称,非默认名称
- 制定构建打包时,指定包含文件格式和排除文件
- 打包插件版本过低,配置更高版本插件
构建配置是在pom.xml / build标签中指定!⚠️
指定打包命名
<!--默认的打包名称: artifactid+verson.打包方式 -->
<build>
<finalName>定义打包名称</finalName>
</build>
指定打包文件
如果在java文件夹中添加java类,会自动打包编译到classes文件夹下!
但是在java文件夹中添加xml文件,默认不会被打包!
默认情况下,按照maven工程结构放置的文件会默认被编译和打包!
除此之外、我们可以使用resources标签,指定要打包资源的文件夹要把哪些静态资源打包到classes根目录下!
应用场景:mybatis中有时会将用于编写SQL语句的映射文件和mapper接口都写在src/main/java下的某个包中
此时映射文件就不会被打包,如何解决
<build>
<!--设置要打包的资源位置-->
<resources>
<resource>
<!--设置资源所在目录-->
<directory>src/main/java</directory>
<includes>
<!--设置包含的资源类型-->
<include>**/*.xml</include> <!-- 打包任意的.xml文件-->
</includes>
</resource>
</resources>
</build>
配置依赖插件
dependencies标签下引入开发需要的jar包! 我们可以在build/plugins/plugin标签引入插件!
常用的插件: 修改jdk版本, tomcat插件, mybatis分页插件, mybatis逆向工程插件等等!
<build>
<plugins>
<!--java编译插件,配jdk的编译版本-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!--tomcat插件-->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<port>8090</port>
<path>/</path>
<uriEncoding>UTF-8</uriEncoding>
<server>tomcat7</server>
</configuration>
</plugin>
</plugins>
</build>
六,Maven依赖传递和依赖冲突
1.Maven依赖传递特性
概念
假如有Maven项目 A,项目 B 依赖 A,项目 C 依赖 B 。那么我们可以说 C 依赖 A。也就是说,依赖的关系为:C一>B一>A,那么我们执行项目 C 时,会自动把 B、A 都下载导入到 C 项目的 jar 包文件夹中,这就是依赖的传递性。
作用
- 简化依赖导入过程
- 确保依赖版本正确
传递的原则
在 A 依赖 B,B 依赖 C 的前提下,C 是否能够传递到 A ,取决于 B 依赖 C 时使用的依赖范围以及配置
-
B 依赖 C 时使用 compile 范围:可以传递
-
B 依赖 C 时使用 test 或 provided 范围:不能传递,所以需要这样的jar包时,就必须在需要的地方明确配置
依赖才可以。 -
B 依赖 C 时,若配置了以下标签,则不能传递
-
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.15</version> <optional>true</optional> </dependency>
-
依赖传递终止
- 非compile 范围进行依赖传递
- 使用 optional 配置中止传递
- 依赖冲突(传递的依赖已经存在)
案例: 导入jackson依赖
分析: jackson需要三个依赖
依赖传递关系: data-bind中,依赖其他两个依赖
最佳导入: 直接可以导入 data-bind , 自动依赖传递需要的依赖
<!--https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.10.0</version>
</dependency>
2.Maven依赖冲突特性
当直接引用或者间接引用出现了相同的jar包!这时呢,一个项目就会出现相同的重复jar包,这就算作冲突!依赖冲突避免出现重复依赖,并且终止依赖传递!
maven自动解决依赖冲突问题能力,会按照自己的原则,进行重复依赖选择。同时也提供了手动解决的冲突的方
式,不过不推荐!
解决依赖冲突(如何选择重复依赖)方式:
1.自动选择原则
- 短路优先原则 (第一原则)
A->B—>C->D->E->X (version 0.0.1)
A—>F->X (version 0.0.2)
则A依赖于x (version0.0.2) - 依赖路径长度相同情况下,则"先声明优先”(第二原则)
A—>E—>X (version 0.0.1)
A—>F—>X (version 0.0.2)
在< depencies>< /depencies>中,先声明的,路径相同,会优先选择!
2.手动排除(不推荐)
<dependency>
<groupId>com.atguigu.maven</groupId>
<artifactId>pro01-maven-java</artifactId>
<Version>1.0-SNAPSHOT</version>
<scope>compile</scope>
<!--使用excludes标签配置依赖的排除 -->
<exclusions>
<!--在exclude标签中配置一个具体的排除 -->
<exclusion>
<!--指定要排除的依赖的坐标(不需要写version) -->
<groupId>commons-1ogging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
3.小案例
伪代码如下:
前提:
A 1.1 -> B 1.1 -> C 1.1
F 2.2 -> B 2.2
pom声明:
F 2.2
A 1.1
请问最终会导入哪些依赖和对应版本?
七,Maven工程继承和聚合关系
1.Maven工程继承关系
-
继承概念
Maven继承是指在Maven的项目中,让一个项目从另一个项目中继承配置信息的机制。继承可以让我们在多
个项目中共享同一配置信息,简化项目的管理和维护工作。 -
继承作用
父工程中统一管理项目中的依赖信息。
它的背景是:
-
对一个比较大型的项目进行了模块拆分。
-
一个project下面,创建了很多个module。
-
每一个module都需要配置自己的依赖信息。
-
它背后的需求是:
-
在每一个module中各自维护各自的依赖信息很容易发生出入,不易统一管理。
-
使用同一个框架内的不同jar包,它们应该是同一个版本,所以整个项目中使用的框架版本需要统一。
-
使用框架时所需要的jar包组合(或者说依赖信息组合)需要经过长期摸索和反复调试,最终确定一个可
用组合。这个耗费很大精力总结出来的方案不应该在新的项目中重新摸索。 -
通过在父工程中为整个项目维护依赖信息的组合既保证了整个项目使用规范、准确的jar包;又能够将以往的经验沉淀下来,节约时间和精力。
3.继承语法
- 父工程
<groupId>com.atguigu.maven</groupId>
<artifactId>pro03-maven-parent</artifactId>
<Version>1.0-SNAPSHOT</version>
<!--当前工程作为父工程,它要去管理子工程,所以打包方式必须是pom-->
<packaging>pom</packaging>
- 子工程
<!-- 使用parent标签指定当前工程的父工程 -->
<parent>
<!-- 父工程的坐标 -->
<groupId>com.atguigu.maven</groupId>
<artifactId>pro03-maven-parent</artifactId>
<Version>1.0-SNAPSHoT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<!-- 子工程的坐标-->
<!-- 如果子工程坐标中的groupId和version与父工程一致,那么可以省略 -->
<!-- <groupId>com.atguigu.maven</groupId> -->
<artifactId>pro04-maven-module</artifactId>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
4.父工程依赖统一管理
父工程声明版本
<!-- 使用dependencyManagement标签配置对依赖的管理 -->
<!-- 被管理的依赖并没有真正被引入到工程 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>6.0.10</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>6.0.10</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>6.0.10</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-expression</artifactId>
<version>6.0.10</version>
</dependency>
<dependencies>
<dependencyManagement>
子工程声明版本
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<!-- <version>6.0.10</version> -->
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<!-- <version>6.0.10</version> -->
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<!-- <version>6.0.10</version> -->
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-expression</artifactId>
<!-- <version>6.0.10</version> -->
</dependency>
<dependencies>
2.Maven工程聚合关系
1.聚合概念
Mavep聚合是指将多个项目组织到一个父级项目中,以便一起构建和管理的机制。聚合可以帮助我们更好地管理一组相关的子项目,同时简化它们的构建和部署过程。
2.聚合作用
- 管理多个子项目:通过聚合,可以将多个子项目组织在一起,方便管理和维护。
- 构建和发布一组相关的项目:通过聚合,可以在一个命令中构建和发布多个相关的项目,简化了部署和维
护工作。 - 优化构建顺序:通过聚合,可以对多个项目进行顺序控制,避免出现构建依赖混乱导致构建失败的情况。
- 统一管理依赖项:通过聚合,可以在父项目中管理公共依赖项和插件,避免重复定义。
3.聚合语法
父项目中包含的子项目列表
<project>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<packaging>pom</packaging>
<version>1.0.0</version>
<modules>
<!-- 上一级的相对路径 -->
<module>child-project1</module>
<module>child-project2</module>
</modules>
</project>
4.聚合演示
通过触发父工程构建命令,引发所有子模块构建! 产生反应堆!
八,Maven私服(模拟企业开发环境)
1.Maven私服简介
1️⃣ 私服简介
Maven 私服是一种特殊的Maven远程仓库,它是架设在局域网内的仓库服务,用来代理位于外部的远程仓库(中
央仓库、其他远程公共仓库)。
当然也并不是说私服只能建立在局域网,也有很多公司会直接把私服部署到公网,具体还是得看公司业务的
性质是否是保密的等等,因为局域网的话只能在公司用,部署到公网的话员工在家里也可以办公使用。
建立了Maven私服后,当局域网内的用户需要某个构件时,会按照如下顺序进行请求和下载。
-
请求本地仓库,若本地仓库不存在所需构件,则跳转到第2步;
-
请求Maven私服,将所需构件下载到本地仓库,若私服中不存在所需构件,则跳转到第3步。
-
请求外部的远程仓库,将所需构件下载并缓存到Maven私服,若外部远程仓库不存在所需构件,则Maven直接报错。
此外,一些无法从外部仓库下载到的构件,也能从本地上传到私服供其他人使用。
2️⃣ Maven私服的优势
-
节省外网带宽
消除对外部远程仓库的大量重复请求(会消耗很大量的带宽),降低外网带宽压力。 -
下载速度更快
Maven私服位于局域网内,从私服下载构建更快更稳定。 -
便于部署第三方构件
有些构件无法从任何一个远程仓库中获得(如:公司或组织内部的私有构件、Oracle的JDBC驱动等),建立私服之后,就可以将这些构件部署到私服中,供内部Maven项目使用。 -
提高项目的稳定性,增强对项目的控制
果不建立私服,那么Maven项目的构件就高度依赖外部的远程仓库,若外部网络不稳定,则项目的构建过
程也会变得不稳定。建立私服后,即使外部网络状况不佳甚至中断,只要私服中已经缓存了所需的构件,
Maven也能够正常运行。私服软件(如:Nexus)提供了很多控制功能(如:权限管理、
RELEASE/SNAPSHOT版本控制等),可以对仓库进行一些更加高级的控制。 -
降低中央仓库得负荷压力
由于私服会缓存中央仓库得构件,避免了很多对中央仓库的重复下载,降低了中央仓库的负荷。
3️⃣常见的Maven私服产品
- Apache的Archiva
- JFrog的Artifactory
- Sonatype的Nexus ([nekses]) (当前最流行,使用最广泛)
2.Nexus下载安装
下载地址:https://help.sonatype.com/repomanager3/product-information/download
解压,以管理员身份打开CMD, 进入bin目录下,执行./nexus/run命令启动,访问Nexus首页
首页地址:http://localhost:8081/,,8081为默认端口号
3.初始设置
这里参考提示:
- 用户名:admin
- 密码:查看E:IServer\nexus-3.61.0-02-win64\sonatype-work\nexus3\admin.password文件
继续执行初始化
匿名登录, 启用还是禁用? 由于启用匿名登录后,后续操作比较简单,这里我们演示禁用匿名登录的操作:
4.Nexus上的各种仓库
仓库类型 | 说明 |
---|---|
proxy | 某个远程仓库的代理 |
group | 存放: 通过 Nexus 获取的第三方 jar 包 |
hosted | 存放:本团队其他开发人员部署到 Nexus 的jar 包 |
仓库名称 | 说明 |
---|---|
maven-central | Nexus对Maven中央仓库的代理 |
maven-public | Nexus默认创建,供开发人员下载使用的组仓库 |
maven-releases | Nexus默认创建,供开发人员部署自己jar包的宿主仓库要求releases版本 |
maven-snapshots | Nexus默认创建,供开发人员部署自己jar包的宿主仓库要求snapshots版本 |
初始状态下,这几个仓库都没有内容:
5.通过Nexus下载jar包
修改本地maven的核心配置文件 settings.xml, 设置新的本地仓库地址
<!-- 配置一个新的 Maven 本地仓库 -->
<localRepository>D:/maven-repository-new</localRepository>
把我们原来配置的阿里云仓库地址的 mirror 标签改成下面这样:
<mirror>
<id>nexus-mine</id>
<mirrorOf>central</mirrorOf>
<name>Nexus mine</name>
<url>http://localhost:8081/repository/maven-public</url>
</mirror>
把上图中看到的地址复制出来即可。如果我们在前面允许了匿名访问,到这里就够了。但如果我们禁用了匿名访
问,那么接下来我们还要继续 配置settings.xml:
<server>
<id>nexus-mine</id>
<username>admin</username>
<password>atguigu</password>
</server>
这里需要格外注意:server 标签内的id标签值必须和 mirror 标签中的 id 值一样。
找一个用到框架的 Maven 工程,执行命令:
mvn clean compile
下载过程日志:
Downloading from nexus-mine:http://localhost:8081/repository/maven-public/com/jayway/jsonpath/j
son-path/2.4.0/json-path-2.4.0.pom
Downloaded from nexus-mine: http://localhost:8081/repository/maven-public/com/jayway/jsonpath/js
on-path/2.4.0/json-path-2.4.0.pom (2.6 kB at 110 kB/s)
Downloading from nexus-mine:http://localhost:8081/repository/maven-public/net/minidev/json-smar
t/2.3/json-smart-2.3.pom
Downloaded from nexus-mine:http://localhost:8081/repository/maven-public/net/minidev/json-smar
t/2.3/json-smart-2.3.pom (9.0 kB at 376 kB/s)
Downloading from nexus-mine: http://localhost:8081/repository/maven-public/net/minidev/minidev-p
arent/2.3/minidev-parent-2.3.pom
Downloaded from nexus-mine: http://localhost:8081/repository/maven-public/net/minidev/minidev-pa
rent/2.3/minidev-parent-2.3.pom (8.5 kB at 404 kB/s)
Downloading from nexus-mine:http://localhost:8081/repository/maven-public/net/minidev/accessors-
smart/1.2/accessors-smart-1.2.pom
Downloaded from nexus-mine:http://localhost:8081/repository/maven-public/net/minidev/accessors-
smart/1.2/accessors-smart-1.2.pom (12 kB at 463 kB/s)
下载后,Nexus 服务器上就有了 jar 包
若下载速度太慢,可以设置私服中中央仓库的地址为阿里云仓库地址
修改为: http://maven.aliyun.com/nexus/content/groups/public/
6.将 jar 包部署到 Nexus
maven工程中配置:
<distributionManagement>
<snapshotRepository>
<id>nexus-mine</id>
<name>Nexus Snapshot</name>
<ur1>http://localhost:8081/repository/maven-snapshots/</ur1>
</snapshotRepository>I
</distributionManagement>
注意:这里 snapshotRepository 的 id 标签必须和 settings.xml 中指定的 mirror 标签的 id 属性一致。
执行部署命令:
mvn deploy
7.引用别人部署的 jar 包
maven工程中的配置:
<repositories>
<repository>
<id>nexus-mine</id>
<name>nexus-mine</name>
<ur1>http://localhost:8081/repository/maven-snapshots/</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
九, Maven综合案例
1.项目需求和结构分析
需求案例: 搭建一个电商平台项目, 该平台包括用户服务,订单服务,通用工具模块等。
项目架构
-
用户服务: 负责处理用户相关的逻辑,例如用户信息的管理,用户注册,登录等。
- spring-context 6.0.6
- spring-core 6.0.6
- spring-beans 6.0.6
- common-service
-
订单服务: 负责处理订单相关的逻辑,例如订单的创建,订单支付,退货,订单查看等。
- spring-context 6.0.6
- spring-core 6.0.6
- spring-beans 6.0.6
- spring-security 6.0.6
- common-service
-
通用模块: 负责存储其他服务需要通用工具类,其他服务依赖此模块。
- commons-io 2.11.0
- junit 5.9.2
2.项目搭建和统一构建
1️⃣ 父模块(micro-shop)
创建工程:
<?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">
<mode1version>4.0.0</mode1version>
<groupId>com.atguigu</groupId>
<artifactId>micro-shop</artifactId>
<version>1.0-SNAPSHOT</version>
<!--知识点: 父工程的打包方式为pom-->
<packaging>pom</packaging>
<properties>
<spring.version>6.0.6</spring.version>
<jackson.version>2.15.0</jackson.version>
<commons.version>2.11.0</commons.version>
<junit.version>5.9.2</junit.version>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<!--依赖管理-->
<dependencyManagement>
<dependencies>
<!--spring-context 会依赖传递 core/beans -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- jackson-databind 会依赖传递 core/annotations -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<!--commons-io-->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>${commons.version}</version>
</dependency>
<!--https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api -->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!--统一更新子工程打包插件-->
<build>
<!-- jdk17 和 war包版本插件不匹配 -->
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.2</version>
</plugin>
</plugins>
</build>
</project>
可选操作: 删除src目录
2️⃣ 通用模块(common-service)
pom.xml配置
<?xm1 vers1on="1.0" encoding="UTF-8" ?>
<project xm1ns="http://maven.apache.org/pom/4.0.o"
xm1ns: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">
<parent>
<artifactId>micro-shop</artifactId>
<groupId>com.atguigu</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelversion>4.0.0</mode1version>
<artifactId>common-service</artifactId>
<!--知识点:打包方式黑认就是jar,因此可以省略-->
<packaging>jar</packaging>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<!-- 配置spring-context,继承父工程版本,自动传递core/beans -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
</dependency>
<!-- 配置jackson-databind,继承父工程版本,自动传递core/annotations -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
<!--配置commons-io,继承父工程版本-->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
</dependency>
<!--配置junit,继承父工程版本-->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>
3️⃣ 用户模块(user-service)
pom.xml配置
<?xml version="1.0" encoding="uTF-8" ?>
<project xm1ns="http://maven.apache.org/Pom/4.0.o"
xm1ns: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">
<parent>
<artifactId>micro-shop</artifactId>
<groupId>com.atguigu</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<mode1version>4.0.0</modelversion>
<artifactId>user-service</artifactId>
<!--web工程打包方式为war-->
<packaging>war</packaging>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compilertarget>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<l--配置common-service,所需依赖会传递到当前工程(仅限compile范围) -->
<dependency>
<groupId>com.atguigu</groupId>
<artifactId>common-service</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
</project>
4️⃣ 订单模块(order-service)
创建工程,并使用插件转为web工程
</dependencies>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>