[Maven实战]（8）依赖配置与依赖范围

 1. 依赖配置

 依赖基本配置：

   
   
   
   

    
    
    
    
 
      <project>  
    
    
    
    
    
 
      <dependencies>  
    
    
    
    
    
 
      <dependency>  
    
    
    
    
    
 
      <groupId>...</groupId>  
    
    
    
    
    
 
      <artifactId>...</artifactId>  
    
    
    
    
    
 
      <version>...</version>  
    
    
    
    
    
 
      <exclusions>  
    
    
    
    
    
 
      <exclusion>  
    
    
    
    
    
 
      <groupId>...</groupId>  
    
    
    
    
    
 
      <artifactId>...</artifactId>  
    
    
    
    
    
 
      </exclusion>  
    
    
    
    
    
 
      </exclusions>  
    
    
    
    
    
 
      </dependency>  
    
    
    
    
    
 
      </dependencies>  
    
    
    
    
    
 
     </project> 
    
   
   
   
   

  我们之前就遇到了依赖的概念，项目中测试需要依赖junit jar包，依赖配置如下：

    
    
    
    

     
     
     
     
 
       <dependencies>  
     
     
     
     
     
 
       <dependency>  
     
     
     
     
     
 
       <groupId>junit</groupId>  
     
     
     
     
     
 
       <artifactId>junit</artifactId>  
     
     
     
     
     
 
       <version>3.8.1</version>  
     
     
     
     
     
 
       <scope>test</scope>  
     
     
     
     
     
 
       </dependency>  
     
     
     
     
     
 
       </dependencies>  
     
    
    
    
    

根元素下project下的dependencies可以包含一个或者多个dependency元素，以声明一个或者多个项目依赖。每个依赖可以包含的元素有：

 

• groupId,artifactId和version：依赖的基本坐标，对于任何一个依赖来说，基本坐标是最重要的，Maven根据坐标才能找到需要的依赖。
• type：依赖的类型，对应于项目坐标定义的packaging。大部分情况下，该元素不必声明，其默认值是jar。
• scope：依赖的范围，下面会进行详解。
• optional：标记依赖是否可选。
• exclusions：用来排除传递性依赖，后面文章会详细介绍。

2. 依赖范围

下面主要讲解一下依赖范围的知识：

Maven在 编译主代码的时候需要使用一套 classpath,在 编译和执行测试的时候会使用另一套 classpath,实际 运行项目的时候，又会使用一套 classpath。

依赖范围就是用来控制 依赖与这三种 classpath（ 编译classpath、测试classpath、运行classpath）的关系，Maven有以下几种依赖范围：

 

• compile：编译依赖范围。如果没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。典型的例子是spring-core，在编译，测试和运行的时候都需要使用该依赖。
• provided：已提供依赖范围。使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时无效。典型的例子是servlet-api，编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器已经提供，就不需要Maven重复地引入一遍。
• test：测试依赖范围。使用此依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将无法使用此类依赖。典型的例子就是JUnit，它只有在编译测试代码及运行测试的时候才需要。
• runtime：运行时依赖范围。使用此依赖范围的Maven依赖，对于测试和运行classpath有效，但在编译主代码时无效。典型的例子是JDBC驱动实现，项目主代码的编译只需要JDK提供的JDBC接口，只有在执行测试或者运行项目的时候才需要实现上述接口的具体JDBC驱动。
• system：系统依赖范围。该依赖范围与provided所表示的依赖范围一致，对于编译和测试classpath有效，但在运行时无效。只是使用system范围依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，因此应该谨慎使用，systemPath元素可以引用环境变量。举个例子如下：

    
    
    
    

     
     
     
     
 
      <dependency>  
     
     
     
     
     
 
       <groupId>javax.sql</groupId>  
     
     
     
     
     
 
       <artifactId>jdbc-stdext</artifactId>  
     
     
     
     
     
 
       <version>2.0</version>  
     
     
     
     
     
 
       <scope></scope>  
     
     
     
     
     
 
       <systemPath>${java.home}/lib/rt.jar</systemPath>  
     
     
     
     
     
 
      </dependency>  
     
    
    
    
    

• import(Maven 2.0.9及以上)：导入依赖范围。该依赖范围不会对三种classpath产生实际的影响。
  

上述除import以外的各种依赖范围与三种classpath的关系如下：

依赖范围（scope）	测试classpath	编译classpath	运行classpath	例子
compile	Y	Y	Y	spring-core
provided	Y	Y		servlet-api
test	Y			junit
runtime	Y		Y	JDBC驱动实现
system	Y	Y		本地的，Maven仓库之外的类库文件

来源于：《Maven实战》

参考资料： Introduction to the Dependency Mechanism