druid连接池配置

阿里巴巴推出的国产数据库连接池，据网上测试对比，比目前的DBCP或C3P0数据库连接池性能更好，Druid与其他数据库连接池使用方法基本一样（与DBCP非常相似），将数据库的连接信息全部配置给DataSource对象。

 基于纯Java代码使用：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

package  demo.test;   import  java.io.InputStream; import  java.sql.Connection; import  java.sql.SQLException; import  java.util.Properties;   import  javax.sql.DataSource;   import  com.alibaba.druid.pool.DruidDataSourceFactory;     public  class  DBUtil {        private  static  DataSource ds =  null ;              static  {          try {              InputStream in = DBUtil. class .getClassLoader()                                     .getResourceAsStream( "ds.properties" );              Properties props =  new  Properties();              props.load(in);              ds = DruidDataSourceFactory.createDataSource(props);          } catch (Exception ex){              ex.printStackTrace();          }      }            public  static  Connection openConnection()  throws  SQLException{          return  ds.getConnection();      }         }

 ds.properties内容：　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

driverClassName = oracle.jdbc.driver.OracleDriver url = jdbc:oracle:thin: @127 .0. 0.1 : 1521 :ORCL username = ****** password = ******   initialSize =  5 maxActive =  10 minIdle =  3 maxWait =  60000 removeAbandoned =  true removeAbandonedTimeout =  180 timeBetweenEvictionRunsMillis =  60000 minEvictableIdleTimeMillis =  300000 validationQuery = SELECT  1  FROM DUAL testWhileIdle =  true  testOnBorrow =  false testOnReturn =  false poolPreparedStatements =  true maxPoolPreparedStatementPerConnectionSize =  50 filters = stat

　基于Spring的配置：　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42

< bean  id = "druidDataSource"  class = "com.alibaba.druid.pool.DruidDataSource"          init-method = "init"  destroy-method = "close" >          <!-- 数据库基本信息配置 -->          < property  name = "driverClassName"  value = "${oracle.driver}"  />          < property  name = "url"  value = "${oracle.url}"  />          < property  name = "username"  value = "${oracle.username}"  />          < property  name = "password"  value = "${oracle.password}"  />                 <!-- 初始化连接数量 -->          < property  name = "initialSize"  value = "${druid.initialSize}"  />          <!-- 最大并发连接数 -->          < property  name = "maxActive"  value = "${druid.maxActive}"  />          <!-- 最大空闲连接数 -->          < property  name = "maxIdle"  value = "${druid.maxIdle}"  />          <!-- 最小空闲连接数 -->          < property  name = "minIdle"  value = "${druid.minIdle}"  />          <!-- 配置获取连接等待超时的时间 -->               < property  name = "maxWait"  value = "${druid.maxWait}"  />          <!-- 超过时间限制是否回收 -->          < property  name = "removeAbandoned"  value = "${druid.removeAbandoned}"  />          <!-- 超过时间限制多长； -->          < property  name = "removeAbandonedTimeout"  value = "${druid.removeAbandonedTimeout}"  />          <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->          < property  name = "timeBetweenEvictionRunsMillis"  value = "${druid.timeBetweenEvictionRunsMillis}"  />          <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->          < property  name = "minEvictableIdleTimeMillis"  value = "${druid.minEvictableIdleTimeMillis}"  />          <!-- 用来检测连接是否有效的sql，要求是一个查询语句-->          < property  name = "validationQuery"  value = "${druid.validationQuery}"  />          <!-- 申请连接的时候检测 -->          < property  name = "testWhileIdle"  value = "${druid.testWhileIdle}"  />          <!-- 申请连接时执行validationQuery检测连接是否有效，配置为true会降低性能 -->          < property  name = "testOnBorrow"  value = "${druid.testOnBorrow}"  />          <!-- 归还连接时执行validationQuery检测连接是否有效，配置为true会降低性能  -->          < property  name = "testOnReturn"  value = "${druid.testOnReturn}"  />          <!-- 打开PSCache，并且指定每个连接上PSCache的大小 -->          < property  name = "poolPreparedStatements"  value = "${druid.poolPreparedStatements}"  />              < property  name = "maxPoolPreparedStatementPerConnectionSize"  value = "${druid.maxPoolPreparedStatementPerConnectionSize}"  />          <!--属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有：                                  监控统计用的filter:stat                  日志用的filter:log4j                 防御SQL注入的filter:wall -->          < property  name = "filters"  value = "${druid.filters}"  />            </ bean >

　启用Web监控统计功能需要在Web应用的web.xml中加入以下内容：　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

< 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 >

 访问监控页面：http://ip：port/projectName/druid/index.html

1 配置

和dbcp类似，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， 是组合关系，并非替换关系

表1.1 配置属性

根据常用的配置属性，首先给出一个如下的配置文件，放置于src目录下。

[plain]  view plain copy

1. url:jdbc:mysql://localhost:3306/dragoon_v25_masterdb  
2. driverClassName:com.mysql.jdbc.Driver  
3. username:root  
4. password:aaaaaaaa  
5.        
6. filters:stat  
7.    
8. maxActive:20  
9. initialSize:1  
10. maxWait:60000  
11. minIdle:10  
12. #maxIdle:15  
13.    
14. timeBetweenEvictionRunsMillis:60000  
15. minEvictableIdleTimeMillis:300000  
16.    
17. validationQuery:SELECT 'x'  
18. testWhileIdle:true  
19. testOnBorrow:false  
20. testOnReturn:false  
21. #poolPreparedStatements:true  
22. maxOpenPreparedStatements:20  
23.   
24. #对于长时间不使用的连接强制关闭  
25. removeAbandoned:true  
26. #超过30分钟开始关闭空闲连接  
27. removeAbandonedTimeout:1800  
28. #将当前关闭动作记录到日志  
29. logAbandoned:true  

配置文件1.1 

配置项中指定了各个参数后，在连接池内部是这么使用这些参数的。数据库连接池在初始化的时候会创建initialSize个连接，当有数据库操作时，会从池中取出一个连接。如果当前池中正在使用的连接数等于maxActive，则会等待一段时间，等待其他操作释放掉某一个连接，如果这个等待时间超过了maxWait，则会报错；如果当前正在使用的连接数没有达到maxActive，则判断当前是否空闲连接，如果有则直接使用空闲连接，如果没有则新建立一个连接。在连接使用完毕后，不是将其物理连接关闭，而是将其放入池中等待其他操作复用。

同时连接池内部有机制判断，如果当前的总的连接数少于miniIdle，则会建立新的空闲连接，以保证连接数得到miniIdle。如果当前连接池中某个连接在空闲了timeBetweenEvictionRunsMillis时间后任然没有使用，则被物理性的关闭掉。有些数据库连接的时候有超时限制（mysql连接在8小时后断开），或者由于网络中断等原因，连接池的连接会出现失效的情况，这时候设置一个testWhileIdle参数为true，可以保证连接池内部定时检测连接的可用性，不可用的连接会被抛弃或者重建，最大情况的保证从连接池中得到的Connection对象是可用的。当然，为了保证绝对的可用性，你也可以使用testOnBorrow为true（即在获取Connection对象时检测其可用性），不过这样会影响性能。