wen Java 数据库连接池介绍(4)-
Tomcat 连接池是从 Tomcat 7 开始重新编写的高并发连接池，用以取代以前 Tomcat 中使用的 DBCP 1 连接池，它可以配置在 Tomcat 中使用，也可以单独使用。本文主要介绍 Tomcat 连接池的基本使用，文中使用到的软件版本：Java 1.8.0_191、Tomcat 8.5.72、Spring Boot 2.3.12.RELEASE。
1、配置参数
1.1、基础配置
| 参数 | 默认值 | 描述 |
| factory | 必须，需要是 org.apache.tomcat.jdbc.pool.DataSourceFactory | |
| type | 应该是 javax.sql.DataSource 或 javax.sql.XADataSource |
1.2、系统属性
| 参数 | 默认值 | 描述 |
| org.apache.tomcat.jdbc.pool.onlyAttemptCurrentClassLoader | false | 是否只使用当前的类加载器(加载该连接池的类加载器)来加载动态类 |
1.3、一般参数
这些参数和 DBCP 一致，但有些默认值不一样。
| 参数 | 默认值 | 描述 |
| defaultAutoCommit | 驱动的默认值 | 是否自动提交 |
| defaultReadOnly | 驱动的默认值 | 是否只读 |
| defaultTransactionIsolation | 驱动的默认值 |
默认的事务隔离级别 |
| defaultCatalog |
默认的 catalog。(目录，类似于模式名，但比模式名更加抽象； |
|
| driverClassName | 驱动名称 | |
| url | 连接 url | |
| username | 用户名 | |
| password | 密码 | |
| maxActive | 100 | 最大活动连接数 |
| maxIdle | 100 | 最大空闲连接数 |
| minIdle | 10 | 最小空闲连接数 |
| initialSize | 10 | 初始连接数 |
| maxWait | 3000 | 从连接池获取连接，最大等待时间(秒) |
| testOnBorrow | false | 从连接池获取连接时，是否验证有效性；如果验证失败，则丢弃该连接。 |
| testOnConnect | true | 连接创建时，是否验证有效性 |
| testOnReturn | false | 连接返回连接池时，是否验证有效性 |
| testWhileIdle | false | 连接空闲时，是否验证有效性 |
| validationQuery | null |
连接校验的查询sql |
| validationQueryTimeout | -1 | 校验查询的超时时间(秒)；非正数表示不启用该特性。 |
| validatorClassName | null | 校验的类名，需实现 org.apache.tomcat.jdbc.pool.Validator 接口并包含一个无参构造函数。 |
| timeBetweenEvictionRunsMillis | 5000 | 校验空闲连接的时间周期(毫秒)，不能设为小于 1 秒，非正表示不验证 |
| minEvictableIdleTimeMillis | 60000 | 空闲连接至少多长时间(毫秒)后，才会被校验 |
| removeAbandoned | false | 是否删除泄露的连接 |
| removeAbandonedTimeout | 60 | 连接泄露的超时时间(秒) |
| logAbandoned | false | 连接删除时是否打印堆栈信息 |
| connectionProperties | null |
连接属性，格式为： [propertyName=property;]* |
1.4、增强参数
| 参数 | 默认值 | 描述 |
| initSQL | null | 连接创建时，执行的初始化 SQL |
| jdbcInterceptors | null |
jdbc 拦截器，需要继承 org.apache.tomcat.jdbc.pool.JdbcInterceptor；已存在的拦截器： |
| validationInterval | 3000 | 连接校验的最短间隔(毫秒) |
| jmxEnabled | true | 是否注册连接池到 JMX |
| fairQueue | true | 是否使用公平队列，如果为 true，获取连接时将按照 “先进先出” 的原则 |
| abandonWhenPercentageFull | 0 | 泄露连接达到 abandonWhenPercentageFull 比例才关闭这些连接，0 表示有泄露连接立马关闭 |
| maxAge | 0 | 连接最大存活时间；在从连接池获取连接和连接返回连接池时进行该项检测，如果 now – time-when-connected > maxAge，则关闭该连接；0 表示不进行该项检测。 |
| useEquals | true | 是否使用 String.equals 来判断 ProxyConnection 是否相等 |
| suspectTimeout | 0 | 和 removeAbandonedTimeout 类似，但该设置只是打印日志并不删除连接；大于 0 才生效。 |
| rollbackOnReturn | false | 连接在返回连接池时是否自动回滚事务。 |
| commitOnReturn | false | 连接在返回连接池时是否自动提交事务；如果 rollbackOnReturn==true 则忽略该参数。 |
| alternateUsernameAllowed | false | 从连接池获取连接时是否允许设置新的凭证。默认情况下，连接池会忽略 DataSource.getConnection(username,password) 的调用，直接返回一个已创建的连接；如果要使用不同的凭证来获取连接，即 DataSource.getConnection(username,password) 生效，可把该参数设为 true。 |
| dataSource | null | 设置数据源，连接池将从该数据源获取连接 |
| dataSourceJNDI | null | 数据源的 jndi |
| useDisposableConnectionFacade | true | 是否使用连接外观；设置为 true 可以防止连接关闭后的重复使用。 |
| logValidationErrors | false | 是否记录校验的错误 |
| propagateInterruptState | false | 是否传播线程中断状态 |
| ignoreExceptionOnPreLoad | false | 是否忽略创建连接时的错误 |
| useStatementFacade | true | 如果希望使用包装 statement，以便在设置了 statement 代理时，在已关闭的 statement 上调用 equals() and hashCode() 方法，需将此设置为 true。 |
详细的说明可以参考官网文档：https://tomcat.apache.org/tomcat-8.5-doc/jdbc-pool.html
2、使用
2.1、直接使用
2.1.1、引入依赖
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-jdbc</artifactId>
<version>8.5.72</version>
</dependency>
