Maven 依赖中 scope 详解

前言
  • Maven 的哲学思想是,约定优于配置(Convention Over Configuration),Maven 依赖中 scope 的默认值是compile
  • Scope 指定了依赖(第三方jar包)的 作用范围
  • 作用范围包括,所在项目的测试、编译、运行、打包等生命周期
  • 其中,编译和运行还分为
    • 测试代码的编译和运行
    • 非测试代码的编译和运行
scope 分类
  • test 测试范围
    • 测试范围的依赖(第三方jar包),针对测试相关代码的编译和运行,在通常代码的编译和运行时都不需要,只有在有关测试的代码编译和运行测试代码阶段可用
    • 案例说明
      • 环境 IJ maven web project
      • 前提:需知facade slf4j 只有在classpath 中发现底层日志实现framework时才起作用
        pom.xml
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <!--此处test,表明 junit jar包只能出现在 test 环境下的classpath,
            即 只能在标记为 “TestSources Root的 文件夹下”被调用, 而在“标记为Sources Root 的文件夹下”找不到其中的类-->
            <scope>test</scope> 
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.25</version>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>1.7.25</version>
            <!--此处test 是关键,表明底层日志实现框架-也即该依赖在test 代码编译、运行时才起作用-->
            <scope>test</scope> 
        </dependency>

    </dependencies>

测试代码

  • 测试方法之一,即是上面pom注释,junit 类调用只能在TestSources Root 目录下起作用
  • 测试方法之二

Sources Root 目录下

public class LogDemo {
    Logger logger = LoggerFactory.getLogger(LogDemoTest.class);
    public static void main(String[] args) {
        Logger logger = LoggerFactory.getLogger(LogDemo.class);
        //不能找到底层日志使系统,因为 该依赖 为 test 范围
        logger.info("log");
    }
}

输出:
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

TestSources Root 目录下

public class LogDemoTest {
    Logger logger = LoggerFactory.getLogger(LogDemoTest.class);
    @Test
    public void test() {
        //能找到底层日志实现系统
        logger.info("junit test"); 
    }
}

输出:
[main] INFO log.learn.LogDemoTest - junit test
  • compile 编译范围
    • 依赖默认范围,该依赖需要参与当前项目的编译、测试、运行、打包
    • 什么叫参与当前项目的编译???
  • runtime 运行时范围
    • 表示依赖无需参与当前项目的编译,但是后期的运行和测试需要参与,不参与编译能运行成功吗??
    • 与 compile 相比,跳过编译而已
    • 比如,你可能在编译的时候需要 JDBC API JAR,只有在 运行时才需要 JDBC
    • 貌似是编译时该包不参与,运行时参与
  • provided 表明该依赖已经提供,故只在未提供时才被使用
    • 应用场景是你定义了一个Servlet,此刻得需要Servlet-api.jar 才能编译成功,但是当你达成war 包时,你并不想将 Servlet-api.jar 包进去,因为Tomcat等容器会提供
    • 跟compile 类似,说明JDK、容器或使用者会提供这个依赖,如Servlet.jar
    • 这个依赖只作用在** 编译和测试,该依赖会由系统组件提供,不需手动添加,只存在编译、运行、测试阶段,打包是不用包进去,打包阶段做了exclude**动作
    • 没有传递性
  • system
    • 被依赖项不会从maven仓库下载,而是从本地系统指定路径下寻找,需要 systemPath 属性
scope 的传递依赖
  • A -> B -> C, 当前项目 A,A依赖于B,B依赖于C,知道B在 A中的scope,怎么知道 C在 A 中的 scope
    • 即,A需不需要 C的问题,本质由 C在B中的scope决定
    • 当 C 在 B 中的scope 是test 或 provided 时,C 直接被丢弃A不依赖C
    • 否则 A 依赖 C,C的scope 继承与B 的scope
    原文作者:HelloTrident
    原文地址: https://www.jianshu.com/p/a9bd44a83dc5
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞