配置
| 配置 | 缺省值 | 说明 |
|---|---|---|
| name | - | 配置这个属性的意义在于，如果存在多个数据源，监控时可以通过名字来区分开来 。 如果没有配置，将会生成一个名字，格式是： "DataSource-" + System.identityHashCode(this) . 另外配置此属性至少在 1.0.5 版本中是不起作用的，强行设置 name 会出错 。 |
| url | - | 连接数据库的url |
| username | - | 连接数据库的用户名 |
| password | - | 连接数据库的密码 |
| 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<com.alibaba.druid.filter.Filter>，如果同时配置了 filters 和 proxyFilters ，是组合关系，并非替换关系。 |
| asyncInit | false（1.1.4+） | 如果 initialSize 数量较多时，打开会加快应用启动时间。 |
| useUnfairLock | false | 是否使用非公平锁。需要平衡锁的公平和效率的关系。在连接不够用，发生争用时， unfair 模式的 ReentrantLock.tryLock 方法会存在严重不公的现象，个别线程会等到超时了还获取不到连接 。 0.2.8+ 能够兼顾性能和公平性。 |
参考文献
- Druid配置
