基本概念
在開始說明Spring Boot中的數(shù)據(jù)源配置之前,我們先搞清楚關(guān)于數(shù)據(jù)訪問的這些基本概念:
什么是JDBC?
Java數(shù)據(jù)庫連接(Java Database Connectivity,簡(jiǎn)稱JDBC)是Java語言中用來規(guī)范客戶端程序如何來訪問數(shù)據(jù)庫的應(yīng)用程序接口,提供了諸如查詢和更新數(shù)據(jù)庫中數(shù)據(jù)的方法。JDBC也是Sun Microsystems的商標(biāo)。我們通常說的JDBC是面向關(guān)系型數(shù)據(jù)庫的。
JDBC API主要位于JDK中的java.sql
包中(之后擴(kuò)展的內(nèi)容位于javax.sql
包中),主要包括(斜體代表接口,需驅(qū)動(dòng)程序提供者來具體實(shí)現(xiàn)):
- DriverManager:負(fù)責(zé)加載各種不同驅(qū)動(dòng)程序(Driver),并根據(jù)不同的請(qǐng)求,向調(diào)用者返回相應(yīng)的數(shù)據(jù)庫連接(Connection)。
- Driver:驅(qū)動(dòng)程序,會(huì)將自身加載到DriverManager中去,并處理相應(yīng)的請(qǐng)求并返回相應(yīng)的數(shù)據(jù)庫連接(Connection)。
- Connection:數(shù)據(jù)庫連接,負(fù)責(zé)與進(jìn)行數(shù)據(jù)庫間通訊,SQL執(zhí)行以及事務(wù)處理都是在某個(gè)特定Connection環(huán)境中進(jìn)行的??梢援a(chǎn)生用以執(zhí)行SQL的Statement。
- Statement:用以執(zhí)行SQL查詢和更新(針對(duì)靜態(tài)SQL語句和單次執(zhí)行)。PreparedStatement:用以執(zhí)行包含動(dòng)態(tài)參數(shù)的SQL查詢和更新(在服務(wù)器端編譯,允許重復(fù)執(zhí)行以提高效率)。
- CallableStatement:用以調(diào)用數(shù)據(jù)庫中的存儲(chǔ)過程。
- SQLException:代表在數(shù)據(jù)庫連接的建立和關(guān)閉和SQL語句的執(zhí)行過程中發(fā)生了例外情況(即錯(cuò)誤)。
什么是數(shù)據(jù)源?
可以看到,在java.sql
中并沒有數(shù)據(jù)源(Data Source)的概念。這是由于在java.sql
中包含的是JDBC內(nèi)核API,另外還有個(gè)javax.sql
包,其中包含了JDBC標(biāo)準(zhǔn)的擴(kuò)展API。而關(guān)于數(shù)據(jù)源(Data Source)的定義,就在javax.sql
這個(gè)擴(kuò)展包中。
實(shí)際上,在JDBC內(nèi)核API的實(shí)現(xiàn)下,就已經(jīng)可以實(shí)現(xiàn)對(duì)數(shù)據(jù)庫的訪問了,那么我們?yōu)槭裁催€需要數(shù)據(jù)源呢?主要出于以下幾個(gè)目的:
- 封裝關(guān)于數(shù)據(jù)庫訪問的各種參數(shù),實(shí)現(xiàn)統(tǒng)一管理
- 通過對(duì)數(shù)據(jù)庫的連接池管理,節(jié)省開銷并提高效率
在Java這個(gè)自由開放的生態(tài)中,已經(jīng)有非常多優(yōu)秀的開源數(shù)據(jù)源可以供大家選擇,比如:DBCP、C3P0、Druid、HikariCP等。
而在Spring Boot 2.x中,對(duì)數(shù)據(jù)源的選擇也緊跟潮流,采用了目前性能最佳的HikariCPopen in new window。接下來,我們就來具體說說,這個(gè)Spring Boot中的默認(rèn)數(shù)據(jù)源配置。
#默認(rèn)數(shù)據(jù)源:HikariCP
由于Spring Boot的自動(dòng)化配置機(jī)制,大部分對(duì)于數(shù)據(jù)源的配置都可以通過配置參數(shù)的方式去改變。只有一些特殊情況,比如:更換默認(rèn)數(shù)據(jù)源,多數(shù)據(jù)源共存等情況才需要去修改覆蓋初始化的Bean內(nèi)容。本節(jié)我們主要講Hikari的配置,所以對(duì)于使用其他數(shù)據(jù)源或者多數(shù)據(jù)源的情況,在之后的教程中學(xué)習(xí)。
在Spring Boot自動(dòng)化配置中,對(duì)于數(shù)據(jù)源的配置可以分為兩類:
- 通用配置:以
spring.datasource.*
的形式存在,主要是對(duì)一些即使使用不同數(shù)據(jù)源也都需要配置的一些常規(guī)內(nèi)容。比如:數(shù)據(jù)庫鏈接地址、用戶名、密碼等。這里就不做過多說明了,通常就這些配置:
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
- 數(shù)據(jù)源連接池配置:以
spring.datasource.<數(shù)據(jù)源名稱>.*
的形式存在,比如:Hikari的配置參數(shù)就是spring.datasource.hikari.*
形式。下面這個(gè)是我們最常用的幾個(gè)配置項(xiàng)及對(duì)應(yīng)說明:
spring.datasource.hikari.minimum-idle=10
spring.datasource.hikari.maximum-pool-size=20
spring.datasource.hikari.idle-timeout=500000
spring.datasource.hikari.max-lifetime=540000
spring.datasource.hikari.connection-timeout=60000
spring.datasource.hikari.connection-test-query=SELECT 1
這些配置的含義:
spring.datasource.hikari.minimum-idle
: 最小空閑連接,默認(rèn)值10,小于0或大于maximum-pool-size,都會(huì)重置為maximum-pool-sizespring.datasource.hikari.maximum-pool-size
: 最大連接數(shù),小于等于0會(huì)被重置為默認(rèn)值10;大于零小于1會(huì)被重置為minimum-idle的值spring.datasource.hikari.idle-timeout
: 空閑連接超時(shí)時(shí)間,默認(rèn)值600000(10分鐘),大于等于max-lifetime且max-lifetime>0,會(huì)被重置為0;不等于0且小于10秒,會(huì)被重置為10秒。spring.datasource.hikari.max-lifetime
: 連接最大存活時(shí)間,不等于0且小于30秒,會(huì)被重置為默認(rèn)值30分鐘.設(shè)置應(yīng)該比mysql設(shè)置的超時(shí)時(shí)間短spring.datasource.hikari.connection-timeout
: 連接超時(shí)時(shí)間:毫秒,小于250毫秒,否則被重置為默認(rèn)值30秒spring.datasource.hikari.connection-test-query
: 用于測(cè)試連接是否可用的查詢語句
更多完整配置項(xiàng)可查看下表:
name | 描述 | 構(gòu)造器默認(rèn)值 | 默認(rèn)配置validate之后的值 | validate重置 |
---|---|---|---|---|
autoCommit | 自動(dòng)提交從池中返回的連接 | TRUE | TRUE | – |
connectionTimeout | 等待來自池的連接的最大毫秒數(shù) | SECONDS.toMillis(30) = 30000 | 30000 | 如果小于250毫秒,則被重置回30秒 |
idleTimeout | 連接允許在池中閑置的最長(zhǎng)時(shí)間 | MINUTES.toMillis(10) = 600000 | 600000 | 如果idleTimeout+1秒>maxLifetime 且 maxLifetime>0,則會(huì)被重置為0(代表永遠(yuǎn)不會(huì)退出);如果idleTimeout!=0且小于10秒,則會(huì)被重置為10秒 |
maxLifetime | 池中連接最長(zhǎng)生命周期 | MINUTES.toMillis(30) = 1800000 | 1800000 | 如果不等于0且小于30秒則會(huì)被重置回30分鐘 |
connectionTestQuery | 如果您的驅(qū)動(dòng)程序支持JDBC4,我們強(qiáng)烈建議您不要設(shè)置此屬性 | null | null | – |
minimumIdle | 池中維護(hù)的最小空閑連接數(shù) | -1 | 10 | minIdle<0或者minIdle>maxPoolSize,則被重置為maxPoolSize |
maximumPoolSize | 池中最大連接數(shù),包括閑置和使用中的連接 | -1 | 10 | 如果maxPoolSize小于1,則會(huì)被重置。當(dāng)minIdle<=0被重置為DEFAULT_POOL_SIZE則為10;如果minIdle>0則重置為minIdle的值 |
metricRegistry | 該屬性允許您指定一個(gè) Codahale / Dropwizard MetricRegistry 的實(shí)例,供池使用以記錄各種指標(biāo) | null | null | – |
healthCheckRegistry | 該屬性允許您指定池使用的Codahale / Dropwizard HealthCheckRegistry的實(shí)例來報(bào)告當(dāng)前健康信息 | null | null | – |
poolName | 連接池的用戶定義名稱,主要出現(xiàn)在日志記錄和JMX管理控制臺(tái)中以識(shí)別池和池配置 | null | HikariPool-1 | – |
initializationFailTimeout | 如果池?zé)o法成功初始化連接,則此屬性控制池是否將 fail fast | 1 | 1 | – |
isolateInternalQueries | 是否在其自己的事務(wù)中隔離內(nèi)部池查詢,例如連接活動(dòng)測(cè)試 | FALSE | FALSE | – |
allowPoolSuspension | 控制池是否可以通過JMX暫停和恢復(fù) | FALSE | FALSE | – |
readOnly | 從池中獲取的連接是否默認(rèn)處于只讀模式 | FALSE | FALSE | – |
registerMbeans | 是否注冊(cè)JMX管理Bean(MBeans) | FALSE | FALSE | – |
catalog | 為支持 catalog 概念的數(shù)據(jù)庫設(shè)置默認(rèn) catalog | driver default | null | – |
connectionInitSql | 該屬性設(shè)置一個(gè)SQL語句,在將每個(gè)新連接創(chuàng)建后,將其添加到池中之前執(zhí)行該語句。 | null | null | – |
driverClassName | HikariCP將嘗試通過僅基于jdbcUrl的DriverManager解析驅(qū)動(dòng)程序,但對(duì)于一些較舊的驅(qū)動(dòng)程序,還必須指定driverClassName | null | null | – |
transactionIsolation | 控制從池返回的連接的默認(rèn)事務(wù)隔離級(jí)別 | null | null | – |
validationTimeout | 連接將被測(cè)試活動(dòng)的最大時(shí)間量 | SECONDS.toMillis(5) = 5000 | 5000 | 如果小于250毫秒,則會(huì)被重置回5秒 |
leakDetectionThreshold | 記錄消息之前連接可能離開池的時(shí)間量,表示可能的連接泄漏 | 0 | 0 | 如果大于0且不是單元測(cè)試,則進(jìn)一步判斷:(leakDetectionThreshold < SECONDS.toMillis(2) or (leakDetectionThreshold > maxLifetime && maxLifetime > 0),會(huì)被重置為0 . 即如果要生效則必須>0,而且不能小于2秒,而且當(dāng)maxLifetime > 0時(shí)不能大于maxLifetime |
dataSource | 這個(gè)屬性允許你直接設(shè)置數(shù)據(jù)源的實(shí)例被池包裝,而不是讓HikariCP通過反射來構(gòu)造它 | null | null | – |
schema | 該屬性為支持模式概念的數(shù)據(jù)庫設(shè)置默認(rèn)模式 | driver default | null | – |
threadFactory | 此屬性允許您設(shè)置將用于創(chuàng)建池使用的所有線程的java.util.concurrent.ThreadFactory的實(shí)例。 | null | null | – |
scheduledExecutor | 此屬性允許您設(shè)置將用于各種內(nèi)部計(jì)劃任務(wù)的java.util.concurrent.ScheduledExecutorService實(shí)例 | null | null | – |
#代碼示例
本文的相關(guān)例子可以查看下面?zhèn)}庫中的chapter3-2
目錄: