SpringBoot+Maven多模塊項目（創建、依賴、打包可執行jar包部署測試）完整流程

 

 

 

開發環境：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這種方式，等到后期打包的時候他會一直提示你，你引入的依賴不存在！代碼如下

 

<?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>
    <!--父pom.xml-->
    <groupId>com.miu</groupId>
    <artifactId>father</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>
 
    <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>
 
</project>

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

 

entity 的 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.miu</groupId>
    <artifactId>entity</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>entity</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>
    </dependencies>
</project>

dao 的 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>
    <!--dao 模塊 pom.xml-->
    <groupId>com.miu</groupId>
    <artifactId>dao</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>dao</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-data-redis</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--dao 模塊 引入entity模塊-->
        <dependency>
            <groupId>com.miu</groupId>
            <artifactId>entity</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>
</project>

service 模塊的 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.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>
</project>

web模塊的 pom.xml 內容

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

 

<?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.miu</groupId>
    <artifactId>web</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>web</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-data-redis</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--web模塊 引入entity模塊-->
        <dependency>
            <groupId>com.miu</groupId>
            <artifactId>entity</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        <!--web模塊 引入service模塊-->
        <dependency>
            <groupId>com.miu</groupId>
            <artifactId>service</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        <!--web模塊 引入dao模塊-->
        <dependency>
            <groupId>com.miu</groupId>
            <artifactId>dao</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <!-- 指定該Main Class為全局的唯一入口 -->
                    <mainClass>com.miu.web.WebApplication</mainClass>
                    <layout>ZIP</layout>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal><!--可以把依賴的包都打包到生成的Jar包中-->
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

 

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

三、代碼測試

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配置---------------------------------------
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文件中不要寫<build>，全刪掉，例如有些工程中的common模塊，utils模塊，entity模塊，service模  塊都不需要打包

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

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文件地址")注解來解決，算了還是貼個圖片吧
---------------------