【HikariCP】HikariCP配置参数

配置HikariCP的必需配置

对于数据源必须要配置的内容只有链接信息，其他内容都是非必须内容

连接信息包括

数据库驱动或者JDBC URL
用户名
密码

数据库驱动

因为现在大多数的JdbcUrl配置中已经指明需要连接的数据库类型，所以一般不需要额外再去设置，这里列出来各个数据库的驱动

数据库	驱动	JDBC URL
Oracle	oracle.jdbc.driver.OracleDriver	jdbc:oracle:thin:@dbip:port:
SQL Server	com.microsoft.jdbc.sqlserver.SQLServerDriver	jdbc:microsoft:sqlserver://dbip:port;DatabaseName=
MySQL	com.mysql.jdbc.Driver	jdbc:mysql://dbip:port/
达梦	dm.jdbc.driver.DmDriver	jdbc:dm://dbip:port/
DB2	com.ibm.db2.jdbc.app.DB2Driver	jdbc:db2://dbip:port/
Sybase	com.sybase.jdbc2.jdbc.SybDriver	jdbc:sybase:Tds::?ServiceName=
PostgreSQL	org.postgresql.Driver	jdbc:postgresql://dbip:port//
h2（内存数据库）	org.h2.Driver	jdbc:h2:mem:

配置数据源的格式

通常配置数据源信息我们可以使用下面四种格式

Config配置类

    public DataSource getDataSource() {HikariConfig hikariConfig = new HikariConfig();hikariConfig.setJdbcUrl("jdbc:mysql://localhost:3306/test?charactorEncoding=utf-8&useSSL=false");hikariConfig.setUsername("root");hikariConfig.setPassword("123456");hikariConfig.setDriverClassName("");HikariDataSource dataSource = new HikariDataSource(hikariConfig);return dataSource;}

这种方式可以通过下面的方式添加数据库不同的配置进来

hikariConfig.addDataSourceProperty("ssl","true");

但是这种方式存在一个问题就是DataSource中的映射需要确认，很多时候设置的参数和实际映射并不是完全一样。

直接实例化数据源

    public DataSource getDataSource2() {HikariDataSource dataSource = new HikariDataSource();dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/test?charactorEncoding=utf-8&useSSL=false");dataSource.setUsername("root");dataSource.setDriverClassName("");dataSource.setPassword("123456");return dataSource;}

setRegisterMbeans

这里需要提一下这个方法，使用直接实例DataSource方法一个好处配置参数在获取连接的时候进行赋值的，这样用户可以修改数据库连接池的参数。但是需要注意如果使用HikariConfig来初始化数据源，则需要在HikariConfig设置setRegisterMbeans。

使用yaml配置

  spring:datasource:hikari:jdbc-url: jdbc:mysql://localhost:3306/daifyusername: rootpassword: 123456

使用Properties配置

    public DataSource getDataSource3() {Properties properties = new Properties();properties.setProperty("datasource.jdbc-url","jdbc:mysql://localhost:3306/test?charactorEncoding=utf-8&useSSL=false");properties.setProperty("dataSource.username","root");properties.setProperty("dataSource.password","123456");properties.setProperty("dataSourceClassName","123456");HikariConfig hikariConfig = new HikariConfig(properties);HikariDataSource dataSource = new HikariDataSource(hikariConfig);return dataSource;}

配置HikariCP的非必需配置

autoCommit

参数作用：控制从池返回的连接的默认自动提交行为

默认值：true

connectionTimeout

参数作用：控制客户端等待池中连接的最长毫秒数。

默认值：默认 30000（30s），最低设置值250

idleTimeout

参数作用：连接允许被闲置在池中的最大时间

默认值：默认600000（10分钟），最小值为10000毫秒（10秒）

maxLifetime

参数作用：控制池中连接的最大生命周期

默认值：默认值为1800000（30分钟），值0表示没有最大生存期

connectionTestQuery

参数作用：在数据库连接池给出连接之前进行查询，以验证与数据库的连接是否仍然存在且有效。

默认值：空

minimumldle

参数作用：属性控制 HikariCP 尝试在池中维护的最小空闲连接数

默认值：果minimumldle未设置则默认为是maximumPoolSize

maximumPoolSize

参数作用：控制数据库连接池连接数允许到达的最大值，包括空闲和正在使用的连接

默认值：10

metricRegistry

参数作用：允许用户指定池使用的Codahale/Dropwizard实例MetricRegistry，来记录各种度量标准。

默认值：无

healthCheckRegistry

参数作用：允许用户指定池使用的Codahale/Dropwizard实例HealthCheckRegistry，来报告当前系统的健康信息。

默认值：无

poolName

参数作用：该属性表示连接池的用户定义名称，主要显示在日志记录和JMX管理控制台中，以标识池和池配置。

默认值：自动生成

initializationFailTimeout

参数作用：控制池在初始化失败的时候是否“快速失败”，该值为尝试获取初始连接的毫秒数。

默认值：1，小于0的值将绕过任何初始连接尝试，并且池将尝试在后台获取连接时立即启动。

isolateinternalQueries

参数作用：控制否在自己的事务中隔离内部池查询

默认值：false

allowPoolSuspension

参数作用：此属性控制池是否可以通过JMX挂起和恢复

默认值：false

readOnly

参数作用：控制从池中获取的Connections是否处于只读模式

默认值：false

registerMbeans

参数作用：是否注册JMX以管理Bean

默认值：false

catalog

参数作用：为支持catalog的数据库设置默认catalog

默认值：使用JDBC驱动程序定义的值

connectionlnitSqI

参数作用：该语句将在每次创建新连接之后执行，然后再将该连接添加到池中。

默认值：无

transactionlsolation

参数作用：控制从池返回的连接的默认事务隔离级别

默认值：使用JDBC驱动程序定义的值，值是Connection类的常量名

public interface Connection  extends Wrapper, AutoCloseable {int TRANSACTION_NONE             = 0;int TRANSACTION_READ_UNCOMMITTED = 1;int TRANSACTION_READ_COMMITTED   = 2;int TRANSACTION_REPEATABLE_READ  = 4;int TRANSACTION_SERIALIZABLE     = 8;}

validationTimeout

参数作用：控制连接测试存活的最长时间

默认值：5000（5秒），最低可设置时间250

leakDetectionThreshold

参数作用：在记录一条指示可能连接泄露的消息之前流出池的时间。值为0表示禁用泄露检测

默认值：0，最低可接受值是2000毫秒（2秒)

dataSource

参数作用：允许用户直接设置DataSource要由池包装的实例，而不是让HikariCP通过反射构造该实例

默认值：无

schema

参数作用：该属性为支持schema概念数据库设置默认schema

默认值：使用JDBC驱动程序定义的值

threadFactory

参数作用：通过配置该属性自定义设置java.util.concurrent.ThreadFactory的实例，可创建池使用的所有线程的实例

默认值：无

scheduledExecutor

参数作用：该属性自定义设置java.util.concurrent.Scheduled-ExecutorService的实例，可实例化各种内部调度任务

默认值：无