maven 依赖管理
maven 一个核心的特性就是依赖管理。当我们处理多模块的项目(包含成百上千个模块或者子项目),模块间的依赖关系就变得非常复杂,管理也变得很困难。针对此种情形,maven 提供了一种高度控制的方法。
1. 可传递性依赖发现
一种相当常见的情况,比如说 a 依赖于其他库 b。如果,另外一个项目 c 想要使用 a ,那么 c 项目也需要使用库 b。
maven 可以避免去搜索所有所需库的需求。maven 通过读取项目文件(pom.xml),找出它们项目之间的依赖关系。
我们需要做的只是在每个项目的 pom 中定义好直接的依赖关系。其他的事情 maven 会帮我们搞定。
通过可传递性的依赖,所有被包含的库的图形会快速的增长。当有重复库时,可能出现的情形将会持续上升。maven 提供一些功能来控制可传递的依赖的程度。
功能 | 功能描述 |
---|---|
依赖调节 | 决定当多个手动创建的版本同时出现时,哪个依赖版本将会被使用。 如果两个依赖版本在依赖树里的深度是一样的时候,第一个被声明的依赖将会被使用。 |
依赖管理 | 直接的指定手动创建的某个版本被使用。例如当一个工程 c 在自己的依赖管理模块包含工程 b,即 b 依赖于 a, 那么 a 即可指定在 b 被引用时所使用的版本。 |
依赖范围 | 包含在构建过程每个阶段的依赖。 |
依赖排除 | 任何可传递的依赖都可以通过 "exclusion" 元素被排除在外。举例说明,a 依赖 b, b 依赖 c,因此 a 可以标记 c 为 "被排除的"。 |
依赖可选 | 任何可传递的依赖可以被标记为可选的,通过使用 "optional" 元素。例如:a 依赖 b, b 依赖 c。因此,b 可以标记 c 为可选的, 这样 a 就可以不再使用 c。 |
2. 依赖范围
传递依赖发现可以通过使用如下的依赖范围来得到限制:
范围 | 描述 |
---|---|
编译阶段 | 该范围表明相关依赖是只在项目的类路径下有效。默认取值。 |
供应阶段 | 该范围表明相关依赖是由运行时的 jdk 或者 网络服务器提供的。 |
运行阶段 | 该范围表明相关依赖在编译阶段不是必须的,但是在执行阶段是必须的。 |
测试阶段 | 该范围表明相关依赖只在测试编译阶段和执行阶段。 |
系统阶段 | 该范围表明你需要提供一个系统路径。 |
导入阶段 | 该范围只在依赖是一个 pom 里定义的依赖时使用。同时,当前项目的pom 文件的 部分定义的依赖关系可以取代某特定的 pom。 |
3. 依赖管理
通常情况下,在一个共通的项目下,有一系列的项目。在这种情况下,我们可以创建一个公共依赖的 pom 文件,该 pom 包含所有的公共的依赖关系,我们称其为其他子项目 pom 的 pom 父。 接下来的一个例子可以帮助你更好的理解这个概念。
接下来是上面依赖图的详情说明:
app-ui-war 依赖于 app-core-lib 和 app-data-lib。
root 是 app-core-lib 和 app-data-lib 的父项目。
root 在它的依赖部分定义了 lib1、lib2 和 lib3 作为依赖。
app-ui-war 的 pom.xml 文件代码如下:
<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.companyname.groupname</groupid> <artifactid>app-ui-war</artifactid> <version>1.0</version> <packaging>war</packaging> <dependencies> <dependency> <groupid>com.companyname.groupname</groupid> <artifactid>app-core-lib</artifactid> <version>1.0</version> </dependency> </dependencies> <dependencies> <dependency> <groupid>com.companyname.groupname</groupid> <artifactid>app-data-lib</artifactid> <version>1.0</version> </dependency> </dependencies> </project>
app-core-lib 的 pom.xml 文件代码如下:
<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"> <parent> <artifactid>root</artifactid> <groupid>com.companyname.groupname</groupid> <version>1.0</version> </parent> <modelversion>4.0.0</modelversion> <groupid>com.companyname.groupname</groupid> <artifactid>app-core-lib</artifactid> <version>1.0</version> <packaging>jar</packaging> </project>
app-data-lib 的 pom.xml 文件代码如下:
<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"> <parent> <artifactid>root</artifactid> <groupid>com.companyname.groupname</groupid> <version>1.0</version> </parent> <modelversion>4.0.0</modelversion> <groupid>com.companyname.groupname</groupid> <artifactid>app-data-lib</artifactid> <version>1.0</version> <packaging>jar</packaging> </project>
root 的 pom.xml 文件代码如下:
<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.companyname.groupname</groupid> <artifactid>root</artifactid> <version>1.0</version> <packaging>pom</packaging> <dependencies> <dependency> <groupid>com.companyname.groupname1</groupid> <artifactid>lib1</artifactid> <version>1.0</version> </dependency> </dependencies> <dependencies> <dependency> <groupid>com.companyname.groupname2</groupid> <artifactid>lib2</artifactid> <version>2.1</version> </dependency> </dependencies> <dependencies> <dependency> <groupid>com.companyname.groupname3</groupid> <artifactid>lib3</artifactid> <version>1.1</version> </dependency> </dependencies> </project>
现在当我们构建 app-ui-war 项目时, maven 将通过遍历依赖关系图找到所有的依赖关系,并且构建该应用程序。
通过上面的例子,我们可以学习到以下关键概念:
- 公共的依赖可以使用 pom 父的概念被统一放在一起。app-data-lib 和 app-core-lib 项目的依赖在 root 项目里列举了出来(参考 root 的包类型,它是一个 pom).
- 没有必要在 app-ui-w 里声明 lib1, lib2, lib3 是它的依赖。 maven 通过使用可传递的依赖机制来实现该细节。