Maven依赖中scope标签
- 介绍
- compile
- runtime
- test
- provided
- system
- import
- 依赖传递
介绍
scope元素的主要作用就是控制 dependency 元素的使用范围。因为项目存在编译、运行、测试、等不同的生命周期,在这些生命周期中,使用scope标签可以用来指令maven依赖生效的的范围。通俗的讲,就是控制 Jar 包在哪些范围被加载和使用。
那么scope元素对应的枚举值有哪些呢?
compile
compile 是默认值,如果没有指定 scope 值,该元素的默认值为 compile。也就是说一个dependence标签下没有显示指定该元素的话,该依赖的scope就是compile,被依赖项目需要参与到当前项目的编译,测试,运行等阶段。打包的时候也会被带上。
runtime
runtime表示该依赖不会参与到项目的编译,但是会参与测试,运行周期。与compile相比,就是跳过了编译而已。
举个栗子,使用JDBC定义了数据库连接的协议,那么使用jdbc的API时,对应的API jar是compile的,至于使用oracle jdbc驱动包,还是mysql jdbc驱动包是运行期间的事,可以将后者的scope设置为runtime。另外runntime的依赖通常和optional搭配使用,optional为true。我可以用A实现,也可以用B实现。optional为true的依赖不会打包,需要使用的包含该依赖的项目显式引入。
test
scope为test表示依赖项目仅仅参与测试相关的工作,包括测试代码的编译,执行。比较典型的如junit。
provided
provided意味着打包的时候可以不用包进去,需要别的设施去提供,例如项目的使用方提供SDK包下引用的日志依赖、web 容器提供servlet相关依赖。事实上该依赖理论上可以参与编译,测试,运行等周期。相当于compile,但是在打包阶段做了exclude的动作。
system
system 元素与 provided 元素类似,但是被依赖项不会从 maven 仓库中查找,而是从本地系统中获取,systemPath 元素用于制定本地系统中 jar 文件的路径。例如:
<dependency>
<groupId>org.open</groupId>
<artifactId>open-core</artifactId>
<version>1.5</version>
<scope>system</scope>
<systemPath>${basedir}/WebContent/WEB-INF/lib/open-core.jar</systemPath>
</dependency>
这个一定要配合systemPath标签使用,指定自定义jar包的路径
import
import比较特殊,它只使用在dependencyManagement标签中,表示从其它的pom中导入dependency的配置,打包类型package为pom,例如 (B项目导入A项目中的包配置)。
举个栗子,项目中不想使用spring-boot-starter-parent做为项目的父模块,想使用自定义的pom作为父模块,毕竟maven也是单继承,那么我们可以通过在import的方式将spring-boot-dependencies的pom依赖配置导入到项目中,然后使用springboot相关的starter项
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>1.3.3.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
如果我们自己定义的相关的maven依赖在类似上面的pom依赖中,然后在dependencyManagement标签中导入为scope元素import,就可以使pom文件变的非常简洁,具体的maven配置项放在具体pom里,就像java中使用组合而非继承的方式。
依赖传递
A–>B–>C。当前项目为A,A依赖于B,B依赖于C。知道B在A项目中的scope,那么怎么知道C在A中的scope呢?答案是:
当C是test或者provided时,C直接被丢弃,A不依赖C;
否则A依赖C,C的scope继承于B的scope。
具体关系可以参照表格
直接依赖 ----------------- 传递依赖
compile | provided | runtime | test | |
compile | compile(*) | - | runtime | - |
provided | provided | - | provided | - |
runtime | runtime | - | runtime | - |
test | test | - | test | - |
如果感兴趣,可以MAVEN官网了解相关Dependence Scope知识。