依賴管理和自動配置 1.依賴管理 1.1什麼是依賴管理 spring-boot-starter-parent 中還有父項目,聲明瞭開發中常用的依賴的版本號 並且進行自動版本仲裁,即如果程式員沒有指定某個依賴jar的版本,則以父版本指定的版本為準 1.2修改自動仲裁/預設版本號 比如我們要將Sprin ...
依賴管理和自動配置
1.依賴管理
1.1什麼是依賴管理
-
spring-boot-starter-parent 中還有父項目,聲明瞭開發中常用的依賴的版本號
-
並且進行自動版本仲裁,即如果程式員沒有指定某個依賴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
介紹:
- 在開發中我們經常會用到spring-boot-starter-xxx,比如spring-boot-starter-web,該場景作用於web開發,也就是說xxx是某種開發場景
- 我們只要引入starter,這個場景的所有常規需要的依賴都能自動引入
2.3第三方starter
- SpringBoot也支持第三方starter
- 第三方starter不需要從spring-boot開始,因為這是官方spring-boot保留的命名方式。第三方啟動程式通常以項目名稱開頭。例如,名為thirdpartyproject的第三方啟動程式項目通常被命名為thirdpartyproject-spring-boot-starter
- 也就是說,xxx-spring-boot-starter是第三方為我們提供的簡化開發的場景啟動器
3.自動配置
3.1自動配置介紹
在SSM框架整合時,需要配置tomcat、配置SpringMVC、配置如何掃描包、配置字元過濾器、配置視圖解析器、文件上傳等,非常麻煩。而在SpringBoot中,存在自動配置機制,極大提高了開發效率。
3.2SpringBoot自動配置了哪些
-
自動配置了Tomcat
-
自動配置了SpringMVC
-
自動配置了Web的常用功能:比如字元過濾器,文件上傳,視圖解析器等等
-
自動配置:預設掃描包結構[官方文檔],它會去掃描主程式所在的包及其子包下的所有文件,當然如果要掃描其他包也可以進行配置。
3.3如何修改預設配置
3.3.1修改預設掃描包結構
直接在主程式的註解中指定要掃描的包及其子包:
@SpringBootApplication(scanBasePackages = {"com.li","xx.yy","aa.bb"})
註意,scanBasePackages屬性可以接收多個值。
3.3.2通過屬性文件修改配置
SpringBoot項目最重要也是最核心的配置文件就是application.properties,所有的框架配置都可以在這個配置文件中說明。application.properties文件一般放在resources目錄下。
預設配置最終都是映射到某個類中,這個類最終也會被註入到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預設讀取的路徑有:
- 類路徑:
classpath:/
- 類路徑的config目錄下:
classpath:/config/
- 項目根目錄下:
file:./
- 根目錄的config目錄的任何子級目錄下:
file:./config/*/
- 根目錄的config目錄下:
file:./config/
也就是說如果我們把 application.properties 放在上述任意的目錄下, 你會發現依然是管用的。