Maven实战依赖

我们项目中用到的jar包可以通过依赖的方式引入,构建项目的时候从Maven仓库下载即可。

 

1. 依赖配置
   依赖可以声明如下: 
  

Xml代码 复制代码 收藏代码

  1. <project>  

  2.   ...  

  3.   <dependencies>  

  4.     <dependency>  

  5.       <groupId>group-a</groupId>  

  6.       <artifactId>artifact-a</artifactId>  

  7.       <version>1.0</version>  

  8.       <exclusions>  

  9.         <exclusion>  

  10.           <groupId>group-c</groupId>  

  11.           <artifactId>excluded-artifact</artifactId>  

  12.         </exclusion>  

  13.       </exclusions>  

  14.     </dependency>  

  15.     <dependency>  

  16.       <groupId>group-a</groupId>  

  17.       <artifactId>artifact-b</artifactId>  

  18.       <version>1.0</version>  

  19.       <type>bar</type>  

  20.       <scope>runtime</scope>  

  21.     </dependency>  

  22.   </dependencies>  

  23. </project>  

<project>
  ...
  <dependencies>
    <dependency>
      <groupId>group-a</groupId>
      <artifactId>artifact-a</artifactId>
      <version>1.0</version>
      <exclusions>
        <exclusion>
          <groupId>group-c</groupId>
          <artifactId>excluded-artifact</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
      <groupId>group-a</groupId>
      <artifactId>artifact-b</artifactId>
      <version>1.0</version>
      <type>bar</type>
      <scope>runtime</scope>
    </dependency>
  </dependencies>
</project>

 我们在Maven实战(二)中就遇到了依赖的概念,项目中测试需要依赖junit jar包,依赖配置如下:

Xml代码 复制代码 收藏代码

  1. <dependencies>  

  2.     <dependency>  

  3.       <groupId>junit</groupId>  

  4.       <artifactId>junit</artifactId>  

  5.       <version>3.8.1</version>  

  6.       <scope>test</scope>  

  7.     </dependency>  

  8.  </dependencies>  

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

 依赖会包含基本的groupId, artifactId,version等元素,根元素project下的dependencies可以包含一个或者多个dependency元素,以声明一个或者多个依赖。
 下面详细讲解每个依赖可以包含的元素:

 

  groupId,artifactIdversion:依赖的基本坐标,对于任何一个依赖来说,基本坐标是最重要的,Maven根据坐标才能找到需要的依赖

 

  type: 依赖的类型,对应于项目坐标定义的packaging。大部分情况下,该元素不必声明,其默认值是jar

 

  scope: 依赖的范围,下面会进行详解

 

  optional: 标记依赖是否可选

 

  exclusions: 用来排除传递性依赖,下面会进行详解

 

  大部分依赖声明只包含基本坐标。


2. 依赖范围

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

 依赖范围就是用来控制依赖与这三种classpath(编译classpath、测试classpath、运行classpath)的关系,Maven有以下几种依赖范围:

 

compile: 编译依赖范围。如果没有指定,就会默认使用该依赖范围。使用此依赖范围的Maven依赖,对于编译、测试、运行三种classpath都有效。

 

test: 测试依赖范围。使用此依赖范围的Maven依赖,只对于测试classpath有效,在编译主代码或者运行项目的使用时将无法使用此类依赖。典型的例子就是JUnit,它只有在编译测试代码及运行测试的时候才需要。

 

provided: 已提供依赖范围。使用此依赖范围的Maven依赖,对于编译和测试classpath有效,但在运行时无效。典型的例子是servlet-api,编译和测试项目的时候需要该依赖,但在运行项目的时候,由于容器已经提供,就不需要Maven重复地引入一遍。

 

runtime: 运行时依赖范围。使用此依赖范围的Maven依赖,对于测试和运行classpath有效,但在编译主代码时无效。典型的例子是JDBC驱动实现,项目主代码的编译只需要JDK提供的JDBC接口,只有在执行测试或者运行项目的时候才需要实现上述接口的具体JDBC驱动。

 

system: 系统依赖范围。该依赖与三种classpath的关系,和provided依赖范围完全一致。但是,使用system范围依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的,而且往往与本机系统绑定,可能造成构建的不可移植,因此应该谨慎使用。systemPath元素可以引用环境变量,如:

Xml代码 复制代码 收藏代码

  1. <dependency>  

  2.     <groupId>javax.sql</groupId>  

  3.     <artifactId>jdbc-stdext</artifactId>  

  4.     <version>2.0</version>  

  5.     <scope></scope>  

  6.     <systemPath>${java.home}/lib/rt.jar</systemPath>  

  7. </dependency>  

<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产生实际的影响,稍后会介绍到。

 

3. 传递性依赖

 下面我们看一个简单的项目,读者可从附件中下载源码

POM.xml配置如下:

Xml代码 复制代码 收藏代码

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  

  2.   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  

  3.   <modelVersion>4.0.0</modelVersion>  

  4.   

  5.   <groupId>com.mycompany.app</groupId>  

  6.   <artifactId>my-app-simple</artifactId>  

  7.   <version>0.0.1-SNAPSHOT</version>  

  8.   <packaging>jar</packaging>  

  9.   

  10.   <name>my-app-simple</name>  

  11.   <url>http://maven.apache.org</url>  

  12.   

  13.   <properties>  

  14.     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  

  15.   </properties>  

  16.   

  17.   <dependencies>  

  18.     <dependency>  

  19.       <groupId>junit</groupId>  

  20.       <artifactId>junit</artifactId>  

  21.       <version>3.8.1</version>  

  22.       <scope>test</scope>  

  23.     </dependency>  

  24.       

  25.      <dependency>  

  26.       <groupId>org.springframework</groupId>  

  27.       <artifactId>spring-core</artifactId>  

  28.       <version>2.5.6</version>  

  29.     </dependency>  

  30.   </dependencies>  

  31. </project>  

<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.mycompany.app</groupId>
  <artifactId>my-app-simple</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>my-app-simple</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    
     <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>2.5.6</version>
    </dependency>
  </dependencies>
</project>

 我们可以看到此项目引入依赖junit和spring-core,我们可以在Maven仓库中查找spring-core构件,如图:


Maven实战依赖_第1张图片

点击POM我们会看到该文件包含了一个commons-logging依赖:

Xml代码 复制代码 收藏代码

  1. <dependency>  

  2.   <groupId>commons-logging</groupId>   

  3.   <artifactId>commons-logging</artifactId>   

  4.   <version>1.1.1</version>   

  5. </dependency>  

<dependency>
  <groupId>commons-logging</groupId> 
  <artifactId>commons-logging</artifactId> 
  <version>1.1.1</version> 
</dependency>

 
 那么该依赖会传递到当前项目中,这就是依赖的传递性,打开项目查看Maven dependencies:


Maven实战依赖_第2张图片
 

 

4. 可选依赖

 有时候我们不想让依赖传递,那么可配置该依赖为可选依赖,将元素optional设置为true即可,例如:

Xml代码 复制代码 收藏代码

  1. <dependency>  

  2.   <groupId>commons-logging</groupId>   

  3.   <artifactId>commons-logging</artifactId>   

  4.   <version>1.1.1</version>   

  5.   <optional>true<optional>  

  6. </dependency>  

<dependency>
  <groupId>commons-logging</groupId> 
  <artifactId>commons-logging</artifactId> 
  <version>1.1.1</version> 
  <optional>true<optional>
</dependency>

那么依赖该项目的另以项目将不会得到此依赖的传递

 

 5. 排除依赖

       当我们引入第三方jar包的时候,难免会引入传递性依赖,有些时候这是好事,然而有些时候我们不需要其中的一些传递性依赖

比如上例中的项目,我们不想引入传递性依赖commons-logging,我们可以使用exclusions元素声明排除依赖,exclusions可以包含一个或者多个exclusion子元素,因此可以排除一个或者多个传递性依赖。需要注意的是,声明exclusions的时候只需要groupId和artifactId,而不需要version元素,这是因为只需要groupId和artifactId就能唯一定位依赖图中的某个依赖。换句话说,Maven解析后的依赖中,不可能出现groupId和artifactId相同,但是version不同的两个依赖。

 如下是一个排除依赖的例子:

Xml代码 复制代码 收藏代码

  1. <dependency>    

  2.      <groupId>org.springframework</groupId>  

  3.      <artifactId>spring-core</artifactId>  

  4.      <version>2.5.6</version>  

  5.      <exclusions>  

  6.            <exclusion>      

  7.                 <groupId>commons-logging</groupId>          

  8.                 <artifactId>commons-logging</artifactId>  

  9.            </exclusion>  

  10.      </exclusions>  

  11. </dependency>  

<dependency>	
     <groupId>org.springframework</groupId>
     <artifactId>spring-core</artifactId>
     <version>2.5.6</version>
     <exclusions>
           <exclusion>	
                <groupId>commons-logging</groupId>		  
				<artifactId>commons-logging</artifactId>
           </exclusion>
     </exclusions>
</dependency>

  

 5. 依赖归类

 如果我们项目中用到很多关于Spring Framework的依赖,它们分别是org.springframework:spring-core:2.5.6, org.springframework:spring-beans:2.5.6,org.springframework:spring-context:2.5.6,它们都是来自同一项目的不同模块。因此,所有这些依赖的版本都是相同的,而且可以预见,如果将来需要升级Spring Framework,这些依赖的版本会一起升级。因此,我们应该在一个唯一的地方定义版本,并且在dependency声明引用这一版本,这一在Spring Framework升级的时候只需要修改一处即可。

Xml代码 复制代码 收藏代码

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  

  2.     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">  

  3.     <modelVersion>4.0.0</modelVersion>  

  4.   

  5.     <groupId>com.mycompany.app</groupId>  

  6.     <artifactId>my-app-simple</artifactId>  

  7.     <version>0.0.1-SNAPSHOT</version>  

  8.     <packaging>jar</packaging>  

  9.     <name>my-app-simple</name>  

  10.     <properties>  

  11.         <springframework.version>2.5.6</springframework.version>  

  12.     </properties>  

  13.   

  14.     <dependencies>  

  15.         <dependency>  

  16.             <groupId>junit</groupId>  

  17.             <artifactId>junit</artifactId>  

  18.             <version>3.8.1</version>  

  19.             <scope>test</scope>  

  20.         </dependency>  

  21.   

  22.         <dependency>  

  23.             <groupId>org.springframework</groupId>  

  24.             <artifactId>spring-core</artifactId>  

  25.             <version>${springframework.version}</version>  

  26.         </dependency>  

  27.         <dependency>  

  28.             <groupId>org.springframework</groupId>  

  29.             <artifactId>spring-beans</artifactId>  

  30.             <version>${springframework.version}</version>             

  31.         </dependency>  

  32.     </dependencies>  

  33. </project>  

<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.mycompany.app</groupId>
	<artifactId>my-app-simple</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>
	<name>my-app-simple</name>
	<properties>
		<springframework.version>2.5.6</springframework.version>
	</properties>

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

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<version>${springframework.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-beans</artifactId>
			<version>${springframework.version}</version>			
		</dependency>
	</dependencies>
</project>

 

6. 在Eclipse中管理依赖

安装好m2eclipse之后(第2课有详细讲解)就可以用eclipse来管理依赖。

如图,在该项目的pom.xml中点击Dependency Hierarchy可以看到依赖树:


Maven实战依赖_第3张图片
 

 点击Dependencies可以添加新的依赖,点击选择一个依赖,点击remove可以删除,点击Add可以新增一个依赖,如图:
Maven实战依赖_第4张图片
 

如下图,搜素org.springframework(此处是从Maven中心仓库进行搜索),选择你想要的模块和版本,点击OK即可:

 
Maven实战依赖_第5张图片

你可能感兴趣的:(Maven实战依赖)