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<com.alibaba.druid.filter.Filter> ，如果同时配置了 filters 和 proxyFilters ，是组合关系，并非替换关系。 |
| asyncInit | false（1.1.4+） | 如果 initialSize 数量较多时，打开会加快应用启动时间。 |
| useUnfairLock | false | 是否使用非公平锁。需要平衡锁的公平和效率的关系。在连接不够用，发生争用时， unfair 模式的 ReentrantLock.tryLock 方法会存在严重不公的现象，个别线程会等到超时了还获取不到连接 。 0.2.8+ 能够兼顾性能和公平性。 |
备注： asyncInit 属性、useUnfairLock 属性，官网遗漏了，这里补上。
2 官网推荐配置
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
<property name="url" value="${jdbc_url}" />
<property name="username" value="${jdbc_user}" />
<property name="password" value="${jdbc_password}" />
<property name="filters" value="stat" />
<property name="maxActive" value="20" />
<property name="initialSize" value="1" />
<property name="maxWait" value="60000" />
<property name="minIdle" value="1" />
<property name="timeBetweenEvictionRunsMillis" value="60000" />
<property name="minEvictableIdleTimeMillis" value="300000" />
<property name="testWhileIdle" value="true" />
<property name="testOnBorrow" value="false" />
<property name="testOnReturn" value="false" />
<property name="poolPreparedStatements" value="true" />
<property name="maxPoolPreparedStatementPerConnectionSize" value="20" />
<property name="asyncInit" value="true" />
</bean>
注意： 原来的官网配置有误，在 v1.1.9 中，没有 maxOpenPreparedStatements 属性，这里既然打开了 缓存 preparedStatement 开关，自然是需要配置缓存 preparedStatement 的数量。
这份配置，关键有以下几点：
- 开启了 testWhileIdle，申请连接时，如果池中的这个连接，空闲时间大于 1 分钟，则检测连接是否有效。空闲时间指的是，这个连接在这段时间内，没有请求操作。
- 配置了 maxWait，获取连接时，最大等待时间为 1 分钟。默认使用公平锁，并发效率会有所下降。
- 开启了 poolPreparedStatements 开关，即缓存了 20 个 preparedStatement 。有的老项目，会抛出 “对象不使用请求的接口包装任何内容”，可惜了这个功能。
网友评论