第四章 Maven-依赖管理

一、依赖管理概述

除非项目特别小，通常一般项目都会依赖外部jar包。这些jar包管理是非常繁琐的，jar包会依赖其他jar包，如果手工管理必须把所有这些jar都放到项目目录下，并且确保这些jar包的版本是正确的。当项目变得越来越大时，这项工作将变得更加繁琐。

使用Maven管理这些依赖的jar包，将大大简化工作。可以在POM文件中指定项目所依赖的外部库以及版本，然后maven将下载这些jar包，并放入本地库中。如果某些外部jar包需要其他jar包，maven也会下载。

在POM文件的<dependencies>元素中指定项目依赖项。

二、依赖管理示例

# 示例：

<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.test.demo</groupId>
    <artifactId>mybatis-demo</artifactId>
    <version>0.0.1</version>  
    <packaging>jar</packaging>  

    <name>mybatis demo </name>  
    <url>http://www.qikegu.com</url>  

    <!-- https://mvnrepository.com/artifact/org.jsoup/jsoup -->
    <dependency>
        <groupId>org.jsoup</groupId>
        <artifactId>jsoup</artifactId>
        <version>1.11.3</version>
    </dependency>


    <dependencies>  
        <!-- https://mvnrepository.com/artifact/junit/junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13-beta-2</version>
            <scope>test</scope>
        </dependency>

    </dependencies>  

</project>  

上面配置了2个依赖项。每个依赖项都由groupId、artifactId和版本描述。

当Maven执行这个POM文件时，如果本地库中没有这2个依赖项，maven将从中央库去下载它们并放入本地库。

有时中央库也没有需要的依赖项，如一些第三方jar包，开发人员可以自己手动下载，然后放到本地库中。本地库的jar包目录必须匹配<dependency>中的配置，目录格式是：

groupId/artifactId/version

groupId中如果有点(.)替换成斜杠(/)，如上面jsoup jar包所在的目录是：

MAVEN_REPOSITORY_ROOT/org/jsoup/jsoup/1.11.3

三、传递依赖

一个依赖项依赖于其他依赖项，maven会传递这些依赖，把所有需要的依赖项都包含进来。

四、外部依赖

外部依赖是指在maven中央库，本地库，远程库都不存在的jar包，如本地硬盘中的jar包。

可通过如下方式配置外部依赖项:

<dependency>
  <groupId>com.qikegu.com</groupId>
  <artifactId>mydependency</artifactId>
  <scope>system</scope>
  <version>1.0</version>
  <systemPath>${basedir}\war\WEB-INF\lib\mydependency.jar</systemPath>
</dependency>


groupId和artifactId都设置为依赖项的名称，scope元素值被设置为system。systemPath元素被设置为指向包含依赖项的JAR文件的位置，${basedir}指向POM所在的目录，路径的其余部分与该目录相对应。

五、快照依赖

快照依赖是指依赖项使用正在开发中的最新版本（快照版本），每次构建总是下载最新的快照版本。

如需使用某个版本的快照版本，版本号后附加`-SNAPSHOT`:

<dependency>
    <groupId>com.qikegu.com</groupId>
    <artifactId>mydependency</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

六、排除依赖

由于Maven会传递依赖，有时可能包含不需要的依赖项，例如，某个较老的jar可能与当前使用的Java版本不兼容。为了解决这个问题，Maven允许你排除特定的依赖项:

<project>
  ...
  <dependencies>
    <dependency>
      <groupId>sample.ProjectA</groupId>
      <artifactId>Project-A</artifactId>
      <version>1.0</version>
      <scope>compile</scope>
      <exclusions>
        <exclusion>  <!-- 声明排除的依赖项 -->
          <groupId>sample.ProjectB</groupId>
          <artifactId>Project-B</artifactId>
        </exclusion>
      </exclusions> 
    </dependency>
  </dependencies>
</project>

maven在执行构建时，将不会下载存储被排除的依赖项