（二）Maven之坐标和依赖

image.png

目录
[TOC]

坐标

引言： 坐标是依赖管理的基础，是构建的唯一标识。

组成元素： 使用groupId、artifactId、version、packaging、classifier标签即可定义一组坐标
规定：groupId,artifactId,version是必须定义的，
packaging的定义是可选的，classifier是不能直接定义的，而是以后附加的插件帮助生成的。

<groupId> org.sonatype.nexus </groupId>
<artifactId> nexus-indexer </artifactId>
<version> 2.0.0 </version>
<packaging> jar </packaging>

groupId: 定义了Maven项目隶属的<u>实际项目</u>。

groupId命名误区：

• Maven项目不一定和实际项目一一对应。实际项目可能被划分为多个Maven项目
• 不应该定义到项目隶属的组织或公司级别，因为组织或公司可能有多个项目。
• 与java包名命名方式相似，通常以域名反向对应。

artifactId: 定义了下实际项目的一个<u>Maven项目</u>

• 建议使用实际项目名作为artifactId的前缀。
• 一般来说，项目中Java类的包都应该基于项目的groupId和artifactId.

version: 定义了Maven项目当前所处的版本。

packaging: 定义了Maven项目的打包方式。

打包方式通常与所生成构件扩展名对应，但是不是绝对的，而且打包方式会影响构建的生命周期。

classifier: 定义了构建输出的一些附属构件。如：在包中生成的文档或源代码。

依赖

eg:
        <dependency>
            <groupId>javax.validation</groupId>
            <artifactId>validation-api</artifactId>
            <version>1.1.0.Final</version>
            <scope>provided</version>
            <optional>true</optional>
              <exclusions>
                <exclusion>
                    <groupId>XXXX</groupId> 
                    <artifactId>XXX</artifactId>
                </exclusion>
        </dependency>

每个依赖包含的元素有：

• groupId,artifactId,version: 依赖的基本坐标
• type: 依赖的类型，对应定义坐标时的packaging,默认值为jar.
• scope: 依赖的范围
• optional: 当前依赖是否可选
• exclusions: 用来排除传递性依赖

依赖范围【scope】

Maven有三种classpath，分别供编译时（编译项目主代码）、测试时（编译和执行测试代码）、运行时（项目实际运行时）使用。
依赖范围： 用来控制依赖同三种classpath的关系，即：是否将依赖引入相应的classpath中。

依赖范围（scope）	编译classpath 生效	测试classpath 生效	运行时classpath生效	栗子
compile	Y	Y	Y	spring-core
test	N	Y	N	JUit
provided	Y	Y	Y	N	servlet-api
runtime	N	Y	Y	JDBC驱动实现
sytem	Y	Y	N	除本地的Maven仓库外的jar包

• 依赖范围不仅可以控制依赖和classpath的关系，还对传递性依赖产生影响
• 可选依赖不能被传递！！！

扩展： 为什么要使用可选依赖属性（optional）呢？
eg: 项目B进入了X、Y的两个可选依赖，一般由业务形态决定的，业务上存在互斥性，用户不可能同时使用X、Y的功能。
理想情况，其实是不应该使用可选依赖的，本着“单一职责”设计原则，最好分离开来设计。

传递性依赖

	compile	test	provided	runtime
compile	compile	不传递	不传递	runtime
test	test	不传递	不传递	test
provided	provied	不传递	provied	provided
runtime	runtime	不传递	不传递	runtime

注： 左边第一列是第一直接依赖，最上边一行是第二直接依赖。

依赖调解

当产生重复依赖冲突时，采用以下原则解决：

• 第一原则： 依赖路径最近者优先
  eg: 路径1： A -> B -> C -> X（version:1.0)
  路径2： A -> D -> X（version:2.0)
  因此原则，传递性依赖X（version:2.0)将会被项目引用。

• 第二原则： 路径长度相同，将由pom.xml总依赖声明的顺序决定。
  eg: 路径1： A -> B -> Y（version:1.0)
  路径2： A -> C -> Y（version:2.0)
  若C的引入顺序在B的前面，则 传递性依赖Y（version:2.0)将会被项目引用。

最佳实践

• 排除依赖： 使用exclusion标签定义。
• 归类依赖： 运用Maven属性，使用properties元素定义Maven属性，并引用即可。
• 优化依赖：

mvn dependency:list (以列表方式展示项目依赖列表，包含传递性依赖)
mvn dependency:tree (以树形结构展示项目依赖列表)