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.url:jdbc:mysql://localhost:3306/dragoon_v25_masterdb
2.driverClassName:com.mysql.jdbc.Driver
3.username:root
4.password:aaaaaaaa
5.filters:stat
6.maxActive:20
7.initialSize:1
8.maxWait:60000
9.minIdle:10
10.#maxIdle:15
11.timeBetweenEvictionRunsMillis:60000
12.minEvictableIdleTimeMillis:300000
13.validationQuery:SELECT'x'
14.testWhileIdle:true
15.testOnBorrow:false
16.testOnReturn:false
17.#poolPreparedStatements:true
18.maxOpenPreparedStatements:20
19.#对于长时间不使用的连接强制关闭
20.removeAbandoned:true
21.#超过30分钟开始关闭空闲连接
22.removeAbandonedTimeout:1800
23.#将当前关闭动作记录到日志
24.logAbandoned:true
配置文件1.1
配置项中指定了各个参数后,在连接池内部是这么使用这些参数的。数据库连接池在初始化的时候会创建initialSize个连接,当有数据库操作时,会从池中取出一个连接。如果当前池中正在使用的连接数等于maxActive,则会等待一段时间,等待其他操作释放掉某一个连接,如果这个等待时间超过了maxWait,则会报错;如果当前正在使用的连接数没有达到maxActive,则判断当前是否空闲连接,如果有则直接使用空闲连接,如果没有则新建立一个连接。在连接使用完毕后,不是将其物理连接关闭,而是将其放入池中等待其他操作复用。同时连接池内部有机制判断,如果当前的总的连接数少于miniIdle,则会建立新的空闲连接,以保证连接数得到miniIdle。如果当前连接池中某个连接在空闲了timeBetweenEvictionRunsMillis时间后任然没有使用,则被物理性的关闭掉。有些数据库连接的时候有超时限制(mysql连接在8小时后断开),或者由于网络中断等原因,连接池的连接会出现失效的情况,这时候设置一个testWhileIdle参数为true,可以保证连接池内部定时检测连接的可用性,不可用的连接会被抛弃或者重建,最大情况的保证从连接池中得到的Connection对象是可用的。当然,为了保证绝对的可用性,你也可以使用testOnBorrow为true(即在获取Connection对象时检测其可用性),不过这样会影响性能。
1、Spring中的配置
在applicationContext.xml文件中,配置如下:<!-- 使用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" />
<propertyname="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。 --> <propertyname="poolPreparedStatements" value="false" /><property name="maxPoolPreparedStatementPerConnectionSize"value="20" />
<!-- 配置监控统计拦截的filters,去掉后监控界面sql无法统计 --> <property name="filters" value="stat"/>
</bean>
2、手动创建datasource
如果不使用框架开发,也可以手动创建连接,采用newDruidDataSource()或者DruidDataSourceFactory.createDataSource(properties)的方式均可,前者需要手动设置参数值,后者自动从配置文件中读取,可根据需要使用。
以上内容可以参考:http://blog.csdn.net/yunnysunny/article/details/8657095
2.使用Druid的内置监控功能
1、怎么打开Druid的监控统计功能
Druid的监控统计功能是通过filter-chain扩展实现,如果你要打开监控统计功能,配置StatFilter,StatFilter的别名是stat,这个别名映射配置信息保存在druid-xxx.jar!/META-INF/druid-filter.properties。在spring中使用别名配置方式如下:
<beanid="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init"destroy-method="close">
... ...<property name="filters" value="stat" />
</bean>
StatFilter可以和其他的Filter配置使用,比如:
<beanid="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页面 提供监控信息的JSONAPI
注意:使用StatViewServlet,建议使用druid 0.2.6以上版本。
1)配置web.xml
StatViewServlet是一个标准的javax.servlet.http.HttpServlet,需要配置在你web应用中的WEB-INF/web.xml中。
<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这两个参数。比如:
<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配置<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>2)exlusions配置
经常需要排除一些不必要的url,比如.js,/jslib/等等。配置在init-param中。比如:<init-param>
<param-name>exclusions</param-name><param-value>*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*</param-value>
</init-param>
3)sessionStatMaxCount配置
缺省sessionStatMaxCount是1000个。你可以按需要进行配置,比如: <init-param>
<param-name>sessionStatMaxCount</param-name><param-value>1000</param-value>
</init-param>
4)sessionStatEnable配置
你可以关闭session统计功能,比如:
<init-param>
<param-name>sessionStatEnable</param-name><param-value>false</param-value>
</init-param>
5)principalSessionName配置
你可以配置principalSessionName,使得druid能够知道当前的session的用户是谁。比如:
<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是谁
<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列表。
<init-param>
<param-name>profileEnable</param-name><param-value>true</param-value>
</init-param>
Druid的其他相关问题可以查看:https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98