Maven 中如何管理多模組專案的依賴關係

平時在檢視專案的過程中，發現包的依賴關係及其隨便，在各個子模組中都各自引入相應的依賴包，有些時候重複匯入了也不會發覺。
在參考alibaba dubbo的原始碼之後，做出如下總結（別人家的程式碼 ==！）

groupId：組織標識，一般為：公司網址的反寫+專案名
artifactId：專案名稱，一般為：專案名-模組名

1.首先建一個空的maven專案，專案只需要一個pom.xml檔案

交代一下我的demo

專案（root）的groupId是com.nezha.learn.demo

專案名稱 artifactId 是 demo

該專案有三個子模組：

<!--使用Jedis依賴-->
<module>demo-redis</module>
<!--主要用於管理依賴關係-->
<module>demo-parent</module>
<!--使用spring boot的依賴-->
<module>demo-juc</module>

2.通過IDEA中New > Module來構建多個模組

其中的pom.xml檔案如下：

<?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.nezha.learn.demo</groupId>
    <artifactId>demo</artifactId>
    <packaging>pom</packaging>
    <version>1.1-SNAPSHOT</version>
    <!--這裡是我們的子模組列表-->
    <modules>
        <!--使用Jedis依賴-->
        <module>demo-redis</module>
        <!--主要用於管理依賴關係-->
        <module>demo-parent</module>
        <!--使用spring boot的依賴-->
        <module>demo-juc</module>
    </modules>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-release-plugin</artifactId>
                <version>2.4.1</version>
                <configuration>
                    <autoVersionSubmodules>true</autoVersionSubmodules>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

3.建立一個專門管理依賴包的模組

同樣，該模組只有一個pom.xml檔案

<?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">
    <parent>
        <artifactId>demo</artifactId>
        <groupId>com.nezha.learn.demo</groupId>
        <version>1.1-SNAPSHOT</version>
        <relativePath>../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <packaging>pom</packaging>
    <artifactId>demo-parent</artifactId>

    <!--集中配置版本關係-->
    <properties>
        <jedis.version>2.9.0</jedis.version>
        <spring-boot.version>1.5.2.RELEASE</spring-boot.version>
    </properties>

    <!--此處 dependencyManagement 並不會直接引入依賴，是一種懶載入的方式-->
    <dependencyManagement>
        <dependencies>
            <!--引入Redis的客戶端-->
            <dependency>
                <groupId>redis.clients</groupId>
                <artifactId>jedis</artifactId>
                <version>${jedis.version}</version>
            </dependency>
            <!--引入spring boot的依賴-->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

注意此處的artifactId是專案名稱，因為所有子模組的依賴都在專案root的pom.xml中定義的。

4.在子模組中引入demo-paren的依賴

<?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">
    <parent>
        <artifactId>demo-parent</artifactId>
        <groupId>com.nezha.learn.demo</groupId>
        <version>1.1-SNAPSHOT</version>
        <relativePath>../demo-parent/pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>demo-juc</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>${project.groupId}</groupId>
            <artifactId>demo-redis</artifactId>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
</project>

注意此處的artifactId是demo-parent
此時引入的spring依賴是不需要加上版本號的
然後${project.groupId}和${project.version用於指代專案和版本。

如何更新所有子模組的版本號

這個也好解決，Maven有外掛鴨！

在父級的pom.xml中加個外掛就OK了，plugins > release > update-versions

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-release-plugin</artifactId>
                <version>2.4.1</version>
                <configuration>
                    <autoVersionSubmodules>true</autoVersionSubmodules>
                </configuration>
            </plugin>
        </plugins>
    </build>

maven的pom檔案報錯： must be "pom" but is "jar"

parent工程的pom.xml檔案的project節點下加入如下節點：

<packaging>pom</packaging>

參考文獻

1. @Maven POM 詳解：https://www.jianshu.com/p/8417a94c4d94
2. 使用maven-release-plugin自動化版本釋出https://blog.csdn.net/shenchaohao12321/article/details/79302791
3. spring dubbo的原始碼：https://github.com/apache/incubator-dubbo-spring-boot-project