SpringBoot項目中怎么實現(xiàn)Maven多模塊父子工程附詳細步驟

猿友 2021-08-05 14:06:30 瀏覽數(shù) (7323)

反饋

我們經(jīng)常使用 IDEA 的 Maven 來創(chuàng)建 SpringBoot 項目，在 SpringBoot 項目中，我們要如何實現(xiàn) Maven 多模塊父子工程呢？下面，將通過具體的詳細操作過程為大家解答這個問題。

一、為什么要用Maven多模塊

假設有這樣一個項目，很常見的Java Web應用。在這個應用中，我們分了幾層：

Dao
Service
Web

對應的，在一個項目中，我們會看到一些包名：

org.xx.app.dao
org.xx.app.service
org.xx.app.web
org.xx.app.util

但隨著項目的進行，你可能會遇到如下問題：

這個應用可能需要有一個前臺和一個后臺管理端，你發(fā)現(xiàn)大部分dao，一些service，和大部分util是在兩個應用中可。
pom.xml中的依賴列表越來越長以重用的，但是，由于目前只有一個項目，你不得不新建一個項目依賴這個WAR.
build整個項目的時間越來越長，盡管你只是一直在web層工作，但你不得不build整個項目。
某個模塊，比如util，你只想讓一些經(jīng)驗豐富的人來維護，可是，現(xiàn)在這種情況，每個開發(fā)者都能修改，這導致關鍵模塊的代碼質(zhì)量不能達到你的要求。

我們會發(fā)現(xiàn)，其實這里實際上沒有遵守一個設計模式原則：“高內(nèi)聚，低耦合”。雖然我們通過包名劃分了層次，并且你還會說，這些包的依賴都是單向的，沒有包的環(huán)依賴。這很好，但還不夠，因為就構建層次來說，所有東西都被耦合在一起了。因此我們需要使用Maven劃分模塊。

一個簡單的Maven模塊結構是這樣的：

---- app-xxx

             |-- pom.xml (pom)

             |

             |-- app-util

             |        |-- pom.xml (jar)

             |

             |-- app-dao

             |        |-- pom.xml (jar)

             |

             |-- app-service

             |        |-- pom.xml (jar)

             |

             |-- app-web

                      |-- pom.xml (war)

二、 Maven創(chuàng)建多模塊聚合項目

1.1 創(chuàng)建父工程

1.以IDEA為示例 (Eclipse大同小異) 選擇New--Project

2.在彈出界面選擇Maven, 選擇JDK，-->next

3.輸入GroupId 和ArtifactId , -->next

4.輸入完整項目名，和項目保存在本地的路徑 ->finish

5.完成之后我們得到一個新建的maven工程作為我們的父工程，然后刪掉目錄下的整個src,得到如下目錄

1.2 Spring Boot父工程

Spring boot在創(chuàng)建單應用項目的時候，有默認的<parent>依賴；我們在自定義父工程項目時，如果直接以Spring boot的parent作為項目的<parent>父依賴管理的話，子項目會由于存在兩個parent而報錯，無法導入依賴。

解決方案如下：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>${spring.boot.version}</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

使用spring-boot-dependencies依賴對springboot的依賴包進行統(tǒng)一管理。

對于Spring Boot項目，maven父工程項pom.xml我們需要做的處理

<modelVersion>4.0.0</modelVersion>
    <!--基本信息-->
    <groupId>com.tan</groupId>
    <artifactId>mtz-manager</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>

    <name>mtz-manager</name>
    <description>mtz-manager管理系統(tǒng)</description>

    <!--定義屬性值-->
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
        <spring.boot.version>2.1.1.RELEASE</spring.boot.version>
    </properties>

    <!-- 依賴聲明 -->
    <dependencyManagement>
        <dependencies>

            <!-- SpringBoot的依賴配置-->
            <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>

    <!--編譯管理 jdk版本和字符集編碼-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>

    <!--Maven遠程倉庫設置 非必要，可以刪除-->
    <repositories>
        <repository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>

    <!--Maven遠程插件庫設置 非必要，可以刪除-->
    <pluginRepositories>
        <pluginRepository>
            <id>public</id>
            <name>aliyun nexus</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
    </pluginRepositories>

到這里父工程創(chuàng)建完成。

2.1 創(chuàng)建子工程

1.創(chuàng)建子工程，我們先選中父工程目錄，然后New-->Model ，在彈出界面直接-->Next

3.下一步到這個頁面我們填寫子工程名稱，然后-->Next

4.根據(jù)情況修改以下屬性值，然后點擊--->finish

5.完成之后我們子工程就創(chuàng)建成功了，可以看到如下的目錄結構

并且父工程的pom會自動生成Modules標簽及內(nèi)容，這樣就創(chuàng)建了一個有聚合關系的工程了。

完了之后，我們打開Maven視圖，點擊一下父工程test看看是否存在錯誤,如看到以下打印，則表示子工程創(chuàng)建成功。

2.2 創(chuàng)建Spring Boot子工程

第一步：按照2.1創(chuàng)建完畢子工程。

第二部：我們以2.1創(chuàng)建的子工程后按照以下進行修改。

新建一個mtz-admin模塊，以mtz-admin為例,此模塊為web模塊

1.mtz-admin創(chuàng)建之后，修改mtz-admin的pom.xml添加以下內(nèi)容

    <dependencies>
        <!-- SpringBoot Web容器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

2。分別添加application.yml 和 Application.java