構(gòu)建多模塊的Spring Boot項目步驟全紀錄

前言

眾所周知，在多個項目中可能會相同的模塊，如果每個項目都去創(chuàng)建一遍的話，這樣開發(fā)效率會很低。比如在開發(fā)一個APP應(yīng)用的時候，有供APP使用的接口項目、后臺管理系統(tǒng)，兩個項目共用一套數(shù)據(jù)庫，分開的話需要配置多次mybatis,如果有些表需要改動的話，則都需要改動，所以使用多模塊管理這些模塊的話，會非常的方便。

通過閱讀本文你將了解到：如何將已有SpringBoot項目改成多模塊 & 如何新構(gòu)建多模塊SpringBoot項目 以下示例基于我正在使用的order(訂單服務(wù))進行演示，無論你用的是什么項目，原理都是一樣的，這里不要糾結(jié)使用的是什么服務(wù)。

1、修改最外層pom文件

最外層pom文件是用來管理其他子模塊的父級pom，重點將<packaging>節(jié)點修改為pom，修改前<packaging>可能是jar或war

這里修改成pom是因為打包時，父pom是依賴于子pom進行打包的，父pom會通過<modules>節(jié)點將所有的子pom模塊引入并且進行管理

<packaging>pom</packaging>

2、創(chuàng)建多模塊

假設(shè)你已經(jīng)設(shè)計好子模塊的拆分原則，這里開始基于你自己的設(shè)計進行子模塊的創(chuàng)建

例如：我將order項目拆分成三個不通的子模塊，即common、client、server，每個模塊負責的事情是不同的

第一步：右鍵項目名稱，選擇New->Module

第二步：在彈出的New Module窗口選擇Maven

第三步：點擊Next，并輸入子模塊的ArtifactId，如：common、client、server等，然后點擊Next

第四步：檢查并確認子模塊名稱及路徑是否正確，如果正確則點擊Finish

至此，common模塊就創(chuàng)建成功了，你會發(fā)現(xiàn)order根目錄下多了一個common子模塊

3、轉(zhuǎn)移代碼

創(chuàng)建了common模塊后，如果有需要移動至common子模塊下的代碼，則根據(jù)原來的代碼目錄結(jié)構(gòu)，在common-src-main-java下創(chuàng)建相同的目錄結(jié)構(gòu)即可

例如：我項將ProductInfoOutput移動到common子模塊下，原來ProductInfoOutput的保路經(jīng)為com.imooc.order.common，那么我需要在common-src-main-java下創(chuàng)建com.imooc.order.common包，并將ProductInfoOutput拽進去

補充說明：我在創(chuàng)建com.imooc.order.common包時遇到了一個問題，就是右鍵java文件夾然后選New->Package并創(chuàng)建com.imooc.order.common時，創(chuàng)建出來的包路徑時沒有層次結(jié)構(gòu)的，也就是說IDEA單純的為我創(chuàng)建了一個名為com.imooc.order.common的文件夾

經(jīng)研究發(fā)現(xiàn)，是視圖的問題，將左上角的Project改成Project Files，然后按照上面的方式創(chuàng)建即可

在轉(zhuǎn)移test目錄下的代碼時，同樣需要注意test目錄下的包結(jié)構(gòu)要與轉(zhuǎn)移前的結(jié)構(gòu)一致，這里以server模塊為例，因為common下的test目錄沒有代碼

當我們創(chuàng)建好多有的子模塊后，觀察最外層的父級pom文件內(nèi)容，發(fā)現(xiàn)父級pom已經(jīng)將我們創(chuàng)建的子模塊作為modules引入進來了

4、修改子模塊pom文件

當我們創(chuàng)建好多個子模塊后，子模塊間可能會存在依賴關(guān)系，例如我的server模塊會依賴common模塊下的ProductInfoOutput類

那么我需要在server模塊的pom文件中將common模塊引入

其他模塊間的依賴引用同理

修改完子pom的依賴關(guān)系后，一定要刷新pom文件，不然依賴不會生效

5、配置打包插件

SpringBoot項目一般都會打成jar包部署，所以需要在pom中引入spring-boot-maven-plugin的maven插件

例如：我現(xiàn)在要打包order項目，此時我的SpringBoot運行主類在server模塊下，那么我就需要以server模塊為主要的打包對象

因為打包時，maven插件會去找SpringBoot的啟動類，如果沒有啟動類會打包失敗

那么，此時我就需要在server模塊的pom中增加spring-boot-maven-plugin的相關(guān)配置

<build>
  <plugins>
   <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
   </plugin>
  </plugins>
 </build>

注意：在最外層的父級pom中如果同樣存在spring-boot-maven-plugin的配置，記得一定要刪除掉

6、打包并運行服務(wù)

在maven窗口一次執(zhí)行Lifecycle下的clean和install（如果你會maven命令，也可以用命令操作）

可以看到，這幾個模塊都是SUCCESS，說明構(gòu)建成功了

那我們要的可以運行的jar文件在server模塊的target目錄下，我們找到它

最后放到服務(wù)器上運行這個jar包

使用命令：nohuo java -jarorder-server-0.0.1-SNAPSHOT.jar > order.log 2>&1 &

可以看到，項目已經(jīng)成功啟動了，端口號為默認的8080

至此，構(gòu)建多模塊的SpringBoot項目就已經(jīng)告一段落了

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，謝謝大家對億速云的支持。