maven依赖总结

1.依赖元素

groupId,必选，实际隶属项目

artifactId,必选，其中的模块

version必选，版本号

type可选，依赖类型，默认jar

scope可选，依赖范围，默认compile

optional可选，标记依赖是否可选，默认false

exclusion可选，排除传递依赖性，默认空

2.依赖范围

maven项目又三种classpath（编译，测试，运行）

scope用来表示与classpath的关系，总共有五种

compile:编译，测试，运行

test:测试

provided:编译，测试

runtime:运行

system:编译，测试，同provided，但必须指定systemPath，慎用

3.传递性依赖

顾名思义，你懂的，但是传递的范围会发生改变，这个由maven自身处理，只要理解下即可

第一列为第一依赖，第二列为第二依赖，单元格为传递范围

	compile	test	provided	runtime
compile	compile	_	_	runtime
test	test	_	_	test
provided	provided	_	provided	provided
runtime	runtime	_	_	runtime

4.依赖调解

传递路径长度取最短原则，传递路径长度相等时，采取最先申明原则

5.可选依赖

尽量少用，可选依赖不会被传递，需要显式申明

6.排除依赖

发现依赖包里有些包不稳定，可以排除依赖，显式的申明文档的包

7.分类依赖

当同一个模块，所依赖的几个模块版本都相同时，可以使用maven里的属性做分类依赖，依赖版本升级时改一处即可

8.优化依赖

可概括为三个命令

mvn dependency:list

表示依赖列表，maven eclipse插件已经实现，有图形化显示，在pom.xml的dependencies页

mvn dependency:tree

表示依赖列表，maven eclipse插件已经实现，有图形化显示，在pom.xml的dependency hierarchy页

mvn dependency:analyze

查找出在编译和测试中未使用但显示声明的依赖

9.依赖传递

maven的依赖关系是有传递性的。如：A-->B，B-->C。但有时候，项目A可能不是必需依赖C，因此需要在项目A中排除对A的依赖。在maven的依赖管理中，有两种方式可以对依赖关系进行，分别是可选依赖（Optional Dependencies）以及依赖排除（Dependency Exclusions）。

一、可选依赖

当一个项目A依赖另一个项目B时，项目A可能很少一部分功能用到了项目B，此时就可以在A中配置对B的可选依赖。举例来说，一个类似hibernate的项目，它支持对mysql、oracle等各种数据库的支持，但是在引用这个项目时，我们可能只用到其对mysql的支持，此时就可以在这个项目中配置可选依赖。

配置可选依赖的原因：1、节约磁盘、内存等空间；2、避免license许可问题；3、避免类路径问题，等等。

示例：

<project>
  ...
  <dependencies>
    <!-- declare the dependency to be set as optional -->
    <dependency>
      <groupId>sample.ProjectB</groupId>
      <artifactId>Project-B</artifactId>
      <version>1.0</version>
      <scope>compile</scope>
      <optional>true</optional> <!-- value will be true or false only -->
    </dependency>
  </dependencies>
</project>

假设以上配置是项目A的配置，即：Project-A --> Project-B。在编译项目A时，是可以正常通过的。

如果有一个新的项目X依赖A，即：Project-X -> Project-A。此时项目X就不会依赖项目B了。如果项目X用到了涉及项目B的功能，那么就需要在pom.xml中重新配置对项目B的依赖。

二、依赖排除

当一个项目A依赖项目B，而项目B同时依赖项目C，如果项目A中因为各种原因不想引用项目C，在配置项目B的依赖时，可以排除对C的依赖。

示例（假设配置的是A的pom.xml，依赖关系为：A --> B; B --> C）：

<project>
  ...
  <dependencies>
    <dependency>
      <groupId>sample.ProjectB</groupId>
      <artifactId>Project-B</artifactId>
      <version>1.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>  <!-- declare the exclusion here -->
          <groupId>sample.ProjectC</groupId>
          <artifactId>Project-C</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
  </dependencies>
</project>

当然，对于多重依赖，配置也很简单，参考如下示例：

Project-A
   -> Project-B
        -> Project-D
              -> Project-E <! -- This dependency should be excluded -->
              -> Project-F
   -> Project C

A对于E相当于有多重依赖，我们在排除对E的依赖时，只需要在配置B的依赖中进行即可：

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>sample.ProjectA</groupId>
  <artifactId>Project-A</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>
  ...
  <dependencies>
    <dependency>
      <groupId>sample.ProjectB</groupId>
      <artifactId>Project-B</artifactId>
      <version>1.0-SNAPSHOT</version>
      <exclusions>
        <exclusion>
          <groupId>sample.ProjectE</groupId> <!-- Exclude Project-E from Project-B -->
          <artifactId>Project-E</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
  </dependencies>
</project>

参考资料：

1、maven官网： http://maven.apache.org/guides/introduction/introduction-to-optional-and-excludes-dependencies.html