配置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/daify
username: root
password: 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的实例,可实例化各种内部调度任务
默认值:无