侧边栏壁纸
博主头像
Nicholas的个人博客博主等级

用心去追逐，沉浸在小小世界

  • 累计撰写 23 篇文章
  • 累计创建 1 个标签
  • 累计收到 1 条评论

目 录CONTENT

文章目录
Java开发知识

Maven 学习笔记

Nicholas
Nicholas
2024-05-14 / 0 评论 / 0 点赞 / 5 阅读 / 30875 字

Maven学习笔记

【Maven官网】https://maven.apache.org/

【Maven Repository官网】https://mvnrepository.com/

零、参考教程

0.1、2021最新Maven教程-IDEA版【看完】

【视频地址】https://www.bilibili.com/video/BV1Fz4y167p5

老师从底层（使用记事本）开始讲起，对于Maven的入门和原理的理解很有帮助，并且声音很好听。美中不足是笔记的很多地方有笔误，并且讲解有的地方有点小错误（如打包多模块项目的步骤，应该是只要打包父项目即可）。

一、Maven简介

1.1、总体知识结构

20240514110333_831107.png

1.2、基本介绍

Apache Maven的本质是一个软件项目管理和理解工具。基于项目对象模型 (Project Object Model，POM) 的概念，Maven 可以通过一条中心信息，管理项目的构建、报告和文档。

Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.

作为Apache组织中的⼀个颇为成功的开源项目，Maven主要服务于基于java平台的项⽬构建，依赖管理和项目信息管理。

无论是小型的开源类库项目，还是大型的企业级应用；无论是传统的瀑布式开发，还是流行的敏捷开发，Maven都能大显身手。

1.3、各类项目构建工具

1.1.1、Ant

最早的构建工具，大概是2000年有的，是当时最流行Java构建工具，不过它的XML脚本编写格式让XML文件特别大。对工程构建过程中的过程控制特别好。

1.1.2、Maven

项目对象模型（POM），通过其描述信息来管理项目的构建、报告和文档的软件项目管理工具。它填补了Ant缺点，Maven第一次支持了从网络上下载的功能，仍然采用xml作为配置文件格式。Maven专注的是依赖管理，使用Java编写。

1.1.3、Gradle

结合以上两者的优点，它继承了Ant的灵活和Maven的生命周期管理，它最后被google作为了Android御用管理工具。它最大的区别是不用XML作为配置文件格式，采用了DSL格式，使得脚本更加简洁。

【构建工具的选择】目前市面上Ant比较老，所以一般是一些比较传统的软件企业公司使用。Maven使用Java编写，是当下大多数互联网公司会使用的一个构建工具，中文文档也比较齐全。gradle使用groovy编写，是目前比较新型的构建工具。一些初创互联网公司会使用，以后会有很大的使用空间。

1.4、Maven四大特性

1.4.1、依赖管理系统

Maven为Java引入了一个新的依赖管理系统（jar包管理），jar升级时修改配置文件即可。

可以使用groupId, artifactId, version组成的坐标（Coordination）唯一标识一个依赖。

任何基于Maven构建的项目自身也必须定义这三项属性，生成的包可以是jar包，也可以是war包。

<!-- 依赖引用示例  -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
</dependency>

坐标属性：Maven坐标为各种组件引入了秩序，任何一个组件都必须明确定义自己的坐标。

groupId：定义当前Maven项目隶属的实际项目-公司名称（jar包所在仓库路径）。由于Maven中模块的概念，因此一个实际项目往往会被划分为很多模块。比如spring是一个实际项目，其对应的Maven模块会有很多，如spring-core, spring-webmvc等。

artifactld：该元素定义实际项目中的一个Maven模块-项目名，推荐的做法是使用实际项目名称作为artifactld的前缀。比如spring-bean, spring-webmvc等。

version：该元素定义Maven项目当前所处的版本。

1.4.2、多模块构建

项目复查时dao service controller层分离将一个项目分解为多个模块已经是很通用的一种方式。

在Maven中需要定义一个parent POM作为一组module的聚合POM。在该POM中可以使用标签来定义一组子模块。parent POM不会有什么实际构建产出。而parent POM中的build配置以及依赖配置都会自动继承给child module。

1.4.3、—致的项目结构

Ant时代大家创建Java项目目录时比较随意，然后通过Ant配置指定哪些属于source，哪些属于testSource等。

而Maven在设计之初的理念就是Conversion over configuration（约定大于配置），其制定了一套项目目录结构作为标准的Java项目结构，解决不同ide带来的文件目录不一致问题。

1.4.4、⼀致的构建模型和插件机制

在编写 JavaWeb 项目时需要使用类似 tomcat 的服务器，我们可以通过插件的形式将服务器引入进来。

例如，如果需要使用 jetty 的服务器，可以通过下面的配置将 jetty 服务器引入进来。

<plugin>
	<groupId>org.mortbay.jetty</groupId>
	<artifactId>maven-jetty-plugin</artifactId>
	<version>6.1.25</version>
	<configuration>
		<scanIntervalSeconds>10</scanIntervalSeconds>
		<contextPath>/test</contextPath>
	</configuration>
</plugin>

二、Maven安装配置

【注意】安装maven需提前安装jdk环境，详见java笔记.md。

2.1、Maven下载

进入官网下载地址（https://maven.apache.org/download.cgi），选择合适的版本。

20240514110333_857113.png

直接点击链接下载，或者可以使用wget命令下载。

wget https://dlcdn.apache.org/maven/maven-3/3.9.5/binaries/apache-maven-3.9.5-bin.tar.gz

解压下载好的压缩包，并移动到合适的目录。

# 解压压缩包
tar -zxvf apache-maven-3.9.5-bin.tar.gz

# 移动文件夹到合适的位置（可选）
mv apache-maven-3.9.5 ~/maven/

2.2、配置环境变量

把Maven的根目录配置到系统环境变量MAVEN_HOME中，将bin目录配置到path变量中。

【注】maven解压后存放的目录不要包含中文和空格。

vim /etc/profile

# 在环境变量部分修改如下内容 仅需要新增注释标记的部分 其他部分为原有配置
export JAVA_HOME=/usr/local/java/jdk-11.0.21
export MAVEN_HOME=/usr/local/maven   # 新增
export PATH=$PATH:$JAVA_HOME/bin:$MAVEN_HOME/bin  # 新增 $MAVEN_HOME/bin

刷新使配置文件生效。

source /etc/profile

2.4、检查安装成功

使用如下命令检查是否安装配置成功。

mvn -v

20240514110333_872888.png

2.5、本地仓库和镜像配置

配置本地仓库和阿里云镜像。

cd ~/maven/   # 进入maven目录
mkdir repo    # 创建目录 repo

# 编辑conf/settings.xml 文件
vim conf/settings.xml

# 添加本地仓库配置
<localRepository>/usr/local/maven/repo</localRepository>
# Windows 的地址示例 D:/m2/repository（如果不修改，默认在 C 盘用户目录中的 .m2 目录下）

# 注释掉原本的镜像，添加阿里云镜像
<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>

# 注：如果需要通过代理才能联网，则还需要配置代理
<proxy>
  <id>optional</id>    
  <active>true</active>
  <protocol>http</protocol>
  <!-- <username></username> -->
  <!-- <password></password> -->
  <host>10.26.2.36</host>
  <port>8981</port>
  <!-- <nonProxyHosts>10.26.2.**</nonProxyHosts>  -->
</proxy>

三、创建Maven项目

3.1、Maven项目目录结构

20240514110334_185060.png

3.2、编译并运行

进入项目的根目录，执行以下命令。

mvn compile   # 编译 java 文件（成功会提示 BUILD SUCCESS）
mvn exec:java -Dexec.mainClass="com.xxxx.demo.Hello"  # 执⾏指定 java 类文件的 main ⽅法

四、常用Maven命令

作为开发利器的maven，为我们提供了十分丰富的命令，了解maven的命令行操作并熟练运用常见的maven命令是十分必要的。虽然IDEA等工具提供了图形界面化工具，但其底层还是依靠maven命令来驱动的。

Maven的命令格式如下：

# 执行 plugin-name 插件的 goal-name 目标
mvn [plugin-name]:[goal-name]

4.1、常用命令

命令描述
mvn -version显示版本信息
mvn clean清理项目产生的临时文件，一般是模块下的target目录
mvn compile编译源代码，一般编译模块下的src/main/java目录
mvn package项目打包命令，会在模块下的target目录生成jar或者war等文件
mvn test测试命令，执行src/test/java/下的junit测试用例
mvn install将打包的jar或war文件复制到你的本地仓库中，供其他模块使用
mvn deploy将打包的文件发布到远程参考，供其他人进行下载依赖
mvn site生成项目相关信息的网站
mvn eclipse:eclipse将项目转化为Eclipse项目
mvn dependency:tree打印出项目的整个依赖树
mvn archetype:generate创建Maven的普通java项目
mvn tomcat7:run在tomcat容器中运行web应用
mvn jetty:run调用Jetty插件的Run目标在Jetty Servelet容器中启动web应用

【注意】运行maven命令的时候，首先需要定位到maven项目的目录，也就是项目的pom.xml文件所在的目录。否则，必须通过参数来指定项目的目录。

4.2、命令参数

上面列举的只是比较通用的命令，其实很多命令都可以携带参数以执行更精准的任务。

4.2.1、-D传入属性参数

使用示例如下：

mvn package -Dmaven.test.skip=true

以-D开头，将maven.test.skip的值设为true，就是告诉maven打包的时候跳过单元测试。同理，mvn deploy-Dmaven.test.skip=true代表部署项目并跳过单元测试。

4.2.2、-P使用指定的profile配置

比如项目开发需要有多个环境，一般为开发、测试、预发、正式4个环境，在pom.xml中的配置如下：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>dev</env>
        </properties>
        <activation>
        	<activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <profile>
		<id>qa</id>
        <properties>
            <env>qa</env>
        </properties>
    </profile>
    <profile>
        <id>pre</id>
    	<properties>
			<env>pre</env>
		</properties>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>prod</env>
        </properties>
    </profile>
</profiles>
......
<build>
    <filters>
        <filter>config/${env}-properties</filter>
    </filters>
	<resources>
		<resource>
			<directory>src/main/resources</directory>
             <filtering>true</filtering>
        </resource>
    </resources>
</build>

profiles定义了各个环境的变量id，filters中定义了变量配置文件的地址，其中地址中的环境变量就是上面profile中定义的值，resources中是定义哪些目录下的文件会被配置文件中定义的变量替换。

通过maven可以实现按不同环境进行打包部署，例如：

mvn package -Pdev -Dmaven.test.skip=true   # 打包本地环境，并跳过单元测试

五、IDEA集成Maven环境

5.1、环境配置

找到IDEA中的如下位置。

20240514110333_888346.png

配置好如下三个选项，点击Apply。

20240514110333_903620.png

设置自动导入Maven依赖。

20240514110334_200801.png

5.2、创建Maven项目

5.2.1、Java项目

5.2.1.1、创建项目

选择File -> New -> Project。可以选择quickstart模板，或者直接不选即可。

20240514110333_919142.png

设置项目的groupId和artifactId。

20240514110333_934508.png

检查Maven环境，选择Next。

20240514110333_950399.png

检查项目名和工作空间，选择Finish。

20240514110333_965903.png

等待项目创建，下载资源，完成后目录结构如下。

20240514110333_981197.png

【注意】

1、右下角弹出的提示框，选择"Enable Auto-Import"（Maven启动自动导入）

2、Maven的版本高于IDEA版本，创建Maven项目时可能会出现报错。解决方法：使用IDEA默认的Maven等。

5.2.1.2、编译项目

点击右上角的添加配置（或者直接使用IDEA右边的Maven窗口执行）。

20240514110333_996983.png

选择Maven配置。

20240514110334_012269.png

设置编译项目的命令。

20240514110334_027849.png

执行编译命令，两个图标分别代表普通模式和调试模式。

20240514110334_043204.png

编译成功。

20240514110334_059076.png

5.2.2、Web项目

5.2.2.1、创建项目

创建Web项目与创建Java项目步骤基本一致，区别在于Maven模板选择webapp。

20240514110334_075076.png

创建完成后，项目的目录结构如下。

20240514110334_091173.png

5.2.2.2、项目配置

根据自己的需要修改JDK的版本。

<!-- JDK的版本修改为1.8 -->
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</ maven.compiler.source>
    <maven.compiler.target>1.8</ maven.compiler.target>
</properties>

设置junit的版本。

<!-- junit的版本修改为4.12 -->
<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
</dependencies>

删除pluginManagement标签。

<!-- 将这个标签及标签中的内容全部删除 -->
<pluginManagement>
    ...
</pluginManagement>

添加web部署的插件（在build标签中）。

【注】下述配置Jetty和Tomcat任选其一即可。

<plugins>
    <!-- Jetty 插件（轻量级的服务器） -->
    <plugin>
        <groupId>org.mortbay-jetty</groupId>
        <artifactId>maven-jetty-plugin</artifactId>
        <version>6.1.25</version>
        <configuration>
            <!-- 热部署，每 10 秒扫描一次 -->
            <scanIntervalseconds>10</scanIntervalseconds>
            <!-- 可指定当前项目的站点名 -->
            <contextPath>/test</contextPath>
            <connectors>
                <connector implementation="org.mortbay.jetty.nio.selectChannelConnector">
                    <!-- 设置启动的端口号 -->
                    <port>9090</ port>
                </connector>
            </connectors>
        </configuration>
    </plugin>
	
    <!-- Tomcat 插件 -->
    <plugin>
        <groupId>org-apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <version>2.1</version>
        <configuration>
            <!-- 启动端口默认:8080 -->
            <port>8080</port>
            <!-- 项目的站点名，即对外访问路径 -->
            <path>/test</path>
            <!--字符集编码默认︰ISO-8859-1 -->
            <uriEncoding>UTF-8</uriEncoding>
            <!--服务器名称-->
            <server>tomcat7</server>
        </configuration>
    </plugin>
</plugins>
5.2.2.3、启动项目

添加jetty插件配置。

20240514110334_107170.png

上述命令中，也可以在命令中直接指定端口。

jetty:run -Djetty.port=9090  # 需要将插件配置中的 port 标签去掉

20240514110334_123211.png

也可以添加Tomcat插件配置。

20240514110334_139173.png

启动成功后浏览器访问8080端口即可看到效果。

六、Maven仓库

当第一次运行Maven命令的时候，你需要Internet链接，因为它需要从网上下载一些文件。那么它从哪里下载呢？它是从Maven默认的远程库下载的。这个远程仓库有Maven的核心插件和可供下载的jar文件。

对于Maven来说，仓库只分为两类：本地仓库和远程仓库。

当Maven根据坐标寻找构件的时候，它首先会查看本地仓库，如果本地仓库存在，则直接使用；如果本地没有，Maven就会去远程仓库查找，发现需要的构件之后，下载到本地仓库再使用。如果本地仓库和远程仓库都没有，Maven就会报错。

远程仓库分为三种：中央仓库，私服，其他公共库。

  • 中央仓库是默认配置下，Maven下载jar包的地方。
  • 私服是另一种特殊的远程仓库，为了节省带宽和时间，可以在局域网内架设一个私有的仓库服务器，用其代理所有外部的远程仓库。内部的项目还能部署到私服上供其他项目使用。

一般来说，在Maven项目目录下，没有诸如lib/这样用来存放依赖文件的目录。当Maven在执行编译或测试时，如果需要使用依赖文件，它总是基于坐标使用本地仓库的依赖文件。

默认情况下，每个用户在自己的用户目录下都有一个路径名为.m2/repository/的仓库目录。有时候，因为某些原因（比如c盘空间不足），需要修改本地仓库目录地址。

6.1、中央仓库

由于原始的本地仓库是空的，maven必须知道至少一个可用的远程仓库，才能在执行maven命令的时候下载到需要的构件。中央仓库就是这样一个默认的远程仓库。

中央仓库包含了2000多个开源项目，接收每天1亿次以上的访问。

6.2、私服

私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的maven用户使用。当maven需要下载构件时，它去私服当中找，如果私服没有，则从外部远程仓库下载，并缓存在私服上，再为maven提供。

此外，一些无法从外部仓库下载的构件也能从本地上传到私服提供局域网中其他人使用。

使用私服的好处：1、节省外网带宽；2、加速maven构建；3、部署第三方控件；4、提高稳定性；5、降低中央仓库的负荷。

项目的pom.xml配置示例：

<repositories>
	<repository>
	     <snapshots>
			<enabled>true</enabled>
         </snapshots>
		<id>public</id>
		<name>Public Repositories</name>
		<url>http://192.168.0.96:8081/content/groups/public/</url>
    </repository>
	<repository>
		<id>getui-nexus</id>
		<url>http://mvn.gt.igexin.com/nexus/content/repositories/releases/</url>
	</repository>
</repositories>

6.3、其他公共库

常用的阿里云仓库配置。

<mirror>
	<id>nexus-aliyun</id>
	<mirrorOf>central</mirrorOf>
    <name>Nexus aliyun</name>
	<url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

七、Maven中构建多模块项目

使用maven提供的多模块构建的特性，完成maven环境下多模块项目的管理与构建。

这里以四个模块为例来搭建项目。

模块 maven_parent —— 基模块，就是常说的 parent (pom)
模块 maven_dao —— 数据库的访问层，例如 jdbc 操作 (jar)
模块 maven_service —— 项目的业务逻辑层 (jar)
模块 maven_controller —— 用来接收请求，响应数据 (war)

7.1、创建项目和模块

7.1.1、创建maven_parent项目

新建一个Maven项目。

20240514110334_216065.png

设置groupId和artifactId。

20240514110334_231022.png

确认项目名称和工作空间。

20240514110334_246272.png

7.1.2、创建maven_dao模块

选择项目maven_parent，右键新建模块。

20240514110334_261809.png

选择maven的普通java项目。

20240514110334_277822.png 20240514110334_293641.png 20240514110334_308938.png 20240514110334_324407.png

7.1.3、创建maven_service模块

创建步骤同maven_dao模块。

7.1.4、创建maven_controller模块

创建步骤基本同maven_dao模块，只需将模板修改为web项目模板即可。

7.1.5、检查模块创建和修改配置文件

模块全部创建完毕后，效果如下：

20240514110334_339916.png

可以修改各个子模块对应的配置文件。

7.2、设置模块之间的依赖

7.2.1、maven_dao模块

新建包文件夹。

20240514110334_155209.png

新建UserDao类。

20240514110334_355334.png 
package com.xxxx.dao;

public class UserDao {
	public static void testDao () {
		system.out.println ( "UserDao Test...");
	}
}

7.2.2、maven_service模块

添加maven_dao模块的依赖。

<!-- 加入 maven_dao 模块的依赖 -->
<dependency>
	<groupId>com.xxxx</groupId>
	<artifactId>maven_dao</artifactid>
    <version>1.0-SNAPSHOT</version>
</dependency>

新建UserService类。

package com.xxxx.service;

import com.xxxx.dao.UserDao;

public class Userservice {
	public static void testservice() {
		system.out.println("UserService Test...");
        // 调用 UserDao 的方法
		UserDao.testDao();
	}
}

7.2.3、maven_controller模块

添加maven_service模块的依赖。

<!-- 加入 maven_service 模块的依赖 -->
<dependency>
	<groupId>com.xxxx</groupId>
    <artifactId>maven_service</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

添加servlet的依赖。

<!-- servlet 的依赖 -->
<dependency>
	<groupId>javax.servlet</groupId>
	<artifactId>javax.servlet-api</artifactid>
    <version>3.0.1</version>
	<scope>provided</scope>
</dependency>

添加Tomcat插件，参见5.2.2节。

创建UserServlet类（如果main目录下没有java源文件夹，可以自己手动创建，并指定为Sources Root类型文件夹）。

package com.xxxx.controller;

import com.xxxx.service.Userservice;

import javax.servlet.servletException;
import javax.servlet.annotation.webServlet;
import javax.servlet.http.Httpservlet;
import javax.servlet.http.HttpservletRequest;
import javax.servlet.http.HttpservletResponse;
import java.io.IOException;

@webServlet("/user")
public class UserServlet extends Httpservlet {
	@override
	protected void service(HttpServletRequest req, HttpServletResponse resp) throws servletException, IOException {
		system.out.println("Userservlet Test...");  
         // 调用 UserService 层的方法
		Userservice.testservice();
}

使用快捷键Ctrl+o可以打开选择override方法的菜单。

7.2.4、安装模块

安装顺序为，先install父项目，如果有出错再单独install出错的子项目。

install maven项目时，右侧maven->lifecircle直接选中双击更加方便。

7.2.5、启动项目

配置如下运行命令。

20240514110334_370612.png

启动成功后，可以通过网址访问项目。控制台输出如下：

20240514110334_170081.png

八、Maven的打包操作

对于企业级项目，无论是进行本地测试，还是测试环境测试，以及最终的项目上线，都会涉及项目的打包操作。对于每个环境下的项目打包时，对应的项目所需要的配置资源都会有所区别，实现打包的方式有很多种：可以通过ant，或者通过IDEA自带的打包功能实现项目的打包，但当项目很大并且需要的外界配置很多时，此时打包的配置就会异常复杂。

对于maven项目，我们可以用pom.xml配置的方式来实现打包时的环境选择，相比于其他的打包工具，maven只需要通过简单的配置，就可以轻松完成不同环境下项目的整体打包。

比如下面这样一个项目，项目中配置了不同环境下所需要的配置文件，需要完成不同环境下的打包操作。

8.1、准备好一个项目

使用idea创建项目，目录结构可能会缺失，需要手动添加对应的目录（也可在创建时直接勾选对应的文件夹）。

以下展示了一个基本的web项目所具有的项目结构。

20240514110334_385954.png

添加不同环境对应的文件夹和相关的配置文件。

20240514110334_401706.png

8.2、添加profile配置

在项目的pom.xml文件中添加如下配置。

<!-- 打包环境配置: 开发环境 测试环境 正式环境 -->
<profiles>
	<profile>
        <id>dev</id>
        <properties>
            <env>dev</env>
        </properties>
		<!-- 未指定环境时，默认打包 dev 环境 -->
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
	<profile>
        <id>test</id>
        <properties>
            <env>test</env>
        </properties>
    </profile>
    <profile>
        <id>product</id>
        <properties>
            <env>product</env>
        </properties>
    </profile>
</profiles>

8.3、添加资源文件配置

在项目的pom.xml文件中的<build>标签内添加如下配置。

<!-- 对于项目资源文件的配置，放在 build 中-->
<resources>
	<resource>
        <directory>src/main/resources/${env}</directory>
    </resource>
	<resource>
		<directory>src/main/java</directory>
         <includes>
			<include>**/*.xml</include>
			<include>**/*.properties</include>
             <include>**/*.tld</include>
        </includes>
        <filtering>false</filtering>
    </resource>
</resources>

8.4、执行打包操作

打开IDEA的命令配置页面，输入打包命令。

20240514110334_416947.png

运行后打包成功。

20240514110334_431754.png

不同的项目打包得到的文件不一样，一般来说，普通java项目打成jar包，web项目打成war包。

20240514110334_446945.png

九、Maven依赖

9.1、依赖的基本配置

根元素project下的dependencies可以包含多个dependency元素，以声明多个依赖。每个依赖都应该包含以下元素：

1、groupld, artifactld, version：依赖的基本坐标，对于任何一个依赖来说，基本坐标是最重要的，Maven根据坐标才能找到需要的依赖。

2、Type：依赖的类型，大部分情况下不需要声明。默认值为jar。

3、Scope：依赖范围（compile, test, provided, runtime, system）

  • compile：编译依赖范围。

    如果没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。

  • test：测试依赖范围。

    使用此依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将无法使用此类依赖。典型的例子就是JUnit，它只有在编译测试代码及运行测试的时候才需要。

  • provided：已提供依赖范围。

    使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时无效。典型的例子是servlet-api，编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器已经提供，就不需要Maven重复地引入一遍。

  • runtime：运行时依赖范围。

    使用此依赖范围的Maven依赖，对于测试和运行classpath有效，但在编译主代码时无效。典型的例子是JDBC驱动程序，项目主代码的编译只需要JDK提供的JDBC接口，只有在执行测试或者运行项目的时候才需要实现上述接口的具体JDBC驱动。

  • system：系统依赖范围。

    该依赖和provided依赖范围完全一致。但是，使用system范围依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，因此应该谨慎使用。

4、Optional：标记依赖是否可选。<optional>标签被设置为true，表示该依赖项是可选的。开发者可以根据实际需要选择是否包含该依赖项。值得注意的是，optional标签不仅适用于直接依赖项，还可以用于传递性依赖项。这意味着如果一个项目依赖于一个可选的库，而该库又依赖于另一个库，那么只有当直接引用该库时，其传递性依赖项才会被包含进来。这对于避免不必要的传递性依赖和潜在的版本冲突非常有用。

5、Exclusions：用来排除传递性依赖。使用示例如下9.3节。

9.2、依赖范围

Maven在编译、测试、运行项目的时候，往往会用到多套不同的classpath。

例如：编译项目代码的时候需要用到spring-core，该文件以依赖的方式被引入到编译环境的classpath中；而测试项目的时候，可能会用到另一套classpath，其包含junit。而在运行项目的环境中，使用的classpath包括spring-core，而不包括junit。

依赖范围就是用来控制依赖与这三种classpath（编译classpath，测试classpath，运行classpath）的关系，Maven的具体依赖范围及说明见上一小节。

9.3、传递性依赖

传递依赖机制，让我们在使用某个jar的时候就不用去考虑它依赖了什么，也不用担心引入多余的依赖。

Maven会解析各个直接依赖的POM，将那些必要的间接依赖，以传递性依赖的形式引入到当前项目中。

【注意】传递依赖有可能产生冲突！！

# 冲突场景
A --> B --> C (2.0)
A --> D --> C (1.0)

如果A同时依赖两个不同version的C，冲突！需要选取同时适合A、D的版本。

<dependencies>
	<dependency>
		<groupId>A</groupId>
		<artifactId>A</artifactId>
         <version>xxx</version>
		<exclusions>
            <!-- 排除 A 依赖的 C -->
			<exclusion>
				<groupId>C</groupid>
				<artifactId>C</artifactId>
            </exclusion>
		</exclusions>
    </dependency>
	<dependency>
		<groupId>B</groupId>
		<artifactId>B</artifactid>
    </dependency>
</dependencies>

9.4、依赖覆盖

默认情况下，自定义的Maven依赖的版本会优先覆盖传递依赖的Maven依赖的版本。

9.5、依赖图展示

IDEA中，可以在pom.xml文件中右键，选择Show Diagraphs来直观地展示依赖图和依赖链。

9.6、依赖继承

待后续记录。

0
版权归属： Nicholas
本文链接： https://blogforcheer.club/archives/maven-note
许可协议： 本文使用《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》协议授权

评论区