構建多模塊的Spring Boot項目步驟全紀錄

更新時間：2019年05月15日 09:42:18 作者：zkm1992

這篇文章主要給大家介紹了關于如何構建多模塊的Spring Boot項目的相關資料，文中通過示例代碼介紹的非常詳細，對大家學習或者使用SpringBoot具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧

前言

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

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

1、修改最外層pom文件

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

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

<packaging>pom</packaging>

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

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

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

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

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

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

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

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

3、轉移代碼

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

例如：我項將ProductInfoOutput移動到common子模塊下，原來ProductInfoOutput的保路經為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)建出來的包路徑時沒有層次結構的，也就是說IDEA單純的為我創(chuàng)建了一個名為com.imooc.order.common的文件夾

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

在轉移test目錄下的代碼時，同樣需要注意test目錄下的包結構要與轉移前的結構一致，這里以server模塊為例，因為common下的test目錄沒有代碼

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

4、修改子模塊pom文件

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

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

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

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

5、配置打包插件

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

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

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

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

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

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

6、打包并運行服務

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