说说如何配置 Druid 连接池的 DataSource 参数

1 参数说明

本段摘录自官网，做了格式化处理。

DruidDataSource 配置兼容 DBCP ，但个别配置的语意有所区别 。

配置	缺省值	说明
name	-	配置这个属性的意义在于，如果存在多个数据源，监控时可以通过名字来区分开来 。 如果没有配置，将会生成一个名字，格式是： "DataSource-" + System.identityHashCode(this) . 另外配置此属性至少在 1.0.5 版本中是不起作用的，强行设置 name 会出错 。 详情-点此处。
url	-	连接数据库的url，不同数据库不一样。例如：mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto
username	-	连接数据库的用户名
password	-	连接数据库的密码。如果你不希望密码直接写在配置文件中，可以使用ConfigFilter。详细看这里
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。 在 mysql 下建议关闭 。
maxPoolPreparedStatementPerConnectionSize	-1	要启用 PSCache ，必须配置大于 0 ，当大于 0 时， poolPreparedStatements 自动触发修改为 true。 在 Druid 中，不会存在 Oracle 下 PSCache 占用内存过多的问题，可以把这个数值配置大一些，比如说 100 。
validationQuery	-	用来检测连接是否有效的 sql ，要求是一个查询语句，常用 select 'x'。 如果 validationQuery 为 null ， testOnBorrow、testOnReturn、testWhileIdle 都不会起作用 。
validationQueryTimeout	-	单位：秒，检测连接是否有效的超时时间 。 底层调用 jdbc Statement 对象的 void setQueryTimeout(int seconds) 方法。
testOnBorrow	true	申请连接时执行 validationQuery 检测连接是否有效，做了这个配置会降低性能 。
testOnReturn	false	归还连接时执行 validationQuery 检测连接是否有效，做了这个配置会降低性能 。
testWhileIdle	false	建议配置为 true ，不影响性能，并且保证安全性 。 申请连接时检测，如果空闲时间大于 timeBetweenEvictionRunsMillis ，执行 validationQuery 检测连接是否有效 。
keepAlive	false(1.0.28+)	连接池中的 minIdle 数量以内的连接，空闲时间超过 minEvictableIdleTimeMillis ，则会执行 keepAlive 操作 。
timeBetweenEvictionRunsMillis	1分钟（1.0.14+）	有两个含义： 1) Destroy 线程会检测连接的间隔时间，如果连接空闲时间大于等于 minEvictableIdleTimeMillis 则关闭物理连接 。 2) testWhileIdle 的判断依据，详细看 testWhileIdle 属性的说明。
numTestsPerEvictionRun	30分钟（1.0.14+）	不再使用，一个 DruidDataSource 只支持一个 EvictionRun 。
minEvictableIdleTimeMillis	-	连接保持空闲而不被驱逐的最小时间。
connectionInitSqls	-	物理连接初始化时执行的 sql 。
exceptionSorter	根据 dbType 自动识别	当数据库抛出一些不可恢复的异常时，抛弃连接。
filters	-	属性类型是字符串，通过别名的方式配置扩展插件，常用的插件有： 监控统计用的 filter:stat 日志用的 filter:log4j 防御 sql 注入的 filter:wall 。
proxyFilters	-	类型是 List ，如果同时配置了 filters 和 proxyFilters ，是组合关系，并非替换关系。
asyncInit	false（1.1.4+）	如果 initialSize 数量较多时，打开会加快应用启动时间。
useUnfairLock	false	是否使用非公平锁。需要平衡锁的公平和效率的关系。在连接不够用，发生争用时， unfair 模式的 ReentrantLock.tryLock 方法会存在严重不公的现象，个别线程会等到超时了还获取不到连接 。 0.2.8+ 能够兼顾性能和公平性。

备注： asyncInit 属性、useUnfairLock 属性，官网遗漏了，这里补上。

2 官网推荐配置

注意： 原来的官网配置有误，在 v1.1.9 中，没有 maxOpenPreparedStatements 属性，这里既然打开了 缓存 preparedStatement 开关，自然是需要配置缓存 preparedStatement 的数量。

这份配置，关键有以下几点：

1. 开启了 testWhileIdle，申请连接时，如果池中的这个连接，空闲时间大于 1 分钟，则检测连接是否有效。空闲时间指的是，这个连接在这段时间内，没有请求操作。
2. 配置了 maxWait，获取连接时，最大等待时间为 1 分钟。默认使用公平锁，并发效率会有所下降。
3. 开启了 poolPreparedStatements 开关，即缓存了 20 个 preparedStatement 。有的老项目，会抛出 “对象不使用请求的接口包装任何内容”，可惜了这个功能。