结合《Maven实战》源码中account-email的例子。
Maven定义的规则:任何一个构建都可以使用Maven坐标唯一标识,Maven坐标的元素包括groupId、artifactId、version、packaging、classifier。
Maven坐标为各种构件引入了秩序,任何一个构件都必须明确定义自己的坐标,而一组Maven坐标是通过一些元素定义的,它们是groupId、artifactId、version、packaging、classifier。
--groupId 定义当前Maven项目隶属的实际项目。groupId的表示方式与Java包名的表示方式类似,通常与域名反向一一对应。
--artifactId 该元素定义实际项目中的一个Maven项目(模块),推荐的做法是使用实际项目名称作为artifactId的前缀。
--version 该元素定义Maven项目当前所处的版本。
--packaging 该元素定义maven项目的打包方式。
--classifier 该元素用来帮助定义构建输出的一些附属构件,附属构件与主构件对应。
上述元素中,groupId、artifactId、version是必须定义的,packaging是可选的(默认为jar),而classifier是不能直接定义的。
根元素project下的dependencies可以包含一个或多个dependency元素,以声明一个或多个项目依赖,每个依赖可以包含的元素有:
--groupId、artifactId和version。依赖的基本坐标,对于任何一个依赖来说,基本坐标是最重要的,Maven根据坐标才能找到需要的依赖。
--type 依赖的类型,对应于项目坐标定义的packaging。大部分情况下,该元素不必声明,默认为jar。
--scope 依赖的范围
--optional 标记依赖是否可选
-- exclusions 用来排除传递性依赖
依赖范问就是用来控制依赖于这三种classpath(编译classpath、测试classpath、运行classpath)的关系,Maven有以下几种依赖范围:
--compile 编译依赖范围。如果没有指定,就会默认使用该依赖范围。使用此依赖范围的maven依赖,对于编译、测试、运行三种classpath都有效。(典型:spring-core)
--test 测试依赖范围。使用此依赖范围的Maven依赖,只对于测试classpath有效,在编译主代码或者运行项目的使用时将无法使用此类依赖。(典型:junit)
--provided 已提供依赖范围。使用此依赖范围的Maven依赖,对于编译和测试classpath有效,但在运行时无效。(典型:servlet-api,编译和测试时需要依赖,但运行时,容器已提供)
--runtime 运行时依赖范围,使用此依赖范围的maven依赖,对于测试和运行classpath有效,但在编译主代码时无效。(典型:JDBC驱动实现)
--system 系统依赖范围。该依赖与三种classpath的关系,和provided依赖范围完全一致。
--import 导入依赖范围。该依赖范围不会对三种classpath产生实际的影响。
依赖范围(scope) | 对于编译classpath有效 | 对于测试classpath有效 | 对于运行时classpath有效 | 例子 |
compile | Y | Y | Y | spring-core |
test | - | Y | - | junit |
provided | Y | Y | - | servlet-api |
runtime | - | Y | Y | JDBC驱动实现 |
system | Y | Y | - | 本地的,Maven仓库之外的类库文件 |
假设A依赖于B,B依赖于C,我们说A对于B是第一直接依赖,B对于C是第二直接依赖,A对于C是传递性依赖,第一直接依赖的范围和第二直接依赖的范围决定了传递性依赖的范围。
compile | test | provided | runtime | |
compile | compile | - | - | runtime |
test | test | - | - | test |
provided | provided | - | provided | provided |
runtime | runtime | - | - | runtime |
Maven依赖调解原则
第一原则:路径最近者优先。
第二原则,第一声明者优先。在依赖路径长度相等的前提下,在POM定义声明的顺序决定了谁会被解析使用,顺序最靠前的那个依赖优胜。
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.juven.mvnbook.account</groupId>
<artifactId>project-a</artifactId>
<version>1.0.0</version>
<dependencies>
<dependency>
<groupId>com.juven.mvnbook.account</groupId>
<artifactId>project-b</artifactId>
<version>1.0.0</version>
<exclusions>
<exclusion>
<groupId>com.juven.mvnbook.account</groupId>
<artifactId>project-c</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.juven.mvnbook.account</groupId>
<artifactId>project-c</artifactId>
<version>1.1.0</version>
</dependency>
</dependencies>
</project>
代码中使用exclusions元素声明排除依赖,exclusions可以包含一个或多个exclusion子元素,因此可以排除一个或者多个传递性依赖。需要注意的是,声明exclusion的时候只需要groupId和artifactId而不需要verion元素。
mvn dependency:list
可查看当前项目的已解析依赖。
mvn dependency:tree
可查看当前项目的依赖树
mvn dependency:analyze
可帮助分析当前项目的依赖。