一、背景
java程式很大一部分要運算元據庫,為了提高效能運算元據庫的時候,又不得不使用資料庫連線池。資料庫連線池有很多選擇,c3p、dhcp、proxool等,druid作為一名後起之秀,憑藉其出色的效能,也逐漸映入了大家的眼簾。接下來本教程就說一下druid的簡單使用。
二、jar包下載、配置詳解及配置示例
1. jar包獲取
- 可以從 http://repo1.maven.org/maven2/com/alibaba/druid/ 下載最新的jar包。
- 如果想使用最新的原始碼編譯,也可以從 https://github.com/alibaba/druid 下載原始碼,然後使用maven命令列,或者匯入到IDEA中進行編譯獲得。
- 從maven的倉庫中獲取
<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.6</version> </dependency>
2. 配置示例
spring.xml檔案中加入:
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd"> <bean name = "transactionManager"
class ="org.springframework.jdbc.datasource.DataSourceTransactionManager" > <property name = "dataSource" ref = "dataSource" ></ property > </bean > <bean id = "propertyConfigurer"
class ="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer" > <property name = "locations" > <list> <value > /WEB-INF/classes/dbconfig.properties </ value > </list> </property> </bean> <!-- 阿里 druid 資料庫連線池 --> <bean id = "dataSource" class = "com.alibaba.druid.pool.DruidDataSource" destroy-method = "close" > <!-- 資料庫基本資訊配置 --> <property name = "url" value = "${jdbc.url}" /> <property name = "username" value = "${jdbc.username}" /> <property name = "password" value = "${jdbc.password}" /> <property name = "driverClassName" value = "${jdbc.driverClassName}" /> <property name = "filters" value = "${jdbc.filters}" /> <!-- 最大併發連線數 --> <property name = "maxActive" value = "${jdbc.maxActive}" /> <!-- 初始化連線數量 --> <property name = "initialSize" value = "${jdbc.initialSize}" /> <!-- 配置獲取連線等待超時的時間 --> <property name = "maxWait" value = "${jdbc.maxWait}" /> <!-- 最小空閒連線數 --> <property name = "minIdle" value = "${jdbc.minIdle}" /> <!-- 配置間隔多久才進行一次檢測,檢測需要關閉的空閒連線,單位是毫秒 --> <property name = "timeBetweenEvictionRunsMillis" value ="${jdbc.timeBetweenEvictionRunsMillis}" /> <!-- 配置一個連線在池中最小生存的時間,單位是毫秒 --> <property name = "minEvictableIdleTimeMillis" value ="${jdbc.minEvictableIdleTimeMillis}" /> <property name = "validationQuery" value = "${jdbc.validationQuery}" /> <property name = "testWhileIdle" value = "${jdbc.testWhileIdle}" /> <property name = "testOnBorrow" value = "${jdbc.testOnBorrow}" /> <property name = "testOnReturn" value = "${jdbc.testOnReturn}" /> <property name = "maxOpenPreparedStatements" value ="${jdbc.maxOpenPreparedStatements}" /> <!-- 開啟 removeAbandoned 功能 --> <property name = "removeAbandoned" value = "${jdbc.removeAbandoned}" /> <!-- 1800 秒,也就是 30 分鐘 --> <property name = "removeAbandonedTimeout" value ="${jdbc.removeAbandonedTimeout}" /> <!-- 關閉 abanded 連線時輸出錯誤日誌 --> <property name = "logAbandoned" value = "${jdbc.logAbandoned}" /> </bean> </beans>
dbconfig.properties
jdbc.url=jdbc:mysql://localhost:3306/newm jdbc.driverClassName=com.mysql.jdbc.Driver jdbc.username=root jdbc.password=root jdbc.filters=stat jdbc.maxActive=20 jdbc.initialSize=1 jdbc.maxWait=60000 jdbc.minIdle=10 jdbc.maxIdle=15 jdbc.timeBetweenEvictionRunsMillis=60000 jdbc.minEvictableIdleTimeMillis=300000 jdbc.validationQuery=SELECT 'x' jdbc.testWhileIdle=true jdbc.testOnBorrow=false jdbc.testOnReturn=false jdbc.maxOpenPreparedStatements=20 jdbc.removeAbandoned=true jdbc.removeAbandonedTimeout=1800 jdbc.logAbandoned=true
web.xml
<!-- 連線池 啟用 Web 監控統計功能 start--> <filter> <filter-name>DruidWebStatFilter</filter-name> <filter-class>com.alibaba.druid.support.http.WebStatFilter</filter-class> <init-param> <param-name>exclusions</param-name> <param-value>*.js ,*.gif ,*.jpg ,*.png ,*.css ,*.ico ,/druid/*</param-value> </init-param> </filter> <filter-mapping> <filter-name>DruidWebStatFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <servlet> <servlet-name>DruidStatView</servlet-name> <servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>DruidStatView</servlet-name> <url-pattern>/druid/*</url-pattern> </servlet-mapping> <!-- 連線池 啟用 Web 監控統計功能 end-->
訪問監控頁面: http://ip:port/projectName/druid/index.html.
3.druid的配置項詳解
配置 | 預設值 | 說明 |
name | 無 | 配置這個屬性的意義在於,如果存在多個資料來源,監控的時候 可以通過名字來區分開來。如果沒有配置,將會生成一個名字, 格式是:"DataSource-" + System.identityHashCode(this) |
jdbcUrl | 無 | 連線資料庫的url,不同資料庫不一樣。例如: mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto |
username | 無 | 連線資料庫的使用者名稱 |
password | 無 | 連線資料庫的密碼。如果你不希望密碼直接寫在配置檔案中, 可以使用ConfigFilter。詳細看這裡: https://github.com/alibaba/druid/wiki/%E4%BD%BF%E7%94%A8ConfigFilter |
driverClassName | 根據url自動識別 | 這一項可配可不配,如果不配置druid會根據url自動識別dbType,然後選擇相應的driverClassName |
initialSize | 0 | 初始化時建立物理連線的個數。初始化發生在顯示呼叫init方法,或者第一次getConnection時 |
maxActive | 8 | 最大連線池數量 |
maxIdle | 8 | 已經不再使用,配置了也沒效果 |
minIdle | 無 | 最小連線池數量 |
maxWait | 無 | 獲取連線時最大等待時間,單位毫秒。配置了maxWait之後, 預設啟用公平鎖,併發效率會有所下降, 如果需要可以通過配置useUnfairLock屬性為true使用非公平鎖。 |
poolPreparedStatements | false | 是否快取preparedStatement,也就是PSCache。 PSCache對支援遊標的資料庫效能提升巨大,比如說oracle。 在mysql5.5以下的版本中沒有PSCache功能,建議關閉掉。 作者在5.5版本中使用PSCache,通過監控介面發現PSCache有快取命中率記錄, 該應該是支援PSCache。 |
maxOpenPreparedStatements | -1 | 要啟用PSCache,必須配置大於0,當大於0時, poolPreparedStatements自動觸發修改為true。 在Druid中,不會存在Oracle下PSCache佔用記憶體過多的問題, 可以把這個數值配置大一些,比如說100 |
validationQuery | 用來檢測連線是否有效的sql,要求是一個查詢語句。 如果validationQuery為null,testOnBorrow、testOnReturn、 testWhileIdle都不會其作用。 |
|
testOnBorrow | true | 申請連線時執行validationQuery檢測連線是否有效,做了這個配置會降低效能。 |
testOnReturn | false | 歸還連線時執行validationQuery檢測連線是否有效,做了這個配置會降低效能 |
testWhileIdle | false | 建議配置為true,不影響效能,並且保證安全性。 申請連線的時候檢測,如果空閒時間大於 timeBetweenEvictionRunsMillis, 執行validationQuery檢測連線是否有效。 |
timeBetweenEvictionRunsMillis | 無 | 有兩個含義: 1) Destroy執行緒會檢測連線的間隔時間 2) testWhileIdle的判斷依據,詳細看testWhileIdle屬性的說明 |
numTestsPerEvictionRun | 無 | 不再使用,一個DruidDataSource只支援一個EvictionRun |
minEvictableIdleTimeMillis | 無 | 一個連線在池中最小的生存時間,單位是毫秒 |
connectionInitSqls | 無 | 物理連線初始化的時候執行的sql |
exceptionSorter | 根據dbType自動識別 | 當資料庫丟擲一些不可恢復的異常時,拋棄連線 |
filters | 無 | 屬性型別是字串,通過別名的方式配置擴充套件外掛, 常用的外掛有: 監控統計用的filter:stat 日誌用的filter:log4j 防禦sql注入的filter:wall |
proxyFilters | 無 | 型別是List<com.alibaba.druid.filter.Filter>, 如果同時配置了filters和proxyFilters, 是組合關係,並非替換關係 |