Maven依赖

<dependency>
  <groupId>org.apache.tomcat</groupId>
  <artifactId>tomcat-jdbc</artifactId>
  <version>8.5.9</version>
</dependency>

最新版本为9.0,推荐使用8.5.9稳定版

常用配置

连接池配置项很多,下面只列出了推荐配置,项目组可根据自身情况进行增减

<bean id="dataSpource" class="org.apache.tomcat.jdbc.pool.DataSource" destroy-method="close">
    <property name="driverClassName" value="${spring.db.driverClassName}" />
    <property name="url" value="${spring.db.url}" />
    <property name="username" value="${spring.db.username}" />
    <property name="password" value="${spring.db.password}" />
    <!-- 连接器启动时创建的初始连接数。默认为 10 -->
    <property name="initialSize" value="${spring.db.initialSize}" />
    <!-- 最大连接数 默认100 -->
    <property name="maxActive" value="${spring.db.maxActive}" />
    <!-- 最大空闲连接数 默认100 -->
    <property name="maxIdle" value="${spring.db.maxIdle}" />
    <!-- 最小连接数,一般与initialSize一致即可 。默认值取自 initialSize -->
    <property name="minIdle" value="${spring.db.minIdle}" />
    <!--连接池中连接用完时,新的请求的等待时间,超时返回异常,毫秒 默认30000-->
    <property name="maxWait" value="${spring.db.maxWait}" />
    <!-- 连接进入空闲状态时是否经过空闲对象驱逐进程同时进行校验,默认false,依赖validationQuery -->
    <property name="testWhileIdle" value="${spring.db.testWhileIdle}" />
    <!-- 在连接返回给调用者前用于校验连接是否有效的SQL语句,必须为一个SELECT语句,且至少有一行结果 -->
    <property name="validationQuery" value="${spring.db.validationQuery}" />
    <!-- 连接验证的超时时间,单位:秒 -->
    <property name="validationQueryTimeout" value="${spring.db.validationQueryTimeout}" />
    <!-- 检查连接可用性的时间间隔,单位:毫秒 默认30000 -->
    <property name="validationInterval" value="${spring.db.validationInterval}" />
    <!-- 空闲对象驱逐检查时间间隔单位毫秒,默认5000 -->
    <property name="timeBetweenEvictionRunsMillis" value="${spring.db.timeBetweenEvictionRunsMillis}" />
    <!-- 连接被空闲对象驱逐进程驱逐前在池中保持空闲状态的最小时间,单位毫秒,默认60000 -->
    <property name="minEvictableIdleTimeMillis" value="${spring.db.minEvictableIdleTimeMillis}" />
    <!-- 连接池所创建的连接默认自动提交状态,默认为JDBC缺省值 -->
    <property name="defaultAutoCommit" value="${spring.db.defaultAutoCommit}" />
    <!--是否利用 JMX 注册连接池,默认:true-->
    <property name="jmxEnabled" value="${spring.db.jmxEnabled}" />
    <!-- 配置增加查询超时设置(另可配置慢查询自动记录,请查看文档) -->
    <property name="jdbcInterceptors" value="QueryTimeoutInterceptor(queryTimeout=${spring.db.queryTimeout});SlowQueryReport(threshold=${spring.db.threshold})" />
</bean>

推荐参数值:(只用于访问量不是很高的项目,项目组根据情况调整)

spring.db.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
spring.db.url=jdbc:sqlserver://10.8.1.112:1433;DatabaseName=xxx;sendStringParametersAsUnicode=false
spring.db.username=test
spring.db.password=test
spring.db.initialSize=5
spring.db.maxActive=50
spring.db.maxIdle=30
spring.db.minIdle=5
spring.db.maxWait=10000
spring.db.testWhileIdle=true
spring.db.validationQuery=select 1
spring.db.validationQueryTimeout=1
spring.db.validationInterval=30000
spring.db.timeBetweenEvictionRunsMillis=10000
spring.db.minEvictableIdleTimeMillis=60000
spring.db.defaultAutoCommit=true
spring.db.jmxEnabled=true
#慢查询超时阈值,单位秒
spring.db.queryTimeout=5
#慢查询语句自动记录阈值,注意单位毫秒
spring.db.threshold=3000

参数说明

属性名 描述 默认值
driverClassName 用户名 -
url 密码 -
username 建立连接的url -
password 数据库驱动的完整类名 -
initialSize 连接器启动时创建的初始连接数 10
maxActive 最大连接数,通常为常规访问的最大数据库并发数,建议根据后期jmx监控逐渐调优 100
maxIdle 最大空闲连接数,比较难把握的一个参数,许多连接池也已经移除了此属性(如Druid),访问峰值比较集中的系统如考勤可以设置小一点节省大部分时段的连接资源,过小也可能导致连接频繁创建关闭也会影响性能,建议一般系统不低于maxActive的50% 100
minIdle 最小连接数,一般与initialSize一致即可 10
maxWait 连接池中连接用完时,新的请求的等待时间,超时返回异常,单位毫秒 默认30000
testWhileIdle 连接进入空闲状态时是否经过空闲对象驱逐进程同时进行校验,推荐的校验方法,依赖validationQuery false
validationQuery 在连接返回给调用者前用于校验连接是否有效的SQL语句,必须为一个SELECT语句,且至少有一行结果 -
validationQueryTimeout 连接验证的超时时间,单位秒,注:池本身并不会让查询超时,完全是依靠JDBC驱动来强制查询超时 -
validationInterval TomcatJDBC特有属性,检查连接可用性的时间间隔,防止testOnBorrow和testOnReturn为true时检查过于频繁,单位毫秒 30000
timeBetweenEvictionRunsMillis 空闲对象驱逐检查时间间隔,单位毫秒 5000
minEvictableIdleTimeMillis 连接被空闲对象驱逐进程驱逐前在池中保持空闲状态的最小时间,单位毫秒 60000
defaultAutoCommit 连接池所创建的连接默认自动提交状态(JDBC缺省值意思是默认不会调用setAutoCommit方法) JDBC缺省值
jmxEnabled 是否利用 JMX 注册连接池 true
jdbcInterceptors TomcatJDBC特有属性, QueryTimeoutInterceptor(查询超时拦截器,属性queryTimeout,单位秒,默认1秒),SlowQueryReport(慢查询记录,属性threshold超时纪录阈值单位毫秒,默认1000),多个用拦截器用;分隔,示例:QueryTimeoutInterceptor(queryTimeout=5);SlowQueryReport(threshold=3000)注:当新语句创建时,自动调用Statement.setQueryTimeout(seconds)。池本身并不会让查询超时,完全是依靠JDBC驱动来强制查询超时,更详细的信息请查看官方文档 -
testOnBorrow 连接被调用时是否校验,依赖validationQuery,对性能有一定影响,不推荐使用 false
testOnReturn 连接返回到池中是时是否校验,依赖validationQuery,对性能有一定影响,不推荐使用 false
removeAbandoned 是否清除已经超过 removeAbandonedTimeout 设置的连接,可用于排查一些事务未提交的问题(正式环境谨慎使用,对性能有一定影响),不推荐使用,可用QueryTimeOut拦截器替代 false
removeAbandonedTimeout 清除无效连接的时间,单位秒 与removeAbandoned联合使用 60
defaultReadOnly 连接池创建的连接是否是否为只读,需要说明的是设置了true只是告诉数据库连接是只读,便于数据库做一些优化(例如不安排数据库锁),并非不能执行更新操作,只是对数据的一致性的保护并不强而已(这跟spring的只读事务类似) JDBC缺省