Re手册-工具篇 - Druid连接池

1. 开启配置

大学里刚学数据库的时候，都是通过JDBC来手动创建一个数据连接，执行完sql后再手动关闭。而工作中，都在用连接池来管理数据连接。连接池是创建和管理一个连接的缓冲池的技术，这些连接准备好被任何需要它们的线程使用。

Druid连接池是阿里巴巴开源的数据库连接池项目。Druid连接池为监控而生，内置强大的监控功能，监控特性不影响性能。功能强大，能防SQL注入，内置Loging能诊断Hack应用行为。

spring boot2.x 默认的连接池是HikariCP，HikariCP的特点是快，它的处理数据源连接的速度和性能在世界上遥遥领先。但在实际项目中，连接池的处理速度并不是后端的瓶颈，况且Druid并不比HikariCP慢多少。而我更看重Druid丰富的功能，尤其是在监控方面。

在服务器架构转为微服务之后，我最怀念WebLogic服务器的功能，就是控制台页面上的数据源监控模块，因为通过监控模式上数据源的连接数，经常能反映出很多问题。而Druid同样内嵌的监控页面，它的监控级别和扩展功能，远远高于WebLogic服务器所能达到的。话不多说，马上开始使用吧。

pom.xml

首先是导入druid的starter包

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.1.10</version>
        </dependency>

application.properties

JDBC配置

spring.datasource.druid.url= # 或spring.datasource.url= 
spring.datasource.druid.username= # 或spring.datasource.username=
spring.datasource.druid.password= # 或spring.datasource.password=
spring.datasource.druid.driver-class-name= #或 spring.datasource.driver-class-name=

连接池配置

spring.datasource.druid.initial-size=
spring.datasource.druid.max-active=
spring.datasource.druid.min-idle=
spring.datasource.druid.max-wait=
spring.datasource.druid.pool-prepared-statements=
spring.datasource.druid.max-pool-prepared-statement-per-connection-size= 
spring.datasource.druid.max-open-prepared-statements= #和上面的等价
spring.datasource.druid.validation-query=
spring.datasource.druid.validation-query-timeout=
spring.datasource.druid.test-on-borrow=
spring.datasource.druid.test-on-return=
spring.datasource.druid.test-while-idle=
spring.datasource.druid.time-between-eviction-runs-millis=
spring.datasource.druid.min-evictable-idle-time-millis=
spring.datasource.druid.max-evictable-idle-time-millis=
spring.datasource.druid.filters= #配置多个英文逗号分隔
....//more

关于配置文件参数的说明如下

配置	缺省值	说明
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，是组合关系，并非替换关系

OK！只需要这两步配置，当前spring boot 项目的连接池，就从默认的HikariCP换成了Druid了。

2. 页面监控

开启监控，只需要基于之前的配置文件基础，增加下面的配置：

# WebStatFilter配置
spring.datasource.druid.web-stat-filter.enabled= 
spring.datasource.druid.web-stat-filter.url-pattern=
spring.datasource.druid.web-stat-filter.exclusions=
spring.datasource.druid.web-stat-filter.session-stat-enable=
spring.datasource.druid.web-stat-filter.session-stat-max-count=
spring.datasource.druid.web-stat-filter.principal-session-name=
spring.datasource.druid.web-stat-filter.principal-cookie-name=
spring.datasource.druid.web-stat-filter.profile-enable=

# StatViewServlet配置
spring.datasource.druid.stat-view-servlet.enabled=
spring.datasource.druid.stat-view-servlet.url-pattern=
spring.datasource.druid.stat-view-servlet.reset-enable=
spring.datasource.druid.stat-view-servlet.login-username=
spring.datasource.druid.stat-view-servlet.login-password=
spring.datasource.druid.stat-view-servlet.allow=
spring.datasource.druid.stat-view-servlet.deny=

# Spring监控配置
spring.datasource.druid.aop-patterns= 

配置	缺省值	说明
web-stat-filter.enabled	false	是否启用StatFilter
web-stat-filter.url-pattern		过滤器生效路径
web-stat-filter.exclusions		过滤忽略的url
web-stat-filter.session-stat-enable		是否开启session监控
web-stat-filter.session-stat-max-count		监控session最大数量
web-stat-filter.principal-session-name		在session中能识别用户的sessionName
web-stat-filter.principal-cookie-name		在cookie中能识别用户的cookieName
web-stat-filter.profile-enable		是否启用监控单个Url调用的sql列表
stat-view-servlet.enabled	false	是否启用StatViewServlet（监控页面）
stat-view-servlet.url-pattern		访问页面
stat-view-servlet.reset-enable		是否允许手动重置监控数据
stat-view-servlet.login-username		监控页登录账号
stat-view-servlet.login-password		监控页登录密码
stat-view-servlet.allow	*	访问监控页白名单
stat-view-servlet.deny		访问监控页黑名单
aop-patterns		Spring监控AOP切入点，如x.y.z.service.*,配置多个英文逗号分隔

当我们都配置开启了监控，并且 stat-view-servlet.url-pattern=/druid/*，此时项目的Druid监控页面地址是：http://ip:port/druid 。在输入账号/密码成功登录后，监控页面主要包含下面的模块：

1. 数据源：显示数据源和连接池的基本信息。
2. SQL监控： 对执行的MySQL语句进行记录，并记录执行时间、事务次数等。
3. SQL防火墙 ：对SQL进行预编译，并统计该条SQL的数据指标。
4. Web应用：对发布的服务进行监控，统计访问次数，并发数等全局信息
5. URI监控：对访问的URI进行统计，记录次数，并发数，执行jdbc数等
6. Session监控：对用户请求后保存在服务器端的session进行记录，识别出每个用户访问了多少次数据库等。
7. Spring监控（按需配置）：利用aop对各个内容接口的执行时间、jdbc数进行记录。

3. 多数据源

Spring Boot 2.X 版本不再支持配置继承（即所有数据源不能spring.datasource.druid.*的配置 ），多数据源的话每个数据源的所有配置都需要单独配置，否则配置不会生效。应该如下配置：

# Druid 数据源 1 
...
spring.datasource.druid.one.url=  
spring.datasource.druid.one.username=
spring.datasource.druid.one.password= 
spring.datasource.druid.one.driver-class-name=
spring.datasource.druid.one.max-active=10
spring.datasource.druid.one.max-wait=10000
...

# Druid 数据源 2 
...
spring.datasource.druid.two.url=  
spring.datasource.druid.two.username=
spring.datasource.druid.two.password= 
spring.datasource.druid.two.driver-class-name=
spring.datasource.druid.two.max-active=20
spring.datasource.druid.two.max-wait=20000

在 IOC容器中分别注册两个数据源,@Primary表示默认数据源。

@Primary
@Bean(name="dataSourceOne")
@ConfigurationProperties("spring.datasource.druid.one")
public DataSource dataSourceOne(){
    return DruidDataSourceBuilder.create().build();
}

@Bean(name="dataSourceOne")
@ConfigurationProperties("spring.datasource.druid.two")
public DataSource dataSourceTwo(){
    return DruidDataSourceBuilder.create().build();
}

当在dao层连接数据库时，在dao层方法上加上@Bean(name="数据源名称")，就能选择指定数据源来执行方法。如果没有加上该注解，则认为使用默认数据源。