依賴管理有gradle和maven,在這裡選擇比較常用和方便的Maven作為工程項目和依賴管理工具來搭建SpringCloud實戰工程。主要用到的maven管理方式是多模塊和bom依賴管理。 ...
前言
依賴管理有gradle和maven,在這裡選擇比較常用和方便的Maven作為工程項目和依賴管理工具來搭建SpringCloud實戰工程。主要用到的maven管理方式是多模塊和bom依賴管理。
什麼是maven的多模塊依賴管理
Maven 多模塊項目相對於單模塊項目而言,依賴是不共用的,但父模塊提供了全局共用依賴的功能,可以針對不同模塊所需要依賴的包進行分模塊引入。具體如下:
- 所有子模塊都依賴的包,如
junit
可以統一由父模塊中的<dependencies>
設置依賴。 - 多個子模塊但非全部子模塊依賴的包,可以在父模塊中的
<dependencyManagement>
中統一管理依賴版本,再由每個子模塊自主引入依賴,這樣設置可以達到項目中多個子模塊依賴的包版本統一的目的。 - 單個子模塊依賴的包,可以直接交由這個子模塊引入即可。但有時候出於對後續可能添加子模塊考慮,即使當前只有一個子模塊依賴的包,也可以統一交由父模塊的
<dependencyManagement>
統一管理,而如果確認後續不會再加子模塊的,可以按前者進行處理。
在父模塊中,可通過<properties>
統一管理依賴包的版本,讓共用包也更加統一管理。
什麼是maven的bom依賴管理
Maven 的 BOM(Bill of Materials)依賴管理是一種用於集中管理項目依賴關係和版本的方式,它提供了一種方便的方法來確保多個項目或模塊在使用相同依賴時具有一致的版本。
BOM 通常是一個特殊的 Maven POM(Project Object Model)文件,其中定義了項目所需的依賴項及其版本。通過在其他項目中引用這個 BOM,這些項目將自動獲取 BOM 中定義的依賴版本,而無需明確指定每個依賴的版本。
這樣做的好處是可以減少重覆的依賴配置工作,並確保在多個項目中使用相同的依賴版本,從而減少由於依賴不一致導致的問題。此外,BOM 還可以用於管理依賴的升級和版本控制,只需在 BOM 中更新依賴的版本,所有引用該 BOM 的項目都會自動獲取最新的版本。
要使用 Maven 的 BOM 依賴管理,通常需要執行以下步驟:
- 創建或獲取一個 BOM POM 文件,其中定義了項目的依賴和版本信息。
- 在需要使用 BOM 的項目中,通過在
<dependencyManagement>
部分引用 BOM POM 文件。 - 在項目的具體依賴部分,可以直接使用 BOM 中定義的依賴,而無需明確指定版本。
組件選型
在“SpringCloud2023最新版本該如何進行組件選型?”一文中已經具體的介紹了SpringCloud的組件對比和選型,具體可以查看合集裡面的相關文檔。
- 註冊中心(Spring Cloud Zookeeper):負責服務的註冊和發現。
- 網關(Spring Cloud Gateway):作為外部請求的入口,實現路由和負載均衡。
- 雲服務配置(Spring Cloud Config):用於管理服務的配置信息。
- 熔斷(Sentinel):提供熔斷器功能,實現服務的限流和降級。
- 服務追蹤(Micrometer Tracing):用於追蹤和監控服務的性能和調用情況。
- 測試集成(JUnit 5 + Spring Boot Test):用於編寫和執行單元測試。
- 遠程調用(OpenFeign):用於服務之間的遠程調用。
- 介面文檔(springdoc-openapi + openapi3):用於生成和管理 API 的文檔。
- 分散式事務(Seata):用於處理跨多個服務的事務。
版本選擇
在“SpringCloud和SpringBoot的版本依賴該怎麼選擇”一文中已經具體的介紹了SpringCloud的版本如何選擇,具體可以查看合集裡面的相關文檔。
組件 | 版本 |
---|---|
jdk | 17 |
spring boot | 3.2.x |
spring cloud | 2023.0.x |
spring cloud alibaba | 2022.0.0.0(還未更新,但是相容2023) |
為什麼選擇JDK17
選擇JDK17的原因如下:
- JDK 17是 LTS(長期支持版)。
- JDK 17性能提升不少。
- 大多數第三方框架和庫都已經支持,不會有什麼大坑。
- JDK 17有更多的新特性支持。
Maven工程依賴說明
|-- banana-client1
|-- banana-client2
|-- banana-client3
|-- banana-client4-sentinel
|-- banana-client5-tracing
|-- banana-client6-test
|-- banana-common
| |-- banana-common-bom
| `-- banana-common-core
|-- banana-config
|-- banana-gateway
|-- banana-gateway-sso
`-- banana-seata-example
- 根目錄下的pom.xml負責管理整個項目的版本和依賴引入版本管理,以及子模塊的管理。
banana-common-bom
負責管理整個公共依賴的版本,比如undertow、swagger的版本。banana-common-core
負責管理整個公共組件的引入,比如 hutool、validation、test等。gateway
相關項目為SCG相關工程。client
相關項目為springboot相關工程。- 其他工程會在後續的文章說明。歡迎持續關註。
頂級工程pom.xml配置
該maven的pom文件定義瞭如下內容:
- Maven 項目的模塊列表
- Maven 項目的屬性列表
- Maven 項目的依賴管理
- Maven 項目的倉庫列表
- Maven 項目的構建配置
<?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">
<!-- Maven 項目的根節點 -->
<modelVersion>4.0.0</modelVersion>
<!-- Maven 項目的groupId,在 Maven 倉庫中,groupId 必須是唯一的 -->
<groupId>io.rainforest</groupId>
<!-- Maven 項目的 artifactId,可以包含多個模塊 -->
<artifactId>banana</artifactId>
<!-- Maven 項目的版本號 -->
<version>1.0</version>
<!-- Maven 項目的打包方式,這裡是 pom -->
<packaging>pom</packaging>
<!-- Maven 項目的模塊列表 -->
<modules>
<module>banana-gateway</module>
<module>banana-config</module>
<module>banana-common</module>
<module>banana-client1</module>
<module>banana-client2</module>
<module>banana-client3</module>
<module>banana-client4-sentinel</module>
<module>banana-client5-tracing</module>
<module>banana-client6-test</module>
<module>banana-seata-example</module>
<module>banana-gateway-sso</module>
</modules>
<!-- Maven 項目的屬性列表 -->
<properties>
<!-- Maven 編譯器的 source 版本 -->
<maven.compiler.source>17</maven.compiler.source>
<!-- Maven 編譯器的 target 版本 -->
<maven.compiler.target>17</maven.compiler.target>
<!-- 項目構建的源編碼 -->
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- Spring Boot 的版本 -->
<spring-boot.version>3.2.3</spring-boot.version>
<!-- Spring Cloud 的版本 -->
<spring-cloud.version>2023.0.0</spring-cloud.version>
<!-- Spring Cloud Alibaba 的版本 -->
<spring-cloud-alibaba.version>2022.0.0.0</spring-cloud-alibaba.version>
</properties>
<!-- Maven 項目的依賴管理 -->
<dependencyManagement>
<!-- Maven 項目的依賴列表 -->
<dependencies>
<!-- banana 公共版本定義 -->
<dependency>
<groupId>io.rainforest</groupId>
<artifactId>banana-common-bom</artifactId>
<version>${project.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- Spring Boot 依賴 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- Spring Cloud 依賴 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- Spring Cloud Alibaba 依賴 -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>${spring-cloud-alibaba.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Maven 項目的倉庫列表 -->
<repositories>
<!-- Maven 中央倉庫的配置 -->
<repository>
<id>central</id>
<name>Central Repository</name>
<url>https://mirrors.huaweicloud.com/repository/maven/</url>
<layout>default</layout>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<!-- Maven 項目的構建配置 -->
<build>
<!-- Maven 項目構建的最終名稱 -->
<finalName>${project.name}</finalName>
<!-- Maven 項目的資源配置 -->
<resources>
<!-- 資源文件所在的目錄 -->
<resource>
<directory>src/main/resources</directory>
<!-- 對資源文件進行過濾 -->
<filtering>true</filtering>
</resource>
</resources>
<!-- Maven 項目的插件管理 -->
<pluginManagement>
<!-- Maven 項目的插件列表 -->
<plugins>
<!-- Spring Boot Maven 插件的配置 -->
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<configuration>
<!-- 項目構建的最終名稱 -->
<finalName>${project.build.finalName}</finalName>
<!-- 啟用 Spring Boot 的分層 -->
<layers>
<enabled>true</enabled>
</layers>
</configuration>
<!-- Maven 插件的執行配置 -->
<executions>
<!-- Maven 插件的執行目標 -->
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>
工程的公用依賴bom配置
該maven的pom文件定義瞭如下內容:
- Maven 項目的屬性列表,包含版本等信息
- Maven 項目使用到的依賴版本管理
<?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">
<groupId>io.rainforest</groupId>
<artifactId>banana-common-bom</artifactId>
<version>1.0</version>
<modelVersion>4.0.0</modelVersion>
<packaging>pom</packaging>
<description>banana-common-bom 公共依賴管理</description>
<properties>
<banana.common.version>${project.version}</banana.common.version>
<spring-boot.version>3.1.3</spring-boot.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<log4j2.version>2.17.1</log4j2.version>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.source>17</maven.compiler.source>
<git.commit.plugin>4.9.9</git.commit.plugin>
<spring.checkstyle.plugin>0.0.39</spring.checkstyle.plugin>
<fastjson.version>1.2.83</fastjson.version>
<springdoc.version>2.1.0</springdoc.version>
<swagger.core.version>2.2.14</swagger.core.version>
<mybatis-plus.version>3.5.3.2</mybatis-plus.version>
<mysql.version>8.0.33</mysql.version>
<dynamic-ds.version>4.1.3</dynamic-ds.version>
<seata.version>1.6.1</seata.version>
<excel.version>3.1.0</excel.version>
<asm.version>7.1</asm.version>
<sms.version>3.0.0</sms.version>
<jaxb.version>2.3.5</jaxb.version>
<shardingsphere.version>5.4.0</shardingsphere.version>
<hutool.version>5.8.21</hutool.version>
<mica.version>3.0.8</mica.version>
<sentinel.version>1.8.4</sentinel.version>
</properties>
<!-- 定義全局jar版本,模塊使用需要再次引入但不用寫版本號-->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.rainforest</groupId>
<artifactId>banana-common-core</artifactId>
<version>${banana.common.version}</version>
</dependency>
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<version>${mysql.version}</version>
</dependency>
<!--springdoc -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
<version>${springdoc.version}</version>
</dependency>
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
<version>${springdoc.version}</version>
</dependency>
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-annotations-jakarta</artifactId>
<version>${swagger.core.version}</version>
</dependency>
<!--fastjson 版本-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>${fastjson.version}</version>
</dependency>
<!-- 多數據源依賴 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot3-starter</artifactId>
<version>${dynamic-ds.version}</version>
</dependency>
<!-- 阿裡雲簡訊下發 -->
<dependency>
<groupId>io.springboot.sms</groupId>
<artifactId>aliyun-sms-spring-boot-starter</artifactId>
<version>${sms.version}</version>
</dependency>
<!-- seata kryo 序列化-->
<dependency>
<groupId>io.seata</groupId>
<artifactId>seata-serializer-kryo</artifactId>
<version>${seata.version}</version>
</dependency>
<!--orm 相關-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-extension</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-annotation</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<!--hutool bom 工具類-->
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-bom</artifactId>
<version>${hutool.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--mica bom 工具類-->
<dependency>
<groupId>net.dreamlu</groupId>
<artifactId>mica-bom</artifactId>
<version>${mica.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--web 模塊-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>${spring-boot.version}</version>
<exclusions>
<!--排除tomcat依賴-->
<exclusion>
<artifactId>spring-boot-starter-tomcat</artifactId>
<groupId>org.springframework.boot</groupId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
<version>4.3.0</version>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<!--打包jar 與git commit 關聯插件-->
<plugin>
<groupId>io.github.git-commit-id</groupId>
<artifactId>git-commit-id-maven-plugin</artifactId>
<version>${git.commit.plugin}</version>
</plugin>
<!--代碼格式插件,預設使用spring 規則-->
<plugin>
<groupId>io.spring.javaformat</groupId>
<artifactId>spring-javaformat-maven-plugin</artifactId>
<version>${spring.checkstyle.plugin}</version>
</plugin>
</plugins>
</build>
</project>
源碼信息
和“SpringCloud實戰”對應的源碼信息如下:
- github https://github.com/r0ad/spring-cloud-example
- gitee https://gitee.com/r0ad/spring-cloud-example
關於作者
來自一線全棧程式員nine的八年探索與實踐,持續迭代中。歡迎關註“雨林尋北”或添加個人衛星codetrend(備註技術)。