经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » 软件/图像 » Maven » 查看文章
Maven 整理
来源:cnblogs  作者:紫邪情  时间:2024/7/8 10:00:12  对本文有异议

# Maven简介

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

这玩意儿是使用Java开发的,所以采用的就是Java的思想:面向对象

POM (Project Object Model):项目对象模型
截屏2021-07-17 下午6.51.07

Maven的作用:

  1. 项目构建:提供标准的、跨平台的自动化项目构建方式
  2. 依赖管理:方便快捷的管理项目依赖的资源(jar包),避免资源间的版本冲突问题
  3. 统一开发结构:提供标准的、统一的项目结构

下载与安装:

# Maven基础概念

image-20240621211654330

仓库:用于存储资源,包含各种jar包

仓库分类:本地仓库和远程仓库(私服和中央仓库)

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

坐标的主要组成:

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

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

仓库配置:

  • 本地仓库配置:默认位置与自定义位置
  • 远程仓库配置:
  1. <repositories>
  2. <repository>
  3. <id>central</id>
  4. <name>Central Repository</name>
  5. <url>https://maven.aliyun.com/repository/central</url>
  6. <layout>default</layout>
  7. <snapshots>
  8. <enabled>false</enabled>
  9. </snapshots>
  10. </repository>
  11. </repositories>

镜像仓库配置:阿里云Maven镜像仓库配置地址

  1. <mirrors>
  2. <mirror>
  3. <!-- 此镜像的唯一标识符,用来区分不同的mirror元素 -->
  4. <id>nexus-aliyun</id>
  5. <!-- 对那种仓库进行镜像(就是替代哪种仓库)-->
  6. <mirrorOf>central</mirrorOf>
  7. <!-- 镜像名称 -->
  8. <name>Nexus aliyun</name>
  9. <!-- 镜像URL -->
  10. <url>https://maven.aliyun.com/repository/public</url>
  11. </mirror>
  12. </mirrors>

全局setting和用户setting

  • 定义当前计算机中Maven的公共配置,即 mavne安装目录/conf/setting.xml
  • 定义当前用户配置,即 配置的本地仓库地址处有个平级的setting.xml

注:用户setting和全局setting不一致时,会优先采用用户setting.xml的配置,因此最好是这二者内容保持一致

# Maven项目

# 手动生成Maven项目

Maven工程目录结构

截屏2021-07-17 下午6.50.36

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

  1. mvn compile # 编译
  2. mvn clean # 清理
  3. mvn test # 测试
  4. mvn package # 打包
  5. mvn install # 安装到本地仓库

# IDEA生成Maven项目

使用原型创建Maven项目与不使用原型创建Maven项目

例:使用原型创建web项目,选择archetype-webapp进行项目创建,添加Tomcat插件

  1. <build>
  2. <plugins>
  3. <plugin>
  4. <groupId>org.apache.tomcat.maven</groupId>
  5. <artifactId>tomcat7-maven-plugin</artifactId>
  6. <version>2.1</version>
  7. <configuration>
  8. <port>80</port>
  9. <path>/</path>
  10. </configuration>
  11. </plugin>
  12. </plugins>
  13. </build>

# 依赖管理

  1. 依赖配置:依赖指的是当前项目运行所需要的jar,一个项目可以设置多个依赖。格式:

    1. <!--设置当前项目所依赖的所有jar-->
    2. <dependencies>
    3. <!--设置具体的依赖-->
    4. <dependency>
    5. <!--依赖所属群组id-->
    6. <groupId></groupId>
    7. <!--依赖所属项目id-->
    8. <artifactId></artifactId>
    9. <!--依赖版本号-->
    10. <version></version>
    11. <!--
    12. <type>pom</type>
    13. <scope>import</scope>
    14. 只能用在 <dependencyManagement></dependencyManagement> 中
    15. -->
    16. <!--类型:jar 则导入jar包 pom 导入的是一个父模块-->
    17. <type></type>
    18. <!--
    19. 作用域:import 代表把父模块中的jar包导入进来
    20. 为import时,dependency不参与依赖传递
    21. 只是把dependency需要的依赖都取过来,像个占位符一样替换了就行
    22. -->
    23. <scope>import</scope>
    24. </dependency>
    25. </dependencies>
  2. 依赖传递

依赖具有传递性,包括直接传递和间接传递

直接传递:在当前项目中通过依赖配置建立的依赖关系(A使用B,A和B就是直接传递)

间接传递:被依赖的资源如果依赖其他资源,当前项目间接依赖其他资源(比较拗口,意思是如果A依赖B,而B依赖C,那么A和C之间就是间接传递)

img

依赖传递的冲突问题:

  • 路径优先:当依赖中出现相同的资源时,层级越深,优先级越低,层级越浅,优先级越高
  • 声明优先:当资源在相同层级被依赖时,配置顺序靠前的覆盖配置顺序靠后的
  • 特殊优先:当同级配置了相同资源的不同版本,后配置的覆盖先配置的
  1. 可选依赖

可选依赖指的是对外隐藏当前所依赖的资源

  1. <dependency>
  2. <groupId></groupId>
  3. <artifactId></artifactId>
  4. <version></version>
  5. <!--添加下面这一行-->
  6. <optional>true</optional>
  7. </dependency>
  1. 排除依赖

排除依赖指主动断开依赖的资源,被排除的资源无需指定版本

  1. <dependency>
  2. <groupId></groupId>
  3. <artifactId></artifactId>
  4. <version></version>
  5. <exclusions>
  6. <exclusion>
  7. <groupId></groupId>
  8. <artifactId></artifactId>
  9. </exclusion>
  10. </exclusions>
  11. </dependency>
  1. 依赖范围

依赖的jar包默认情况可以在任何地方使用,可以通过scope标签设定其作用范围

作用范围:

  • 主程序范围有效(main文件夹范围内)
  • 测试程序范围有效(test文件夹范围内)
  • 是否参与打包(package文件夹范围内)
截屏2021-07-17 下午7.10.15

还有两个:system、import

  • import:依赖项替换为指定 POM 的 <dependencyManagement>中的该依赖项。仅 <dependencyManagement> 部分中 pom 类型的依赖项支持此范围
  1. 依赖范围传递性:带有依赖范围的资源在传递时,作用范围会受到影响

image-20240621212758397

# 生命周期与插件

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

image-20240621212937084

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

  1. clean:清理工作
  2. default:核心工作,例如编译、测试、打包、部署等
  3. site:产生报告,发布站点等

clean生命周期:

  • pre-clean:执行一些需要在clean之前完成的工作
  • clean:移除所有上一次构建生成的文件
  • post-clean:执行一些需要在clean之后立刻完成的工作

default构建生命周期:compile ——> test-compile ——> test ——> package ——> install

  • validate(校验) 校验项目是否正确并且所有必要的信息可以完成项目的构建过程

  • initialize(初始化) 初始化构建状态,比如设置属性值

  • generate-sources(生成源代码) 生成包含在编译阶段中的任何源代码

  • process-sources(处理源代码) 处理源代码,比如说,过滤任意值

  • generate-resources(生成资源文件) 生成将会包含在项目包中的资源文件

  • process-resources (处理资源文件) 复制和处理资源到目标目录,为打包阶段最好准备

  • compile(编译) 编译项目的源代码

  • process-classes(处理类文件) 处理编译生成的文件,比如说对Java class文件做字节码改善优化

  • generate-test-sources(生成测试源代码) 生成包含在编译阶段中的任何测试源代码

  • process-test-sources(处理测试源代码) 处理测试源代码,比如说,过滤任意值

  • generate-test-resources(生成测试资源文件) 为测试创建资源文件

  • process-test-resources(处理测试资源文件) 复制和处理测试资源到目标目录

  • test-compile(编译测试源码) 编译测试源代码到测试目标目录

  • process-test-classes(处理测试类文件) 处理测试源码编译生成的文件

  • test(测试) 使用合适的单元测试框架运行测试(Juint是其中之一)

  • prepare-package(准备打包) 在实际打包之前,执行任何的必要的操作为打包做准备

  • package(打包) 将编译后的代码打包成可分发格式的文件,比如JAR、WAR或者EAR文件

  • pre-integration-test(集成测试前) 在执行集成测试前进行必要的动作。比如说,搭建需要的环境

  • integration-test(集成测试) 处理和部署项目到可以运行集成测试环境中

  • post-integration-test(集成测试后) 在执行集成测试完成后进行必要的动作。比如说,清理集成测试环境

  • verify (验证) 运行任意的检查来验证项目包有效且达到质量标准

  • install(安装) 安装项目包到本地仓库,这样项目包可以用作其他本地项目的依赖

  • deploy(部署) 将最终的项目包复制到远程仓库中与其他开发者和项目共享

site生命周期:

  • pre-site 执行一些需要在生成站点文档之前完成的工作

  • site 生成项目的站点文档

  • post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备

  • site-deploy 将生成的站点文档部署到特定的服务器上

插件:插件与生命周期内的阶段绑定,在执行到对应的生命周期时执行对应的插件功能

  1. <build>
  2. <plugins>
  3. <plugin>
  4. <groupId>org.apache.maven.plugins</groupId>
  5. <artifactId>maven-source-plugin</artifactId>
  6. <version>2.2.1</version>
  7. <!--执行插件-->
  8. <executions>
  9. <!--具体怎么执行-->
  10. <execution>
  11. <!--目标:执行什么-->
  12. <goals>
  13. <!--执行jar-->
  14. <goal>jar</goal>
  15. </goals>
  16. <!--执行到那个生命周期阶段时就要执行该插件 对应前面default中的那些值-->
  17. <phase>generate-test-resources</phase>
  18. </execution>
  19. </executions>
  20. </plugin>
  21. </plugins>
  22. </build>

<goal>jar</goal>值选项:官网:Apache Maven Source Plugin

  • source:aggregate aggregrates sources for all modules in an aggregator project.
  • source:jar is used to bundle the main sources of the project into a jar archive——对main中源代码打包
  • source:test-jar on the other hand, is used to bundle the test sources of the project into a jar archive——对测试代码打包
  • source:jar-no-fork is similar to jar but does not fork the build lifecycle.
  • source:test-jar-no-fork is similar to test-jar but does not fork the build lifecycle.

# 聚合

作用:聚合用于快速构建Maven工程,一次性构建多个项目/模块

制作方式:创建一个空模块,打包类型定义为pom

  1. <packaging>pom</packaging>

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

  1. <modules>
  2. <module>模块地址</module>
  3. <module>模块地址</module>
  4. <module>模块地址</module>
  5. <module>模块地址</module>
  6. </modules>

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

# 继承

作用:通过继承可以实现在子工程中沿用父工程中的配置(与Java类似)

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

  1. <!--定义该工程的父工程-->
  2. <parent>
  3. <groupId></groupId>
  4. <artifactId></artifactId>
  5. <version></version>
  6. <!--填写父工程的pom文件-->
  7. <relativePath>父工程pom文件地址</relativePath>
  8. </parent>

在父工程中定义依赖管理

  1. <!--声明此处进行依赖管理-->
  2. <dependencyManagement>
  3. <!--具体的依赖-->
  4. <dependencies>
  5. <dependency>
  6. <groupId></groupId>
  7. <artifactId></artifactId>
  8. <version></version>
  9. </dependency>
  10. </dependencies>
  11. </dependencyManagement>
  12. <!--要管理插件的话,使用如下方式-->
  13. <build>
  14. <pluginManagement>
  15. <plugins>
  16. <plugin>
  17. <groupId></groupId>
  18. <artifactId></artifactId>
  19. <version></version>
  20. <!--.....................-->
  21. </plugin>
  22. </plugins>
  23. </pluginManagement>
  24. </build>

继承依赖使用:在子工程中定义依赖关系,无需声明依赖版本,版本参照父工程中依赖的版本

  1. <!--子工程使用依赖-->
  2. <dependencies>
  3. <dependency>
  4. <groupId></groupId>
  5. <artifactId></artifactId>
  6. </dependency>
  7. </dependencies>
  8. <!--子工程使用插件-->
  9. <build>
  10. <plugins>
  11. <plugin>
  12. <groupId></groupId>
  13. <artifactId></artifactId>
  14. <!--<version></version>-->
  15. </plugin>
  16. </plugins>
  17. </build>

继承的资源:

image-20240622012647178

# 继承与聚合的区别

作用:聚合用于快速构建项目,继承用于快速配置

相同点:

  • 聚合与继承的pom.xml文件打包方式均为pom,可以将两种关系制作到同一个pom文件中

  • 聚合与继承均属于设计型模块,并无实际的模块内容

不同点:

  • 聚合是在当前模块中配置关系,聚合可以感知到参与聚合的模块有哪些

  • 继承是在子模块中配置关系,父模块无法感知哪些子模块继承了自己

# 属性

  1. 自定义属性

作用:等同于定义变量,方便统一维护

定义格式:

  1. <!--定义自定义属性-->
  2. <properties>
  3. <spring.version>5.1.9.RELEASE</spring.version>
  4. <junit.version>4.12</junit.version>
  5. </properties>

调用格式:

  1. <dependency>
  2. <groupId>org.springframework</groupId>
  3. <artifactId>spring-context</artifactId>
  4. <version>${spring.version}</version>
  5. </dependency>
  1. 内置属性

作用:使用Maven内置属性,快速配置

调用格式:

  1. ${basedir}
  2. ${version}
  1. Setting属性

作用:使用Maven配置文件setting.xml中的标签属性,用于动态配置

调用格式:

  1. ${settings.localRepository}
  1. Java系统属性

作用:读取Java系统属性

调用格式:

  1. ${user.home}

系统属性查询方式:

  1. mvn help:system
  1. 环境变量属性

作用:使用Maven配置文件setting.xml中的标签属性,用于动态配置

调用格式:

  1. ${env.JAVA_HOME}

环境变量属性查询方式:

  1. mvn help:system

# 版本管理

SNAPSHOT(快照版本):

  • 项目开发过程中,方便团队成员合作,解决模块间相互依赖和实时更新的问题,开发者对每个模块进行构建的时候,输出的临时性版本就叫快照版本(测试阶段版本)
  • 快照版本会随着开发的进展不断更新

RELEASE(发布版本):

  • 项目开发到进入阶段里程碑后,向团队外部发布较为稳定的版本,这种版本所对应的构建文件是稳定的,即便进行功能的后续开发,也不会改变当前发布版本的内容,这种版本就叫发布版本

工程版本号约定:

截屏2021-07-17 下午8.24.46

# 资源配置

配置文件引用pom属性

作用:在任意配置文件中加载pom文件中定义的属性

  1. pom中定义变量:
  1. <properties>
  2. <jdbc.username>root</jdbc.username>
  3. <jdbc.password>zixieqing072413</jdbc.password>
  4. </properties>
  1. pom中开启配置文件加载pom属性
  1. <build>
  2. <!--配置资源文件对应的信息-->
  3. <resources>
  4. <resource>
  5. <!--设定配置文件对应的位置目录 如 application.yml
  6. 支持使用属性动态设定路径 如 ${project.basedir}-->
  7. <directory>地址</directory>
  8. <!--开启对配置文件的资源加载过滤-->
  9. <filtering>true</filtering>
  10. </resource>
  11. </resources>
  12. <!--test配置文件也需要使用时:配置资源文件对应的信息-->
  13. <testResources>
  14. <testResource>
  15. <!--设定配置文件对应的位置目录 如 application.yml
  16. 支持使用属性动态设定路径 如 ${project.basedir}-->
  17. <directory>地址</directory>
  18. <!--开启对配置文件的资源加载过滤-->
  19. <filtering>true</filtering>
  20. </testResource>
  21. </testResources>
  22. </build>
  1. 在需要使用变量得到配置文件中使用,调用格式:
  1. ${地址}
  2. <!--示例-->
  3. ${jdbc.username}

# 多环境开发配置

  1. <!--创建多环境-->
  2. <profiles>
  3. <!--定义具体的环境:生产环境-->
  4. <profile>
  5. <!--定义环境对应的唯一名称 如 prod_env-->
  6. <id>开发环境名称1</id>
  7. <!--定义环境中的专用的属性值-->
  8. <properties>
  9. <jdbc.url>jdbc链接</jdbc.url>
  10. </properties>
  11. <!--将该套环境设为默认启动环境-->
  12. <activation>
  13. <activeByDefault>true</activeByDefault>
  14. </activation>
  15. </profile>
  16. <!--定义具体的环境:开发环境 格式同上-->
  17. </profiles>

Maven使用命令启动那套环境:

  1. mvn 指令 -p 环境定义id
  2. # 示例
  3. mvn install -p prod_env

# 跳过测试

提示

正式开发时,不建议跳过

跳过测试的场景:

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

使用方式:

  1. 命令的方式
  1. mvn 指令 D skipTests
  2. # 示例
  3. mvn install D skipTests

注意

执行的指令生命周期必须包含测试环节

  1. 使用IDEA界面操作

image-20240622024041847

  1. 使用pom配置
  1. <plugin>
  2. <artifactId>maven-surefire-plugin</artifactId>
  3. <version>2.22.1</version>
  4. <configuration>
  5. <!-- 设置跳过测试 -->
  6. <skipTests>true</skipTests>
  7. <!-- 包含指定的测试用例 -->
  8. <includes>
  9. <include>**/User*Test.java</include>
  10. </includes>
  11. <!-- 排除指定得到测试用例 -->
  12. <excludes>
  13. <exclude>**/User*TestCase.java</exclude>
  14. </excludes>
  15. </configuration>
  16. </plugin>

# 私服

使用Nexus,是sonatype的产品:

启动服务器(Windows):

  1. nexus.exe /run nexus

访问服务器:默认端口8081,可在其配置文件中修改

  1. http://localhost:8081

修改基础配置信息:安装路径/etc/nexus-default.properties,如默认端口号

修改服务器运行配置:安装路径/bin/nexus.vmoptions,如默认内存空间大小

# IDEA中资源上传和下载

私服仓库分类:

宿主仓库(hosted):保存无法从中央仓库获取的资源,如

  • 自主研发
  • 第三方非开源项目

代理仓库(proxy):代理远程仓库,通过Nexus访问其他公共仓库

仓库租(group):

  • 将若干残酷组成一个群组,简化配置
  • 仓库租不保存资源,属于设计型仓库

image-20240622154257305

私服用户名密码:配置在本地仓库的setting.xml中即可

上传位置:配置在IDEA中,上传到私服中的仓库组不同

下载地址:配置在本地仓库的setting.xml即可

# 访问私服配置

  1. 配置本地仓库访问私服权限(setting.xml)
  1. <servers>
  2. <server>
  3. <!--放release版本的 和nexus中命名保持一致-->
  4. <id>zixq-release</id>
  5. <!--访问私服的用户名密码-->
  6. <username>admin</username>
  7. <password>admin</password>
  8. </server>
  9. <server>
  10. <!--放snapshots版本的-->
  11. <id>zixq-snapshots</id>
  12. <username>admin</username>
  13. <password>admin</password>
  14. </server>
  15. </servers>
  1. 配置本地仓库来源(setting.xml)
  1. <!--可以和阿里云仓库同时存在-->
  2. <mirrors>
  3. <mirror>
  4. <id>nexus-zixq</id>
  5. <mirrorOf>*</mirrorOf>
  6. <url>http://localhost:8081/repository/maven-public/</url>
  7. </mirror>
  8. </mirrors>

# IDEA发布依赖到私服配置

  1. 配置当前项目访问私服上传资源的保存位置(pom.xml)
  1. <distributionManagement>
  2. <repository>
  3. <!--仓库id,和上面本地仓库setting.xml中server id保持一致-->
  4. <id>zixq-release</id>
  5. <!--放release版仓库的url-->
  6. <url>http://localhost:8081/repository/zixq-release/</url>
  7. </repository>
  8. <snapshotRepository>
  9. <id>zixq-snapshots</id>
  10. <url>http://localhost:8081/repository/zixq-snapshots/</url>
  11. </snapshotRepository>
  12. </distributionManagement>
  1. 发布资源到私服的命令
  1. mvn deploy

流程:通过IDEA pom中配置的<url>http://localhost:8081/repository/zixq-release/</url>访问私服,通过<id>zixq-release</id>去本地仓库的setting.xml 的server id找访问私服的username、password,然后进行发布

# IDEA插件之Maven Helper

Maven Helper可以解决依赖问题,安装了Maven Helper插件,只要打开pom文件,就可以打开该pom文件的Dependency Analyzer视图,并且这个页面还支持搜索。很方便

进入Dependency Analyzer视图之后有三个查看选项,分别是:

  • Conflicts:冲突
  • All Dependencies as List:列表形式查看所有依赖
  • All Dependencies as Tree:树结构查看所有依赖

image-20240622161654202

image-20240622161913548

# jar包冲突说明

解决IDEA中jar包冲突,使用maven的插件:maven helper插件,它能够给我们罗列出来同一个jar包的不同版本,以及它们的来源,但是对不同jar包中同名的类没有办法

# 依赖顺序

点击【All Dependencies as Tree】,查看:从上向下,A依赖于B,B依赖于C

image-20240622162333722

.点击【Conflicts】,从图中可以看出有哪些jar存在冲突,存在冲突的情况下最终采用了哪个依赖的版本。标红的就是冲突版本,白色的是当前的解析版本。这个选项,需要从下向上看

image-20240622162927630

# 解决思路

  1. 排除指定的版本:如果有两个依赖的版本发生了冲突,那么只要用exclusion关键字把其中一个依赖给排除掉,只剩下一个依赖即可

image-20240622163156783

  1. 子工程指定版本号

  2. 子工程先排除,再指定版本号:如下图,在starter-web中排除spring-webmvc,然后指定spring-webmvc的版本为6.0.9

image-20240622163357642

  1. 锁定版本:使用dependencyManagement统一对依赖的版本进行定义

  2. 路径优先:当依赖中出现相同的资源时,层级越深,优先级越低,层级越浅,优先级越高。实际使用就是直接在pom中显示使用且定义版本

  3. 声明优先:当资源在相同层级被依赖时,配置顺序靠前的覆盖配置顺序靠后的

  4. 特殊优先:当同级配置了相同资源的不同版本,后配置的覆盖先配置的

# 对应MD文档

链接:Maven 笔记

原文链接:https://www.cnblogs.com/zixq/p/18288560

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号