依賴管理和自動配置

1.依賴管理

1.1什么是依賴管理

1. spring-boot-starter-parent 中還有父項目，聲明了開發中常用的依賴的版本號

2. 并且進行自動版本仲裁，即如果程序員沒有指定某個依賴jar的版本，則以父版本指定的版本為準

   

1.2修改自動仲裁/默認版本號

比如我們要將SpringBoot的 mysql 驅動版本改為 5.1.49（默認版本為8.0.26），有兩種方法：

（1）方式一：在pom.xml文件中顯式的導入mysql依賴，并指定version

<!--自己指定mysql的驅動版本-->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

（2）方式二：在pom.xml文件的< properties>節點中指定mysql的 key，形如：

<properties>
    <mysql.version>5.1.49</mysql.version>
</properties>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

為什么能夠達到修改版本仲裁的效果？

答：根據依賴就近優先原則。比如pom.xml文件不斷的應用依賴，形成了一個依賴樹，那么項目依賴jar的版本以離本項目最近的版本為準。如果本項目沒有指定該jar的版本，就以離本項目最近的父項目的版本為準。

2.starter場景啟動器

2.1starter場景啟動器基本介紹

（1）開發中我們引入了相關場景的starter，這個場景中所有的相關依賴都引進來來，比如我們做web開發引入了spring-boot-starter-web，該starter將導入所有與web開發相關的所有包

（2）依賴樹：可以看到spring-boot-starter-web幫我們引入了spring-webmvc，spring-web開發模塊，還引入了spring-boot-starter-tomcat場景，spring-boot-starter-json場景，這些場景下面又引入了一大堆相關的包，這些依賴項可以快速啟動和運行一個項目，提高開發效率。

（3）所有場景啟動器最基本的依賴就是spring-boot-starter，從前面的依賴樹可以看到這個依賴是SpringBoot自動配置的核心依賴

2.2官方提供的starter

官方文檔：Developing with Spring Boot

介紹：

1. 在開發中我們經常會用到spring-boot-starter-xxx，比如spring-boot-starter-web，該場景作用于web開發，也就是說xxx是某種開發場景
2. 我們只要引入starter，這個場景的所有常規需要的依賴都能自動引入

2.3第三方starter

1. SpringBoot也支持第三方starter
2. 第三方starter不需要從spring-boot開始，因為這是官方spring-boot保留的命名方式。第三方啟動程序通常以項目名稱開頭。例如，名為thirdpartyproject的第三方啟動程序項目通常被命名為thirdpartyproject-spring-boot-starter
3. 也就是說，xxx-spring-boot-starter是第三方為我們提供的簡化開發的場景啟動器

3.自動配置

3.1自動配置介紹

在SSM框架整合時，需要配置tomcat、配置SpringMVC、配置如何掃描包、配置字符過濾器、配置視圖解析器、文件上傳等，非常麻煩。而在SpringBoot中，存在自動配置機制，極大提高了開發效率。

3.2SpringBoot自動配置了哪些

1. 自動配置了Tomcat

2. 自動配置了SpringMVC

3. 自動配置了Web的常用功能：比如字符過濾器，文件上傳，視圖解析器等等

   

4. 自動配置：默認掃描包結構[官方文檔]，它會去掃描主程序所在的包及其子包下的所有文件，當然如果要掃描其他包也可以進行配置。

   

3.3如何修改默認配置

3.3.1修改默認掃描包結構

直接在主程序的注解中指定要掃描的包及其子包：

@SpringBootApplication(scanBasePackages = {"com.li","xx.yy","aa.bb"})

注意，scanBasePackages屬性可以接收多個值。

3.3.2通過屬性文件修改配置

SpringBoot項目最重要也是最核心的配置文件就是application.properties，所有的框架配置都可以在這個配置文件中說明。application.properties文件一般放在resources目錄下。

application.properties配置大全

默認配置最終都是映射到某個類中，這個類最終也會被注入到spring的容器中。

配置properties-->配置屬性Bean-->Spring容器

例子：

#修改server的監聽端口 默認為8080
server.port=10000

#修改單個文件上傳的默認最大值 默認為1MB
#multipart.max-file-size屬性可以指定SpringBoot上傳文件的大小限制
#默認配置最終都是映射到某個類中！
#比如multipart.max-file-size會映射到MultipartProperties類上
#將光標放在該屬性，輸入ctrl+b，就可以定位這個屬性是關聯到哪個屬性類上的
spring.servlet.multipart.max-file-size=10MB

3.3.3application.properties常用配置

#端口號
server.port=10000

#應用的上下文路徑(項目路徑)
server.servlet.context-path=/allModel

#指定 POJO 掃描包來讓 mybatis 自動掃描到自定義的 POJO
mybatis.type-aliases-package=com.cxs.allmodel.model

#指定 mapper.xml 的路徑：
#application 上配置了@MapperScan(掃描mapper類的路徑)和 pom.xml 中放行了 mapper.xml后，
#配置mapper-locations沒有意義。如果mapper類和 mapper.xml不在同一個路徑下時，mapper-locations就有用了
mybatis.mapper-locations=classpath:com/cxs/allmodel/mapper

#session 失效時間(單位 s)
spring.session.timeout=18000

#數據庫連接配置
#mysql 數據庫 url
mysql.one.jdbc-url=jdbc:mysql://127.0.0.1:3306/test?serverTimezone=Asia/Shanghai&useSSL=false
#mysql 數據庫用戶名
mysql.one.username=
#數據庫密碼
mysql.one.password=
#線程池允許的最大連接數
mysql.one.maximum-pool-size=15

#日志打印:
#日志級別 trace<debug<info<warn<error<fatal 默認級別為 info，即默認打印 info 及其以上級別的日志
#logging.level 設置日志級別，后面跟生效的區域，比如 root 表示整個項目，也可以設置為某個包下，也可以具體到某個類名（日志級別的值不區分大小寫）
logging.level.com.cxs.allmodel.=debug
logging.level.com.cxs.allmodel.mapper=debug
logging.level.org.springframework.web=info
logging.level.org.springframework.transaction=info
logging.level.org.apache.ibatis=info
logging.level.org.mybatis=info
logging.level.com.github.pagehelper = info
logging.level.root=info
#日志輸出路徑
logging.file=/tmp/api/allmodel.log

#配置 pagehelper 分頁插件
pagehelper.helperDialect=mysql
pagehelper.reasonable=true
pagehelper.supportMethodsArguments=true
pagehelper.params=count=countSql

#jackson 時間格式化
spring.jackson.serialization.fail-on-empty-beans=false

#指定日期格式，比如 yyyy-MM-dd HH:mm:ss，或者具體的格式化類的全限定名
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss

#指定日期格式化時區，比如 America/Los_Angeles 或者 GMT+10
spring.jackson.time-zone=GMT+8

#設置統一字符集
spring.http.encoding.charset=utf8

#redis 連接配置
# redis 所在主機 ip 地址
spring.redis.host=
#redis 服務器密碼
spring.redis.password=
#redis 服務器端口號
spring.redis.port=
#redis 數據庫的索引編號(0 到 15)
spring.redis.database=14
# 連接池的最大活動連接數量，使用負值無限制
spring.redis.pool.max-active=8
# 連接池的最大空閑連接數量，使用負值表示無限數量的空閑連接
spring.redis.pool.max-idle=8
# 連接池最大阻塞等待時間，使用負值表示沒有限制
spring.redis.pool.max-wait=-1ms
# 最小空閑連接數量，使用正值才有效果
spring.redis.pool.min-idle=0
# 是否啟用 SSL 連接.
spring.redis.ssl=false
# 連接超時，毫秒為單位
spring.redis.timeout= 18000ms
# 集群模式下，集群最大轉發的數量
spring.redis.cluster.max-redirects=
# 集群模式下，逗號分隔的鍵值對（主機：端口）形式的服務器列表
spring.redis.cluster.nodes=
# 哨兵模式下，Redis 主服務器地址
spring.redis.sentinel.master=
# 哨兵模式下，逗號分隔的鍵值對（主機：端口）形式的服務器列表
spring.redis.sentinel.nodes= 127.0.0.1:5050,127.0.0.1:5060

3.3.4application.properties自定義配置

我們還可以在properties文件中自定義配置，通過@Value("${}")獲取對應屬性值

例子：

（1）application.properties 文件

my.website=https://www.baidu.com

（2）某個 Bean

@Value("${my.website}")
private String bdUrl;//從application.properties中獲取value值

3.4SpringBoot在哪里讀取application.properties配置

（1）打開ConfigFileApplicationListener.java，看一下源碼

private static final String DEFAULT_SEARCH_LOCATIONS = "classpath:/,classpath:/config/,file:./,file:./config/*/,file:./config/";

可以看到SpringBoot默認讀取的路徑有：

1. 類路徑：classpath:/
2. 類路徑的config目錄下：classpath:/config/
3. 項目根目錄下：file:./
4. 根目錄的config目錄的任何子級目錄下：file:./config/*/
5. 根目錄的config目錄下：file:./config/

也就是說如果我們把 application.properties 放在上述任意的目錄下, 你會發現依然是管用的。

3.5自動配置遵守按需加載原則

3.5.1說明

1. 自動配置遵守按需加載原則：也就是說，引入了哪個場景starter就會加載該場景關聯的jar包，沒有引入的starter則不會加載其關聯的jar

2. SpringBoot所有的自動配置功能都在spring-boot-autoconfigure包里面

3. 在SpringBoot的自動配置包，一般是XxxAutoConfiguration.java，對應XxxProperties.java（XxxProperties.java又會從配置文件applicatio.properties中去讀取設置，如果沒有設置值，就保持默認值）