SpringBoot+maven聚合項目創建與打包部署的完整流程

開發環境：IDEA，
SprngBoot 2.0.4，
Maven 2.19.1
工程結構：
父工程father

                                               子模塊  dao      （用於持久化數據跟數據庫交互）

                                               子模塊  entity    （實體類）

                                               子模塊  service （處理業務邏輯）

                                               子模塊  web       （頁面交互接收、傳遞數據，唯一有啟動類的模塊）

                            關系：         web依賴 service、dao、entity

                                                service依賴 dao、entity

                                                dao依賴 entity

                                                entity誰都不依賴，獨立的

這里我用比較常見的工程結構舉例說明，有些公司的項目可能會把模塊分的很細，或者會有兩個程序入口，也就是兩個可以啟動的模塊！這個我在文章最后會做說明！縷清了思路其實沒那么復雜！

一，創建Maven多模塊項目
先建立外層父工程 File →new →project 選擇Spring Initializr Next下一步到以下頁面

工程結構如下

接下來，把src整個刪掉，父工程不需要，因為父工程你就當它只有一個外殼就完了

接下來創建子模塊 工程上右鍵 → new → Module 選擇Spring Initaializr 下一步

重復以上動作，創建dao模塊，service模塊，web模塊

service模塊和entity模塊一樣什么都不需要引入

dao模塊和web模塊可以根據實際需求選擇引入mysql，mybatis，redis，web這些，我把我的貼出來

刪除每個子模塊中沒用的文件，.mvn、.gitignore、daoiml、mvnw、mvnw.cmd文件只留下pom.xml

刪除除了web模塊以外其它模塊中的Applicatin啟動項，和resources目錄下的application.properties配置文件

以上動作操作完成以后如果你發現你的子模塊變成了文件夾，沒關系，找到Maven Projects刷新一下就好了

整理過后的項目結構是這樣的

以上項目的基本結構就完成了，接下來建立各自依賴

二、依賴關系
打開父pom.xml修改打包方式jar為pom，注意：build內容也需要做替換，因為默認的spring-boot-maven-plugin這種方式，等到后期打包的時候他會一直提示你，你引入的依賴不存在！代碼如下

4.0.0

com.miu
father
0.0.1-SNAPSHOT
pom

<name>father</name>
<description>Demo project for Spring Boot</description>

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

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
</properties>

<!--聲明你有四個兒子 -->
<modules>
    <module>entity</module>
    <module>dao</module>
    <module>service</module>
    <module>web</module>
</modules>

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

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

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.1</version>
            <configuration>
                <source>${java.version}</source>
                <target>${java.version}</target>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.19.1</version>
            <configuration>
                <skipTests>true</skipTests>    <!--默認關掉單元測試 -->
            </configuration>
        </plugin>
    </plugins>
</build>

這里有個坑需要注意，dao、service、entity這三個模塊的pom.xml文件中不需要build 內容，直接干掉

entity 的 pom.xml 內容

4.0.0
com.miu
entity
0.0.1-SNAPSHOT
jar
entity
Demo project for Spring Boot


com.miu
father
0.0.1-SNAPSHOT
../pom.xml


<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>



org.springframework.boot
spring-boot-starter


org.springframework.boot
spring-boot-starter-test
test



dao 的 pom.xml 內容

4.0.0

com.miu
dao
0.0.1-SNAPSHOT
jar
dao
Demo project for Spring Boot


com.miu
father
0.0.1-SNAPSHOT
../pom.xml


<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>



org.springframework.boot
spring-boot-starter-data-redis


org.mybatis.spring.boot
mybatis-spring-boot-starter
1.3.2


mysql
mysql-connector-java
runtime


org.springframework.boot
spring-boot-starter-test
test



com.miu
entity
0.0.1-SNAPSHOT



service 模塊的 pom.xml 內容

4.0.0

<groupId>com.miu</groupId>
<artifactId>service</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>

<name>service</name>
<description>Demo project for Spring Boot</description>
<!--聲明父模塊-->
<parent>
    <groupId>com.miu</groupId>
    <artifactId>father</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <relativePath>../pom.xml</relativePath>
</parent>
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <!--service模塊 引入entity模塊-->
    <dependency>
        <groupId>com.miu</groupId>
        <artifactId>entity</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>
    <!--service模塊 引入dao模塊-->
    <dependency>
        <groupId>com.miu</groupId>
        <artifactId>dao</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>
</dependencies>

web模塊的 pom.xml 內容 注意build部分，因為web模塊作為程序的入口啟動，所以它需要打包，並且要指定Main Class

4.0.0
com.miu
web
0.0.1-SNAPSHOT
jar
web
Demo project for Spring Boot


com.miu
father
0.0.1-SNAPSHOT
../pom.xml


<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>



org.springframework.boot
spring-boot-starter-data-redis


org.springframework.boot
spring-boot-starter-web


org.mybatis.spring.boot
mybatis-spring-boot-starter
1.3.2


mysql
mysql-connector-java
runtime


org.springframework.boot
spring-boot-starter-test
test



com.miu
entity
0.0.1-SNAPSHOT



com.miu
service
0.0.1-SNAPSHOT



com.miu
dao
0.0.1-SNAPSHOT





org.springframework.boot
spring-boot-maven-plugin


com.miu.web.WebApplication
ZIP




repackage







到此為止所有的依賴全部完成！接下來就是測試！這里只用簡單的測試來實驗！

三、代碼測試
entity模塊中創建 EntiyTest類

dao模塊中創建 DaoTest類

service模塊中創建ServiceTest類

Web模塊中創建WebTest類

最后把web模塊中的application.properties文件補充一下就OK了，因為引入了mysql，redis等配置，所以數據源是要配的，不然運行起來會報錯找不到數據源！

server.port=8080

-----------------------------------數據庫配置----------------------------------------

spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/test?characterEncoding=utf8
spring.datasource.username=root
spring.datasource.password=123

------------------------------------redis配置---------------------------------------

https://weibo.com/ttarticle/p/show?id=2309404564926466490427
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564926537793624
https://weibo.com/ttarticle/p/show?id=2309404564926537793624
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564926613291085
https://weibo.com/ttarticle/p/show?id=2309404564926613291085
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564926973739139
https://weibo.com/ttarticle/p/show?id=2309404564926973739139
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564927045304398
https://weibo.com/ttarticle/p/show?id=2309404564927045304398
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564927502221339
https://weibo.com/ttarticle/p/show?id=2309404564927502221339
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564927590563858
https://weibo.com/ttarticle/p/show?id=2309404564927590563858
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564927888097307
https://weibo.com/ttarticle/p/show?id=2309404564927888097307
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564927955206200
https://weibo.com/ttarticle/p/show?id=2309404564927955206200
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564928567836780
https://weibo.com/ttarticle/p/show?id=2309404564928567836780
https://weibo.com/ttarticle/p/show%3Fid%3D2309404564928651460642
https://weibo.com/ttarticle/p/show?id=2309404564928651460642
spring.redis.database=0
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.password=
spring.redis.jedis.pool.max-active=8
spring.redis.jedis.pool.max-idle=8
spring.redis.jedis.pool.max-wait=-1ms
spring.redis.jedis.pool.min-idle=0
spring.redis.timeout=10000ms
一切准備就緒，開始運行web模塊下的啟動類進行測試

四、打包可執行jar
看到上面的頁面就證明模塊之間的依賴沒有問題，調用正常，我這里是用簡單的創建對象的這種方式來操作的，實際開發並不是這種操作，大部分都是通過 @Autowired 注解 來實現的注入，這里我就不做演示了，只要模塊之間調用沒問題，剩下的就是鋪代碼的事了，接下來還有最后一個打包問題，為什么要啰嗦那么多還要說打包問題呢，因為我建議在項目架構之初，除了搭框架以外，最好是在最開始的時候就測試一下打包，尤其是這種多模塊項目之間各種依賴的這種工程的打包，如果等你代碼寫的鋪天蓋地的時候你在去想怎么打包，到時候有你頭疼的！如果你是按照我本章的流程一步步下來的話，那么你完全不用擔心打包問題，因為所有的pom.xml有已經配置好了，只需要動手運行 package打包動作就行了，第一次打包不需要clean，記住以后每次打包之前clean一下，關於為什么打jar包，不打war包這個問題，還有其它會遇到的問題，在文章最后會做說明！

雙擊運行package，看到BUILD SUCCESS 就證明打包成功了，如此簡單？告訴你就是這么簡單，前提是你的每一個模塊下的pom.xml要配置好，誰需要打包，誰不需要打包，誰依賴誰，父工程是否聲明了子模塊，子模塊是否聲明了父工程是誰，這些是重點！

接下來去找你工程目錄，web文件夾下的target文件夾，剛才打包好的jar文件，就放在這里了

然后我把這個jar文件上傳到我的測試服務器，使用 java -jar web-0.0.1-SNAPSHOT.jar 命令來測試運行打包的可執行jar文件到底行不行！

運行成功，輸入我測試服務器地址測試也沒問題，到此為止全部搞定

聚合工程舉一個簡單的例子，

整個工程你就當作一個公司，父工程（退休了什么也不干）只需要聲明有幾個兒子（子模塊）就完事了，

子模塊web聲明父工程是誰，就當他是大兒子，公司他管事，pom.xml文件需要打包，需要build配置，需要其它三個兄弟幫助

其它子模塊聲明父工程是誰，之間關系都是兄弟，不需要打包，哪里需要去哪里！

在此我說一下重點和需要注意的地方！
1.父pom.xml 打包方式，jar要更改為pom，build 需要更改

2.不需要打包的模塊pom.xml文件中不要寫 ，全刪掉，例如有些工程中的common模塊，utils模塊，entity模塊，service模 塊都不需要打包

3.聲明父工程時，填寫父工程位置 ../pom.xml

4.關於applicatin.properties配置文件，只需要在啟動的模塊中配置就可以了，

5.關於打包為什么打包jar包，不打war包，打war包目的是war包可以運行在tomcat下，但是SpringBoot是內置tomcat，如果你打war包，前提是干掉內置的tomcat，然后才能打包，各種麻煩，直接打包可執行jar包，使用java -jar 命令就可以完美的運行起來很方便！

6.真實開發中使用@Autowired 注解 來實現注入，而不是new對象這種方式，所以可能會產生注入以后報錯，是因為你的啟動類上沒有配置掃描，使用

@ComponentScan(basePackages = "你的路徑")注解來解決，如果你使用的持久層是Mybatis，那么你的mapper也需要掃描，在啟動類上使用
@MapperScan("你的mapper文件地址")注解來解決，算了還是貼個圖片吧

不羅嗦了，就到這里吧，一個文章寫了兩個小時可見我的良苦用心，（關鍵是我被這個多模塊打包問題困擾了好長時間，網上各種找解決辦法，說的天花亂墜，狗屁不通，服的五體投地）