為了項目的正確運行,必須確保應用的各個項目的依賴項和版本一致,才能保證測試的和發布的是相同的結果
dependencyManagement
在項目的 parent 層,可以通過 dependencyManagement 元素來管理 jar 包的版本,讓子項目中引用一個依賴而不用顯示的列出版本號
父模塊中的 pom.xml
<properties>
<version.framework>1.0-SNAPSHOT</version.framework>
<javaee-api.version>1.0-SNAPSHOT</javaee-api.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.xiaojiejie</groupId>
<artifactId>framework-cache</artifactId>
<version>${version.framework}</version>
</dependency>
<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
<version>${javaee-api.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
子模塊中的 pom.xml
<parent>
<artifactId>parent</artifactId>
<groupId>com.xiaojiejie</groupId>
<version>0.0.1-SNAPSHOT</version>
<relativePath>../parent/pom.xml</relativePath>
</parent>
<!--依賴關系-->
<dependencies>
<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
</dependency>
<dependency>
<groupId>com.xiaojiejie</groupId>
<artifactId>framework-cache</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
</dependency>
</dependencies>
這樣做的好處:統一管理項目的版本號,確保應用的各個項目的依賴和版本一致,才能保證測試的和發布的是相同的成果,因此,在頂層 pom 中定義共同的依賴關系。同時可以避免在每個使用的子項目中都聲明一個版本號,這樣想升級或者切換到另一個版本時,只需要在父類容器里更新,不需要任何一個子項目的修改;如果某個子項目需要另外一個版本號時,只需要在 dependencies 中聲明一個版本號即可。子類就會使用子類聲明的版本號,不繼承于父類版本號
dependencyManagement 的一個應用
Maven 的繼承和 Java 的繼承一樣,是無法實現多重繼承的,如果多模塊繼承自同一個模塊,那么按照之前的做法,這個父模塊的 dependencyManagement 會包含大量的依賴。如果想把這些依賴分類以更清晰的管理,那就不可能了,import scope 依賴能解決這個問題。可以把 dependencyManagement 放到單獨的專門用來管理依賴的 POM 中,然后在需要使用依賴的模塊中通過 import scope 依賴,就可以引入 dependencyManagement。例如可以寫這樣一個用于依賴管理的 POM:
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.xiaojiejie.sample</groupId>
<artifactId>sample-dependency-infrastructure</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactid>junit</artifactId>
<version>4.8.2</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactid>log4j</artifactId>
<version>1.2.16</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>
然后就可以通過非繼承的方式來引入這段依賴管理配置:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.xiaojiejie.sample</groupId>
<artifactid>sample-dependency-infrastructure</artifactId>
<version>1.0-SNAPSHOT</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependency>
<groupId>junit</groupId>
<artifactid>junit</artifactId>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactid>log4j</artifactId>
</dependency>
這樣,父模塊的 POM 就會非常干凈,由專門的 packaging 來管理依賴,也契合的面向對象設計中的單一職責原則。此外,我們還能夠創建多個這樣的依賴管理 POM,以更細化的方式管理依賴。這種做法與面向對象設計中使用組合而非繼承也有點相似的味道
dependencies
相對于 dependencyManagement,所有聲明在父項目中 dependencies 里的依賴都會被子項目自動引入,并默認被所有的子項目繼承
區別
dependencies 即使在子項目中不寫該依賴項,那么子項目仍然會從父項目中繼承該依賴項(全部繼承)
dependencyManagement 里只是聲明依賴,并不實現引入,因此子項目需要顯示的聲明需要用的依賴。如果不在子項目中聲明依賴,是不會從父項目中繼承下來的;只有在子項目中寫了該依賴項,并且沒有指定具體版本,才會從父項目中繼承該項,并且 version 和 scope 都讀取自父 pom; 另外如果子項目中指定了版本號,那么會使用子項目中指定的 jar 版本
dependencyManagement 在父項目中也只是管理,并沒有實際引入,所以要在 dependencies 中聲明,這時也不用指明 version,比如下面的 lombok
<?xml version="1.0" encoding="UTF-8"?>
<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.xiaojiejie</groupId>
<artifactId>extension-point-api</artifactId>
<version>1.0</version>
<packaging>jar</packaging>
<name>Extension Point Api</name>
<properties>
<java.version>1.8</java.version>
<lombok.version>1.16.18</lombok.version>
</properties>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
</project>