HikariCP连接池及其在springboot中的配置

水深无声 2022-05-17 06:49 871阅读 0赞

大家好，现在介绍一款非常强大，高效，并且号称“史上最快连接池”。由此可见他是有多受人喜欢，并且在springboot2.0之后，采用的默认数据库连接池就是Hikari。

我们知道的连接池有C3P0,DBCP,它们都比较成熟稳定，但性能不是十分好。 所以有了BoneCP这个连接池，它是一个高速、免费、开源的JAVA连接池，它的性能几乎是C3P0、DBCP的25倍，十分强悍。性能对比[点击这里hikariCP,druid,tomcat-jdbc,dbcp,c3p0][hikariCP_druid_tomcat-jdbc_dbcp_c3p0]

官网也给出了一个性能对比示意图，官网在[这里][Link 1]：

![70][]

好，那么下面看看在springboot中如何配置Hikari连接池。主要配置如下，

<table> 
 <thead> 
  <tr> 
   <th style="width:196px;">配置项</th> 
   <th style="width:466px;">描述</th> 
   <th style="width:229px;">构造器默认值</th> 
   <th style="width:222px;">默认配置validate之后的值</th> 
   <th style="width:355px;">validate重置</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:196px;">autoCommit</td> 
   <td style="width:466px;">自动提交从池中返回的连接</td> 
   <td style="width:229px;">true</td> 
   <td style="width:222px;">true</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">connectionTimeout</td> 
   <td style="width:466px;">等待来自池的连接的最大毫秒数</td> 
   <td style="width:229px;">SECONDS.toMillis(30) = 30000</td> 
   <td style="width:222px;">30000</td> 
   <td style="width:355px;">如果小于250毫秒，则被重置回30秒</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">idleTimeout</td> 
   <td style="width:466px;">连接允许在池中闲置的最长时间</td> 
   <td style="width:229px;">MINUTES.toMillis(10) = 600000</td> 
   <td style="width:222px;">600000</td> 
   <td style="width:355px;">如果idleTimeout+1秒&gt;maxLifetime 且 maxLifetime&gt;0，则会被重置为0（代表永远不会退出）；如果idleTimeout!=0且小于10秒，则会被重置为10秒</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">maxLifetime</td> 
   <td style="width:466px;">池中连接最长生命周期</td> 
   <td style="width:229px;">MINUTES.toMillis(30) = 1800000</td> 
   <td style="width:222px;">1800000</td> 
   <td style="width:355px;">如果不等于0且小于30秒则会被重置回30分钟</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">connectionTestQuery</td> 
   <td style="width:466px;">如果您的驱动程序支持JDBC4，我们强烈建议您不要设置此属性</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">minimumIdle</td> 
   <td style="width:466px;">池中维护的最小空闲连接数</td> 
   <td style="width:229px;">-1</td> 
   <td style="width:222px;">10</td> 
   <td style="width:355px;">minIdle&lt;0或者minIdle&gt;maxPoolSize,则被重置为maxPoolSize</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">maximumPoolSize</td> 
   <td style="width:466px;">池中最大连接数，包括闲置和使用中的连接</td> 
   <td style="width:229px;">-1</td> 
   <td style="width:222px;">10</td> 
   <td style="width:355px;">如果maxPoolSize小于1，则会被重置。当minIdle&lt;=0被重置为DEFAULT_POOL_SIZE则为10;如果minIdle&gt;0则重置为minIdle的值</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">metricRegistry</td> 
   <td style="width:466px;">该属性允许您指定一个 Codahale / Dropwizard&nbsp;<code>MetricRegistry</code>&nbsp;的实例，供池使用以记录各种指标</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">healthCheckRegistry</td> 
   <td style="width:466px;">该属性允许您指定池使用的Codahale / Dropwizard HealthCheckRegistry的实例来报告当前健康信息</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">poolName</td> 
   <td style="width:466px;">连接池的用户定义名称，主要出现在日志记录和JMX管理控制台中以识别池和池配置</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">HikariPool-1</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">initializationFailTimeout</td> 
   <td style="width:466px;">如果池无法成功初始化连接，则此属性控制池是否将&nbsp;<code>fail fast</code></td> 
   <td style="width:229px;">1</td> 
   <td style="width:222px;">1</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">isolateInternalQueries</td> 
   <td style="width:466px;">是否在其自己的事务中隔离内部池查询，例如连接活动测试</td> 
   <td style="width:229px;">false</td> 
   <td style="width:222px;">false</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">allowPoolSuspension</td> 
   <td style="width:466px;">控制池是否可以通过JMX暂停和恢复</td> 
   <td style="width:229px;">false</td> 
   <td style="width:222px;">false</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">readOnly</td> 
   <td style="width:466px;">从池中获取的连接是否默认处于只读模式</td> 
   <td style="width:229px;">false</td> 
   <td style="width:222px;">false</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">registerMbeans</td> 
   <td style="width:466px;">是否注册JMX管理Bean（<code>MBeans</code>）</td> 
   <td style="width:229px;">false</td> 
   <td style="width:222px;">false</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">catalog</td> 
   <td style="width:466px;">为支持&nbsp;<code>catalog</code>&nbsp;概念的数据库设置默认&nbsp;<code>catalog</code></td> 
   <td style="width:229px;">driver default</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">connectionInitSql</td> 
   <td style="width:466px;">该属性设置一个SQL语句，在将每个新连接创建后，将其添加到池中之前执行该语句。</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">driverClassName</td> 
   <td style="width:466px;">HikariCP将尝试通过仅基于jdbcUrl的DriverManager解析驱动程序，但对于一些较旧的驱动程序，还必须指定driverClassName</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">transactionIsolation</td> 
   <td style="width:466px;">控制从池返回的连接的默认事务隔离级别</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">validationTimeout</td> 
   <td style="width:466px;">连接将被测试活动的最大时间量</td> 
   <td style="width:229px;">SECONDS.toMillis(5) = 5000</td> 
   <td style="width:222px;">5000</td> 
   <td style="width:355px;">如果小于250毫秒，则会被重置回5秒</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">leakDetectionThreshold</td> 
   <td style="width:466px;">记录消息之前连接可能离开池的时间量，表示可能的连接泄漏</td> 
   <td style="width:229px;">0</td> 
   <td style="width:222px;">0</td> 
   <td style="width:355px;">如果大于0且不是单元测试，则进一步判断：(leakDetectionThreshold &lt; SECONDS.toMillis(2) or (leakDetectionThreshold &gt; maxLifetime &amp;&amp; maxLifetime &gt; 0)，会被重置为0 . 即如果要生效则必须&gt;0，而且不能小于2秒，而且当maxLifetime &gt; 0时不能大于maxLifetime</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">dataSource</td> 
   <td style="width:466px;">这个属性允许你直接设置数据源的实例被池包装，而不是让HikariCP通过反射来构造它</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">schema</td> 
   <td style="width:466px;">该属性为支持模式概念的数据库设置默认模式</td> 
   <td style="width:229px;">driver default</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">threadFactory</td> 
   <td style="width:466px;">此属性允许您设置将用于创建池使用的所有线程的java.util.concurrent.ThreadFactory的实例。</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
  <tr> 
   <td style="width:196px;">scheduledExecutor</td> 
   <td style="width:466px;">此属性允许您设置将用于各种内部计划任务的java.util.concurrent.ScheduledExecutorService实例</td> 
   <td style="width:229px;">null</td> 
   <td style="width:222px;">null</td> 
   <td style="width:355px;">-</td> 
  </tr> 
 </tbody> 
</table>

原版英文详细配置查看[这里][Link 1]

## 数据库配置
    spring.datasource.type=com.zaxxer.hikari.HikariDataSource
    spring.datasource.driverClassName = com.mysql.jdbc.Driver
    spring.datasource.url = jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf-8&useSSL=false
    spring.datasource.username = root
    spring.datasource.password = root
    ##  Hikari 连接池配置 ------ 详细配置请访问：https://github.com/brettwooldridge/HikariCP
    ## 最小空闲连接数量
    spring.datasource.hikari.minimum-idle=5
    ## 空闲连接存活最大时间，默认600000（10分钟）
    spring.datasource.hikari.idle-timeout=180000
    ## 连接池最大连接数，默认是10
    spring.datasource.hikari.maximum-pool-size=10
    ## 此属性控制从池返回的连接的默认自动提交行为,默认值：true
    spring.datasource.hikari.auto-commit=true
    ## 连接池母子
    spring.datasource.hikari.pool-name=MyHikariCP
    ## 此属性控制池中连接的最长生命周期，值0表示无限生命周期，默认1800000即30分钟
    spring.datasource.hikari.max-lifetime=1800000
    ## 数据库连接超时时间,默认30秒，即30000
    spring.datasource.hikari.connection-timeout=30000
    spring.datasource.hikari.connection-test-query=SELECT 1

好，启动项目，可以看到控制台

2018-08-08 09:25:01.611  INFO 8096 --- [  restartedMain] o.s.j.e.a.AnnotationMBeanExporter        : Located MBean 'dataSource': registering with JMX server as MBean [com.zaxxer.hikari:name=dataSource,type=HikariDataSource]

写个查询方法，访问一下，控制台有如下信息，即表示成功应用Hikari连接池

2018-08-08 09:40:00.094  INFO 8096 --- [nio-8080-exec-1] com.zaxxer.hikari.HikariDataSource       : MyHikariCP - Starting...
    2018-08-08 09:40:00.325  INFO 8096 --- [nio-8080-exec-1] com.zaxxer.hikari.HikariDataSource       : MyHikariCP - Start completed.

OKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK!!

[hikariCP_druid_tomcat-jdbc_dbcp_c3p0]: https://www.tuicool.com/articles/qayayiM
[Link 1]: https://github.com/brettwooldridge/HikariCP
[70]: /images/20220517/7caf44a5e6ed4760a5b08b0f5354bcc1.png