文档章节

配置和管理Maven依赖

开源俱乐部
 开源俱乐部
发布于 2014/06/20 17:43
字数 1905
阅读 58
收藏 0

一、Maven依赖基础知识

Maven项目中用到的jar包都是通过依赖的方式引入,在进行构建的时候会自动从网络中央工厂或本地仓库下载。

(1)依赖配置基础知识

        在“pom.xml”中,可以看到如下代码:

<?xml version="1.0"?>
<project xsi:schemaLocation="http://maven.apache.org/xsd/maven-4.0.0.xsd
" xmlns="
http://maven.apache.org/POM/4.0.0
" xmlns:xsi="
http://www.w3.org/2001/XMLSchema-instance
">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.uni2uni.myapp</groupId>
  <artifactId>myapp</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
  <name>myapp Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
    ...... 
</project>

        可以看到这个代码片段,如下所示:

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

        依赖的配置在<dependencies></dependencies>代码段中,可以包括多个依赖项,如下所示:

<dependencies>
    <dependency>
      ......
    </dependency>
    <dependency>
      ......
    </dependency> 
    ...... 
</dependencies>

        常用的参数项为:

        groupId、artifactId和version:是依赖的基本坐标,Maven根据坐标才能找到需要的依赖。

        type:依赖的类型,对应于项目坐标定义的packaging。默认值是jar。

        scope:用于配置依赖的范围,下面会进行详解。

        optional:标记依赖是否可选依赖。默认值为false。

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

(2)配置依赖范围

        scope用于配置依赖的范围,可选参数如下:

        compile:编译依赖范围(默认值)。使用此依赖范围的maven依赖,对于编译、测试、运行三种classpath都有效。

        test:测试依赖范围。使用此依赖范围的maven依赖,只对于测试有效。

        provided:已提供依赖范围。使用此依赖范围的Maven依赖,对于编译和测试classpath有效,但在运行时无效。

        runtime:运行时依赖范围。使用此依赖范围的Maven依赖,对于测试和运行classpath有效,但在编译时无效。

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

        配置依赖范围代码示例如下:

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

(3)依赖传递性

        如果项目依赖A,A包依赖于B包,当我们在项目中配置对A包的依赖时,系统会自动下载B包。这就是依赖的传递性。

(4)配置可选依赖

        往往存在这样的情况,我们不期望依赖传递,只需要将元素optinal设置为true即可。代码示例如下:

<dependencies>
    <dependency>
      <groupId>xxx</groupId>
      <artifactId>xxx</artifactId>
      <version>x.x.x</version>
      <optinal>true</optinal>
    </dependency>
</dependencies>

(5)配置排除依赖

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

<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>

(6)配置依赖归类

        如果我们项目中用到很多关于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升级的时候只需要修改一处即可。如下所示:

<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>

(7)配置依赖聚合

        为了能够使用一条命令就能构建 account-email和 account-persist两个模块,我们需要建立一个额外的名为 account-aggregator的模块,然后通过该模块构建整个项目的所有模块。 account-aggregator本身也是个 Maven项目,它的 POM如下:

<project>
 <modelVersion>4.0.0</modelVersion>
 <groupId>com.juvenxu.mvnbook.account</groupId>
 <artifactId>account-aggregator</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 <packaging> pom </packaging>
 <name>Account Aggregator</name>
  <modules>
  <module>account-email</module>
  <module>account-persist</module>
  </modules>
</project>

注意:packaging的类型为pom ,module的值是一个以当前POM为主目录的相对路径。

(8)配置依赖继承

        可声明父POM供子 POM继承。父模块POM如下:

<project>
 <modelVersion>4.0.0</modelVersion>
 <groupId>com.juvenxu.mvnbook.account</groupId>
 <artifactId> account-parent </artifactId>
 <version>1.0.0-SNAPSHOT</version>
 <packaging>pom</packaging>
 <name>Account Parent</name>
</project>

        子模块声明继承如下:

<project>
 <modelVersion>4.0.0</modelVersion>
 <parent>
  <groupId>com.juvenxu.mvnbook.account</groupId>
  <artifactId> account-parent </artifactId>
  <version>1.0.0-SNAPSHOT</version>
  <relativePath >../account-parent/pom.xml</ relativePath>
 </parent>
 <artifactId> account-email </artifactId>
 <name>Account Email</name>
  ...

</project>

        最后,同样还需要把 account-parent加入到聚合模块account-aggregator中。聚合的 POM如下:

<project>
 <modelVersion>4.0.0</modelVersion>
 <groupId>com.juvenxu.mvnbook.account</groupId>
 <artifactId>account-aggregator</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 <packaging> pom </packaging>
 <name>Account Aggregator</name>
 <modules>
  <module>account-email</module>
  <module>account-persist</module>
  <module> account-parent</module>
 </modules>
</project>

注意:
1、子模块没有声明groupId和version, 这两个属性继承至父模块。但如果子模块有不同与父模块的 groupId、version ,也可指定;
2、不应该继承artifactId,如果groupId ,version,artifactId 完全继承的话会造成坐标冲突;另外即使使用不同的 groupId或version,同样的 artifactId也容易产生混淆。
3、使用继承后 parent也必须像自模块一样加入到聚合模块中。也就是在在聚合模块的 pom中加入<module>account-parent</module>。

二、在MyEclipse中管理依赖

        在MyEclipse中可以通过图形界面来管理maven的依赖。在”pop.xm“中点击Dependency Hierarchy可以看到依赖树,如下图所示:

        

        点击Dependencies可以添加新的依赖,点击选择一个依赖,点击remove可以删除,点击Add可以新增一个依赖,如下图:

        

三、知识扩展

(1)Maven可继承的POM元素

        groupId:项目组 ID ,项目坐标的核心元素;
        version:项目版本,项目坐标的核心元素;
        description:项目的描述信息;
        organization:项目的组织信息;
        inceptionYear:项目的创始年份;
        url:项目的 url 地址
        develoers:项目的开发者信息;
        contributors:项目的贡献者信息;
        distributionManagerment:项目的部署信息;
        issueManagement:缺陷跟踪系统信息;
        ciManagement:项目的持续继承信息;
        scm:项目的版本控制信息;
        mailingListserv :项目的邮件列表信息;
        properties :自定义的 Maven 属性;
        dependencies :项目的依赖配置;
        dependencyManagement :醒目的依赖管理配置;
        repositories :项目的仓库配置;
        build :包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等;
        reporting :包括项目的报告输出目录配置、报告插件配置等。

        

© 著作权归作者所有

共有 人打赏支持
上一篇: MyBatis配置
开源俱乐部
粉丝 10
博文 39
码字总数 31422
作品 0
朝阳
架构师
私信 提问
Eclipse教程1 - 3分钟理清Maven依赖

作者: 韩勇 日期: 2018-12-02 前言 大学学习 Java 时开始接触 Eclipse,喜欢其强大和方便,并立志成为一名 Java 开发。然而近几年 Eclipse 的流行度开始下滑,一方面有 Eclipse 自身的不足(...

hyerty
12/10
0
0
Maven 中 dependencies 与 dependencyManagement 的区别

Maven 中 dependencies 与 dependencyManagement 的区别 前提 这段时间项目中遇到过了一些 Jar 包冲突的问题,很多是由于我们项目模块很多的时候,用 Maven 管理不当导致的冲突问题,本文就这...

晨猫
10/31
0
0
带你深度解析Maven

一、What`s Maven?   Maven是基于项目对象模型(POM project object model),可以通过一小段描述信息(配置)来管理项目的构建,报告和文档的软件项目管理工具,简单的说就是用来管理项目所...

hafiz.zhang
2017/12/27
0
0
【Spring Boot 系列 依赖管理】

1、简介 为完成不同需求的Spring应用构建,SpringBoot提供了多种不同的依赖管理模板,每种模板均为一系列已完成的依赖的管理.例如如需要构建web项目,我们只需添加spring-boot-starter-web的依赖...

HansonReal
2017/11/22
0
0
JavaEE额外介绍

一.Maven 普通的项目需要依赖各式各样的jar包,maven是一个项目构建和管理的工具,提供了帮助管理 构建、文档、报告、依赖、scms、发布、分发的方法。可以方便的编译代码、进行依赖管理、管理...

Java_Rock
01/03
0
0

没有更多内容

加载失败,请刷新页面

加载更多

OSChina 周六乱弹 —— 你一口我一口多咬一口是小狗

Osc乱弹歌单(2018)请戳(这里) 【今日歌曲】 @达尔文 :分享Roy Orbison的单曲《She's a Mystery to Me》 《She's a Mystery to Me》- Roy Orbison 手机党少年们想听歌,请使劲儿戳(这里...

小小编辑
今天
107
4
Spring源码学习笔记-1-Resource

打算补下基础,学习下Spring源码,参考书籍是《Spring源码深度解析》,使用版本是Spring 3.2.x,本来想试图用脑图记录的,发现代码部分不好贴,还是作罢,这里只大略记录下想法,不写太细了 ...

zypy333
今天
13
0
RestClientUtil和ConfigRestClientUtil区别说明

RestClientUtil directly executes the DSL defined in the code. ConfigRestClientUtil gets the DSL defined in the configuration file by the DSL name and executes it. RestClientUtil......

bboss
今天
21
0

中国龙-扬科
昨天
4
0
Linux系统设置全局的默认网络代理

更改全局配置文件/etc/profile all_proxy="all_proxy=socks://rahowviahva.ml:80/"ftp_proxy="ftp_proxy=http://rahowviahva.ml:80/"http_proxy="http_proxy=http://rahowviahva.ml:80/"......

临江仙卜算子
昨天
13
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部