Tomcat JDBC连接池(Tomcat 9)

通用配置项

连接检查相关选项

连接检查检查连接的有效性，清理失效的连接

• validationQuery：连接检查时使用的SQL，注意不同的数据库不同，详见上表。
• validationQueryTimeout：执行连接检查的语句的超时时间（秒），默认-1表明无限等待；
• testOnConnect：每次创建连接时测试连接有效性，验证失败抛出SQLException；
• testOnBorrow：每次从连接池借出连接时是否检查连接可用性；
• testOnReturn：每次归还连接时是否检测连接有效性。

注意：

testOnBorrow并不适合高负载的系统，将会导致每次获取连接都增加一次查询请求，带来额外负载。
高负载系统可以思考使用testWhileIdle，在空闲时检测连接；
testOnReturn一般用处不大。

清理线程相关选项

• testWhileIdle：是否开启连接连接清理线程，连接清理线程使用validationQuery验证连接池中的空闲连接，丢弃未通过测试的连接。
• timeBetweenEvictionRunsMillis：evictor两次运行的间隔时间（毫秒）
• minEvictableIdleTimeMillis：连接被回收前可以空闲的最短时间，单位：毫秒。默认值：60000（60秒）

当启动evictor线程后，如果连接数小于minIdle，则创建新的连接直到minIdle个数，没有启动evictor线程时，minIdle没有意义；

无论是否开启evictor线程，当业务压力增加时，活跃连接数可能超过maxIdle，但不会超过maxActive；活跃连接数超过maxIdle时，使用完的活跃连接归还时会立即关闭；

在没有开启evictor线程，假设活跃连接个数曾经超过maxIdle接近或达到maxActive，当压力变小，使用中的连接数降低时，假设最终所有连接都空闲下来时，这时空闲连接将维持在maxIdle由于此时没有evictor线程。

开启evictor线程后，上述的场景，evictor线程每隔timeBetweenEvictionRunsMillis检测空闲，如果连接空闲超过minEvictableIdleTimeMillis，则清理空闲连接，最终使空闲连接维持在minIdle。

可见当maxActive大于maxIdle时，活跃连接超过maxIdle后归还就会被关闭，再获取时如果没有可用连接，总连接数又小于maxActive时，又会新建连接，因此这种情况会带来连接池伸缩造成的性能开销，因此推荐配置maxActive等于maxIdle避免连接池伸缩开销。

initialSize是在连接池创建时的初始连接个数，如果启动evictor且initialSize小于minIdle，则evictor会创建空闲连接将连接数维持在minIdle；如果没有开启evictor，则只有连接使用请求上升时，才会在initialSize基础上创建新的连接。

Abandoned连接选项

Abandoned连接指应用长时间未归还给连接池的连接，连接池可以自动关闭这些连接，以防止连接泄漏。相关配置项如下，具体释义见上表。

• removeAbandoned
• removeAbandonedTimeout
• logAbandoned

注意对于长时间使用同一连接进行批量操作的场景可能不适用该功能。

removeAbandonedTimeout必须长于应用可能的最长SQL执行时间，否则SQL尚未完成执行，连接就被关闭，因此长时间使用同一连接进行批量操作的场景应谨慎使用该功能。

系统配置项

Tomcat JDBC 增强配置项

Spring Boot中使用Tomcat JDBC连接池

基于Spring Boot 2.x，直接将tomcat-jdbc加入依赖：

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>com.zaxxer</groupId>
                    <artifactId>HikariCP</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jdbc</artifactId>
        </dependency>

在应用中使用配置类创建DataSource类型的Bean：

    @Bean
    @ConfigurationProperties("your.datasource.prefix")
    public DataSource dataSource() {
        return DataSourceBuilder.create().type(org.apache.tomcat.jdbc.pool.DataSource.class).build();
    }

Spring Boot使用Tomcat JDBC作为Tomcat JNDI连接池

Tomcat中也带有Tomcat JDBC的jar，但是默认TOMCAT JNDI使用DBCP连接池，如果使用Tomcat JDBC作为Tomcat JNDI的连接池实现，那么就必须在配置中显式指定factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"。

在Tomcat安装目录下的conf/目录中增加context.xml文件：

<?xml version= 1.0  encoding= utf-8 ?>
<Context useHttpOnly="true" privileged="true" reloadable="true">
    <Resource name="jdbc/TestDB"
          auth="Container"
          type="javax.sql.DataSource"
          factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
          testWhileIdle="true"
          testOnBorrow="true"
          testOnReturn="false"
          validationQuery="SELECT 1"
          validationInterval="30000"
          timeBetweenEvictionRunsMillis="30000"
          maxActive="100"
          minIdle="10"
          maxWait="10000"
          initialSize="10"
          removeAbandonedTimeout="60"
          removeAbandoned="true"
          logAbandoned="true"
          minEvictableIdleTimeMillis="30000"
          jmxEnabled="true"
          jdbcInterceptors="org.apache.tomcat.jdbc.pool.interceptor.ConnectionState;
            org.apache.tomcat.jdbc.pool.interceptor.StatementFinalizer"
          username="root"
          password="password"
          driverClassName="com.mysql.cj.jdbc.Driver"
          url="jdbc:mysql://localhost:3306/mysql"
    />
</Context>

在配置类中通过JNDI查询获取相应的DataSource实例：

@Bean
public DataSource jndiDataSource() {
    JndiDataSourceLookup dataSourceLookup = new JndiDataSourceLookup();
    DataSource dataSource = dataSourceLookup.getDataSource("jdbc/TestDB");
    return dataSource;
}

连接Oracle 12c：

1. 驱动

<dependency>
            <groupId>com.oracle</groupId>
            <artifactId>ojdbc6</artifactId>
</dependency>

2. 驱动类oracle.jcbc.OracleDriver
3. 连接串：jdbc:oracle:thin:@IP:PORT:SID
4. 连接验证SQL：select 1 from dual

连接MySQL 8

1. 驱动

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.18</version>
</dependency>

2. 驱动类com.mysql.cj.jdbc.Driver
3. 连接串：jdbc:mysql://IP:PORT/DB_NAME
4. 连接验证SQL：select 1