1. 使用方法
首先从http://repo1.maven.org/maven2/com/alibaba/druid/ 下载最新的jar包。如果想使用最新的源码编译，可以从https://github.com/alibaba/druid 下载源码，然后使用maven命令行，或者导入到eclipse中进行编译。
和dbcp类似，druid的配置项如下：
|
配置 |
缺省值 |
说明 |
|
name |
|
配置这个属性的意义在于，如果存在多个数据源，监控的时候 |
|
jdbcUrl |
|
连接数据库的url，不同数据库不一样。例如： |
|
username |
|
连接数据库的用户名 |
|
password |
|
连接数据库的密码。如果你不希望密码直接写在配置文件中， |
|
driverClassName |
根据url自动识别 |
这一项可配可不配，如果不配置druid会根据url自动识别dbType， |
|
initialSize |
0 |
初始化时建立物理连接的个数。初始化发生在显示调用init方法， |
|
maxActive |
8 |
最大连接池数量 |
|
maxIdle |
8 |
已经不再使用，配置了也没效果 |
|
minIdle |
|
最小连接池数量 |
|
maxWait |
|
获取连接时最大等待时间，单位毫秒。配置了maxWait之后， |
|
poolPreparedStatements |
false |
是否缓存preparedStatement，也就是PSCache。 |
|
maxOpenPreparedStatements |
-1 |
要启用PSCache，必须配置大于0，当大于0时， |
|
validationQuery |
|
用来检测连接是否有效的sql，要求是一个查询语句。 |
|
testOnBorrow |
true |
申请连接时执行validationQuery检测连接是否有效， |
|
testOnReturn |
false |
归还连接时执行validationQuery检测连接是否有效， |
|
testWhileIdle |
false |
建议配置为true，不影响性能，并且保证安全性。 |
|
timeBetweenEvictionRunsMillis |
|
有两个含义： |
|
numTestsPerEvictionRun |
|
不再使用，一个DruidDataSource只支持一个EvictionRun |
|
minEvictableIdleTimeMillis |
|
|
|
connectionInitSqls |
|
物理连接初始化的时候执行的sql |
|
exceptionSorter |
根据dbType自动识别 |
当数据库抛出一些不可恢复的异常时，抛弃连接 |
|
filters |
|
属性类型是字符串，通过别名的方式配置扩展插件， |
|
proxyFilters |
|
类型是List<com.alibaba.druid.filter.Filter>， |
表1.1 配置属性
根据常用的配置属性，首先给出一个如下的配置文件，放置于src目录下。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
url:jdbc:mysql://localhost:3306/dragoon_v25_masterdb driverClassName:com.mysql.jdbc.Drive username:root password:aaaaaaaa filters:stat maxActive:20initialSize:1maxWait:60000minIdle:10#maxIdle:15timeBetweenEvictionRunsMillis:60000minEvictableIdleTimeMillis:300000validationQuery:SELECT 'x'testWhileIdle:truetestOnBorrow:falsetestOnReturn:false#poolPreparedStatements:truemaxOpenPreparedStatements:20removeAbandoned:true #对于长时间不使用的连接强制关闭 removeAbandonedTimeout:1800 #超过30分钟开始关闭空闲连接 logAbandoned:true #将当前关闭动作记录到日志 |
配置文件
配置项中指定了各个参数后，在连接池内部是这么使用这些参数的。数据库连接池在初始化的时候会创建initialSize个连接，当有数据库操作时，会从池中取出一个连接。如果当前池中正在使用的连接数等于maxActive，则会等待一段时间，等待其他操作释放掉某一个连接，如果这个等待时间超过了maxWait，则会报错；如果当前正在使用的连接数没有达到maxActive，则判断当前是否空闲连接，如果有则直接使用空闲连接，如果没有则新建立一个连接。在连接使用完毕后，不是将其物理连接关闭，而是将其放入池中等待其他操作复用。 同时连接池内部有机制判断，如果当前的总的连接数少于miniIdle，则会建立新的空闲连接，以保证连接数得到miniIdle。如果当前连接池中某个连接在空闲了timeBetweenEvictionRunsMillis时间后任然没有使用，则被物理性的关闭掉。有些数据库连接的时候有超时限制（mysql连接在8小时后断开），或者由于网络中断等原因，连接池的连接会出现失效的情况，这时候设置一个testWhileIdle参数为true，可以保证连接池内部定时检测连接的可用性，不可用的连接会被抛弃或者重建，最大情况的保证从连接池中得到的Connection对象是可用的。当然，为了保证绝对的可用性，你也可以使用testOnBorrow为true（即在获取Connection对象时检测其可用性），不过这样会影响性能。
1、Spring中的配置
在applicationContext.xml文件中，配置如下：
|
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
|
<!-- 使用Druid连接池 --><bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource " init-method="init" destroy-method="close"> <!-- 基本属性 url、user、password --> <property name="url" value="jdbc:mysql://localhost:3306/test?zeroDateTimeBehavior=convertToNull " /> <property name="username" value="wlxu" /> <property name="password" value="wlxusstcd201403" /> <property name="connectionProperties" value="com.mysql.jdbc.Driver"></property> <!-- 配置初始化大小、最小、最大 --> <property name="initialSize" value="1" /> <property name="minIdle" value="1" /> <property name="maxActive" value="20" /> <!-- 配置获取连接等待超时的时间 --> <property name="maxWait" value="60000" /> <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 --> <property name="timeBetweenEvictionRunsMillis" value="60000" /> <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 --> <property name="minEvictableIdleTimeMillis" value="300000" /> <property name="validationQuery" value="SELECT 'x'" /> <property name="testWhileIdle" value="true" /> <property name="testOnBorrow" value="false" /> <property name="testOnReturn" value="false" /> <!-- 打开PSCache，并且指定每个连接上PSCache的大小 --><!-- 如果用Oracle，则把poolPreparedStatements配置为true，mysql可以配置为false。分库分表较多的数据库，建议配置为false。 --> <property name="poolPreparedStatements" value="false" /> <property name="maxPoolPreparedStatementPerConnectionSize" value="20" /> <!-- 配置监控统计拦截的filters，去掉后监控界面sql无法统计 --> <property name="filters" value="stat" /> </bean> |
2、手动创建datasource
如果不使用框架开发，也可以手动创建连接，采用new DruidDataSource ()或者DruidDataSourceFactory .createDataSource(properties)的方式均可，前者需要手动设置参数值，后者自动从配置文件中读取，可根据需要使用。
2. 使用Druid的内置监控功能
1、怎么打开Druid的监控统计功能
Druid的监控统计功能是通过filter-chain扩展实现，如果你要打开监控统计功能，配置StatFilter ，StatFilter 的别名是stat，这个别名映射配置信息保存在druid-xxx.jar!/META-INF/druid-filter.properties。 在spring中使用别名配置方式如下：
|
1
2
3
4
|
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">... ... <property name="filters" value="stat" /></bean> |
StatFilter 可以和其他的Filter配置使用，比如：
|
1
2
3
4
|
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">... ... <property name="filters" value="stat,log4j" /></bean> |
其他详情可以参考：https://github.com/alibaba/druid/wiki/%E9%85%8D%E7%BD%AE_StatFilter
2、怎样使用Druid的内置监控页面
Druid内置提供了一个StatViewServlet 用于展示Druid的统计信息。 这个StatViewServlet 的用途包括：
提供监控信息展示的html页面 提供监控信息的JSON API
注意：使用StatViewServlet ，建议使用druid 0.2.6以上版本。
1） 配置web.xml
StatViewServlet 是一个标准的javax.servlet.http.HttpServlet ，需要配置在你web应用中的WEB-INF/web.xml中
|
1
2
3
4
5
6
7
|
<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> |
根据配置中的url-pattern来访问内置监控页面，如果是上面的配置，内置监控页面的首页是/druid/index.html
例如：http://110.76.43.235:9000/druid/index.html ，http://110.76.43.235:8080/mini-web/druid/index.html
2） 配置allow和deny
StatViewSerlvet 展示出来的监控信息比较敏感，是系统运行的内部情况，如果你需要做访问控制，可以配置allow和deny这两个参数。比如：
|
1
2
3
4
5
6
7
8
9
10
11
|
<servlet><servlet-name>DruidStatView </servlet-name> <servlet-class>com.alibaba.druid.support.http.StatViewServlet </servlet-class><init-param><param-name>allow</param-name> <param-value>128.242.127.1/24,128.242.128.1</param-value></init-param> <init-param><param-name>deny</param-name> <param-value>128.242.127.4</param-value></init-param></servlet> |
判断规则：deny优先于allow，如果在deny列表中，就算在allow列表中，也会被拒绝。如果allow没有配置或者为空，则允许所有访问 其他详情参考：https://github.com/alibaba/druid/wiki/%E9%85%8D%E7%BD%AE_StatViewServlet%E9%85%8D%E7%BD%AE
3、内置监控中的Web和Spring关联监控怎么配置？
WebStatFilter 用于采集web-jdbc关联监控的数据。
1）web.xml配置
|
1
2
3
4
5
6
7
8
9
10
|
<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> |
2）exlusions配置
经常需要排除一些不必要的url，比如.js,/jslib/等等。配置在init-param中。比如：
|
1
2
3
4
|
<init-param> <param-name>exclusions</param-name> <param-value>*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*</param-value> </init-param> |
3）sessionStatMaxCount配置
缺省sessionStatMaxCount是1000个。你可以按需要进行配置，比如：
|
1
2
3
4
|
<init-param> <param-name>sessionStatMaxCount</param-name> <param-value>1000</param-value> </init-param> |
4）sessionStatEnable配置
你可以关闭session统计功能，比如：
|
1
2
3
4
|
<init-param> <param-name>sessionStatEnable</param-name> <param-value>false</param-value> </init-param> |
5）principalSessionName配置
你可以配置principalSessionName，使得druid能够知道当前的session的用户是谁。比如：
|
1
2
3
4
|
<init-param> <param-name>principalSessionName</param-name> <param-value>xxx.user</param-value> </init-param> |
根据需要，把其中的xxx.user修改为你user信息保存在session中的sessionName。
注意：如果你session中保存的是非string类型的对象，需要重载toString方法。
6）principalCookieName
如果你的user信息保存在cookie中，你可以配置principalCookieName，使得druid知道当前的user是谁
|
1
2
3
4
|
<init-param> <param-name>principalCookieName</param-name> <param-value>xxx.user</param-value> </init-param> |
根据需要，把其中的xxx.user修改为你user信息保存在cookie中的cookieName
7）profileEnable
druid 0.2.7版本开始支持profile，配置profileEnable能够监控单个url调用的sql列表。
|
1
2
3
4
|
<init-param> <param-name>profileEnable</param-name> <param-value>true</param-value> </init-param> |
