1. 开启配置
大学里刚学数据库的时候,都是通过JDBC来手动创建一个数据连接,执行完sql后再手动关闭。而工作中,都在用连接池来管理数据连接。连接池
是创建和管理一个连接的缓冲池的技术,这些连接准备好被任何需要它们的线程使用。
Druid连接池
是阿里巴巴开源的数据库连接池项目。Druid连接池为监控而生,内置强大的监控功能,监控特性不影响性能。功能强大,能防SQL注入,内置Loging能诊断Hack应用行为。
spring boot2.x 默认的连接池是HikariCP
,HikariCP的特点是快,它的处理数据源连接的速度和性能在世界上遥遥领先。但在实际项目中,连接池的处理速度并不是后端的瓶颈,况且Druid并不比HikariCP慢多少。而我更看重Druid丰富的功能,尤其是在监控方面。
在服务器架构转为微服务之后,我最怀念WebLogic服务器的功能,就是控制台页面上的数据源监控模块,因为通过监控模式上数据源的连接数,经常能反映出很多问题。而Druid同样内嵌的监控页面,它的监控级别和扩展功能,远远高于WebLogic服务器所能达到的。话不多说,马上开始使用吧。
pom.xml
首先是导入druid的starter包
com.alibaba
druid-spring-boot-starter
1.1.10
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 |
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 。在输入账号/密码成功登录后,监控页面主要包含下面的模块:
- 数据源:显示数据源和连接池的基本信息。
- SQL监控: 对执行的MySQL语句进行记录,并记录执行时间、事务次数等。
- SQL防火墙 :对SQL进行预编译,并统计该条SQL的数据指标。
- Web应用:对发布的服务进行监控,统计访问次数,并发数等全局信息
- URI监控:对访问的URI进行统计,记录次数,并发数,执行jdbc数等
- Session监控:对用户请求后保存在服务器端的session进行记录,识别出每个用户访问了多少次数据库等。
- 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="数据源名称")
,就能选择指定数据源来执行方法。如果没有加上该注解,则认为使用默认数据源
。