轉:https://blog.csdn.net/baidu_41885330/article/details/81875395
開發環境: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文件地址")注解來解決,算了還是貼個圖片吧
不羅嗦了,就到這里吧,一個文章寫了兩個小時可見我的良苦用心,(關鍵是我被這個多模塊打包問題困擾了好長時間,網上各種找解決辦法,說的天花亂墜,狗屁不通,服的五體投地)
————————————————
版權聲明:本文為CSDN博主「凌雲冷海」的原創文章,遵循CC 4.0 BY-SA版權協議,轉載請附上原文出處鏈接及本聲明。
原文鏈接:https://blog.csdn.net/baidu_41885330/article/details/81875395