快捷導(dǎo)航

maven父工程relativepath標(biāo)簽使用解讀

更新時間：2024年11月13日 10:01:25 作者：code小魚

文章主要介紹了在使用Maven構(gòu)建父子工程時如何通過設(shè)置父工程和子工程的pom文件來管理依賴和版本,當(dāng)子工程是Spring Boot項目時,可以通過關(guān)閉`relativePath`標(biāo)簽來繼承Spring Boot的父工程,同時在父工程中使用`dependencyManagement`標(biāo)簽來統(tǒng)一管理Spring Boot的依賴版本

1、概述

我們在使用maven構(gòu)建父子工程時，通常會在父工程中將pom的打包方式設(shè)置為pom，然后在pom文件中使用modules標(biāo)簽來聲明子工程，我們在子工程的pom文件中使用parent標(biāo)簽來聲明自己屬于哪個父工程。

這樣的好處是可以方便打包和管理依賴。

2、問題

如果我們的子工程是一個springBoot項目，那么我們可以在pom文件中使用parent標(biāo)簽去繼承spring-boot的praent工程，這樣的好處是我們項目中使用有關(guān)spring-boot的依賴可以全由父工程來管理，方便版本統(tǒng)一。

但現(xiàn)在我們的praent標(biāo)簽已經(jīng)指向了我們自己創(chuàng)建的父工程。

在pom中只允許使用一個praent標(biāo)簽，那還有什么辦法呢？

3、答案（方式一）

這是一個父工程的pom文件，該工程下管理了一個model1子工程

<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>org.example</groupId>
    <artifactId>mavenParent</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>model1</module>
    </modules>

</project>

子工程pom文件：我們可以看到我們的父工程是聲明的spring-boot-starter-parent，而不是我們自己的父工程，其實(shí)這樣也可以被我們自己的父工程所管理，因為我們在父工程中使用了modules標(biāo)簽。

這里有一個關(guān)鍵點(diǎn)：我將relativePath標(biāo)簽關(guān)閉了，也就是置空.(該標(biāo)簽必須置空，不寫會使用默認(rèn)值也會報錯)。

如果你是使用idea創(chuàng)建的maven工程，手動勾選了springboot，那么在relativePath標(biāo)簽旁邊會注釋一段話：在本地倉庫查找依賴

<?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>
    <artifactId>model1</artifactId>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.2</version>
        <relativePath /><!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <!-- 這里不需要指定版本號，版本由上面的父工程管理了 -->
        </dependency>
    </dependencies>

</project>

4、詳解

relativePath標(biāo)簽含義：指定父工程的pom文件路徑

如果你不使用這個標(biāo)簽，那他的默認(rèn)值是<relativePath>../pom<relativePath>。也就是指向當(dāng)前模塊的上一級目錄中的pom文件，也就是我們自己聲明的父工程。

他的查找順序為：relativePath元素中的地址–本地倉庫–遠(yuǎn)程倉庫。如果標(biāo)簽指定的地址找不到他就會去本地的maven倉庫中找，如果本地倉庫沒有那就去遠(yuǎn)程倉庫找。

使用<relativePath/>指定一個空地址，他就會去本地倉庫中找。

5、番外：方式二

還有一種方式那就是不使用繼承spring-boot-starter-parent的方式來管理springboot的依賴，我們可以點(diǎn)進(jìn)這個spring-boot-starter-parent的pom文件中查看，我們發(fā)現(xiàn)它也有一個父工程

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>2.7.2</version>
  </parent>
  <artifactId>spring-boot-starter-parent</artifactId>
  <packaging>pom</packaging>
  <name>spring-boot-starter-parent</name>
  <description>Parent pom providing dependency and plugin management for applications built with Maven</description>

我們再點(diǎn)進(jìn)這個父工程spring-boot-dependencies看，(這是一部分)，我們可以看到其實(shí)幫我們管理版本的是這個父工程，它的打包方式也是pom，在properties標(biāo)簽中管理了很多依賴的版本。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-dependencies</artifactId>
  <version>2.7.2</version>
  <packaging>pom</packaging>
  <name>spring-boot-dependencies</name>
  <description>Spring Boot Dependencies</description>
  <url>https://spring.io/projects/spring-boot</url>
  
  <properties>
    <activemq.version>5.16.5</activemq.version>
    <antlr2.version>2.7.7</antlr2.version>
    <appengine-sdk.version>1.9.98</appengine-sdk.version>
    <artemis.version>2.19.1</artemis.version>
    <aspectj.version>1.9.7</aspectj.version>
    <assertj.version>3.22.0</assertj.version>
    <atomikos.version>4.0.6</atomikos.version>
  </properties>

</project>

既然是這樣，還記得dependencyManagement標(biāo)簽嗎，這個標(biāo)簽可不是只能在父工程中才可以使用，我們在這里使用該標(biāo)簽來導(dǎo)入spring-boot-dependencies為我們整理的依賴，這樣項目中國使用到的有關(guān)springboot的依賴就又可以不寫版本號了。

<?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>
    <artifactId>model1</artifactId>
    <packaging>jar</packaging>
    <!--自己的父工程-->
    <parent>
        <groupId>org.example</groupId>
        <artifactId>mavenParent</artifactId>
        <version>1.0-SNAPSHOT</version>
        <relativePath/>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <!-- 這里不需要指定版本號，版本由下面的dependencyManagement管理了 -->
        </dependency>
    </dependencies>

    <!-- 這里dependencyManagement管理版本，只是管理版本，不導(dǎo)入依賴哦！ -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>2.7.2</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>