Spring Boot2從入門到實戰：整合Web項目常用功能

在Web應用開發過程中，一般都涵蓋一些常用功能的實現，如數據庫訪問、異常處理、消息隊列、緩存服務、OSS服務，以及接口日志配置，接口文檔生成等。如果每個項目都來一套，則既費力又難以維護。可以通過Spring Boot的Starter來將這些常用功能進行整合與集中維護，以達到開箱即用的目的。

項目基於Spring Boot 2.1.5.RELEASE 版。
項目地址： https://github.com/ronwxy/base-spring-boot

 

整個項目分為如下幾部分：

• spring-boot-autoconfigure： 具體的各功能實現，每個功能通過package的形式組織
• spring-boot-commons： 一些公共的工具類或共享類
• spring-boot-dependencies： 依賴的集中維護管理，集中管理各個依賴的版本號
• spring-boot-parent： 提供一個基本的父項目，web服務項目可通過繼承該項目創建
• spring-boot-starters： 各功能的starter項目，引入相應starter即引入相應功能

spring-boot-dependencies 項目

該項目主要是對所有依賴進行集中定義。通過 dependencyManagement 對依賴進行聲明，

<dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-dependencies</artifactId>
               <version>${spring-boot.version}</version>
               <scope>import</scope>
               <type>pom</type>
           </dependency>

           <dependency>
               <groupId>cn.jboost.springboot</groupId>
               <artifactId>spring-boot-commons</artifactId>
               <version>${base-spring-boot.version}</version>
           </dependency>

           ...
       </dependencies>
</dependencyManagement>

 

這樣，所有依賴的版本可以集中統一管理，在其它地方引用的時候可以省去版本的聲明，如

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <optional>true</optional>
</dependency>

 

spring-boot-autoconfigure 項目

該項目是各功能自動配置的具體實現，以package的形式進行組織，如 tkmapper 包下實現了通用Mapper的自動配置，error 包下實現了錯誤處理的自動配置， 等等。

該項目繼承了spring-boot-dependencies， 在項目的 pom.xml 中，依賴部分聲明類似於

<dependencies>
        <!-- spring denpendencies -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <optional>true</optional>
        </dependency>
        ...
</dependencies>

不需要再指定版本號。通過將optional設置為true，表示該依賴不會進行傳遞，即另外一個項目引用該項目時，optional的依賴不會被傳遞依賴過去。

在 resources/META-INF/spring.factories 文件中，聲明了所有自動配置類， 如下

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
cn.jboost.springboot.autoconfig.tkmapper.MapperAutoConfiguration,\
cn.jboost.springboot.autoconfig.aoplog.AopLoggerAutoConfiguration,\
cn.jboost.springboot.autoconfig.alimq.config.AliMQAutoConfiguration,\
cn.jboost.springboot.autoconfig.qiniu.QiniuAutoConfiguration,\
cn.jboost.springboot.autoconfig.swagger.Swagger2AutoConfiguration,\
cn.jboost.springboot.autoconfig.druid.DruidAutoConfiguration,\
cn.jboost.springboot.autoconfig.error.exception.ExceptionHandlerAutoConfiguration,\
cn.jboost.springboot.autoconfig.alimns.MnsAutoConfiguration,\
cn.jboost.springboot.autoconfig.redis.RedisClientAutoConfiguration,\
cn.jboost.springboot.autoconfig.web.CORSAutoConfiguration

 

spring-boot-starters 項目

該項目包含按功能划分的多個子項目，主要用來引入依賴以達到自動配置的依賴條件，使引入對應starter時，能讓自動配置生效。如通用Mapper集成的 tkmapper-spring-boot-starter 依賴如下

<dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>tk.mybatis</groupId>
            <artifactId>mapper</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
        </dependency>
</dependencies>

同時在 resources/META-INF/spring.provides 里聲明了該starter的用途，這里可隨意編寫。

 

spring-boot-commons 項目

可將一些常用的工具類， 或共享類放到這個項目中。比如一些常量定義，加解密工具類等。

 

spring-boot-parent 項目

該項目將Web應用需要的一些常見功能整合進來，應用項目可繼承該項目進行構建，從而直接引入相應的功能。

在接下來的spring boot系列博文中，將一一詳細介紹各功能的整合集成與應用。同時會不斷更新與完善，以達到能直接用於生產項目的水平。

Spring Boot入門到實戰匯總：https://www.cnblogs.com/spec-dog/p/11062994.html

 

我的個人博客地址：http://blog.jboost.cn
我的頭條空間： https://www.toutiao.com/c/user/5833678517/#mid=1636101215791112
我的github地址：https://github.com/ronwxy
我的微信公眾號：jboost-ksxy

—————————————————————————————————————————————————

歡迎關注我的微信公眾號，及時獲取最新分享