9.4. 项目依赖

Maven可以管理内部和外部依赖。一个Java项目的外部依赖可能是如Plexus,Spring Framework,或者Log4J的类库。一个内部的依赖就像在“一个简单的web应用”中描述的那样,web项目依赖于另外一个包含服务类,模型类,或者持久化逻辑的项目。Example 9.3, “项目依赖”展示了一些项目依赖的例子。

Example 9.3. 项目依赖

<project>
  ...
  <dependencies>
    <dependency>
      <groupId>org.codehaus.xfire</groupId>
      <artifactId>xfire-java5</artifactId>
      <version>1.2.5</version>
    </dependency>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.apache.geronimo.specs</groupId>
      <artifactId>geronimo-servlet_2.4_spec</artifactId>
      <version>1.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
  ...
</project>


这里的第一个依赖是对于来自Codehaus的XFire SOAP库的编译范围(compile)依赖。如果你的项目在编译,测试,和运行中都依赖于一个类库,你就要使用这种依赖。第二种依赖是一个对于JUnit测试范围(test)的依赖。当你只有在测试的时候才引用类库的时候,你就要使用测试范围依赖。Example 9.3, “项目依赖”中最后一个依赖是对于由Apache Geronimo项目实现的Servlet 2.4 API的依赖。最后一项依赖的范围是已提供的(provided)依赖。当你的开发过程只有在编译和测试时需要一个类库,而该类库在运行的时候由容器提供,那么你就需要使用已提供范围的依赖。

9.4.1. 依赖范围

Example 9.3, “项目依赖”简要介绍了三种依赖范围:compiletest,和provided。范围控制哪些依赖在哪些classpath中可用,哪些依赖包含在一个应用中。让我们详细看一下每一种范围:

compile(编译范围)

compile是默认的范围;如果没有提供一个范围,那该依赖的范围就是编译范围。编译范围依赖在所有的classpath中可用,同时它们也会被打包。

provided(已提供范围)

provided依赖只有在当JDK或者一个容器已提供该依赖之后才使用。例如,如果你开发了一个web应用,你可能在编译classpath中需要可用的Servlet API来编译一个servlet,但是你不会想要在打包好的WAR中包含这个Servlet API;这个Servlet API JAR由你的应用服务器或者servlet容器提供。已提供范围的依赖在编译classpath(不是运行时)可用。它们不是传递性的,也不会被打包。

runtime(运行时范围)

runtime依赖在运行和测试系统的时候需要,但在编译的时候不需要。比如,你可能在编译的时候只需要JDBC API JAR,而只有在运行的时候才需要JDBC驱动实现。

test(测试范围)

test范围依赖 在一般的 编译和运行时都不需要,它们只有在测试编译和测试运行阶段可用。测试范围依赖在之前的???中介绍过。

system(系统范围)

system范围依赖与provided类似,但是你必须显式的提供一个对于本地系统中JAR文件的路径。这么做是为了允许基于本地对象编译,而这些对象是系统类库的一部分。这样的构件应该是一直可用的,Maven也不会在仓库中去寻找它。如果你将一个依赖范围设置成系统范围,你必须同时提供一个systemPath元素。注意该范围是不推荐使用的(你应该一直尽量去从公共或定制的Maven仓库中引用依赖)。