本文主要是介绍高性能 数据库连接池 HikariCP | 构造 HikariCP 数据源,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
👀 上节回顾:上一节对 HikariCP 数据源进行了简单介绍。
👉 本节目标:了解如何构造 HikariCP 数据库。
既然那么快,那么怎么构造 HikariCP 数据源,然后用起来呢?
多种构造方法
HikariDataSource 有两个构造方法:
- 默认构造器:使用 setter 方法来配置连接池。 相比于下面的方法,其性能会稍微低一点,因为有 lazy initialization check。
- 使用指定的 HikariConfig 构造:其会复制 HikariConfig 到 HikariDataSource,所以修改 HikariConfig 不会影响 HikariDataSource。
/**
* Default constructor. Setters are used to configure the pool. Using
* this constructor vs. {@link #HikariDataSource(HikariConfig)} will
* result in {@link #getConnection()} performance that is slightly lower
* due to lazy initialization checks.
*
* The first call to {@link #getConnection()} starts the pool. Once the pool
* is started, the configuration is "sealed" and no further configuration
* changes are possible -- except via {@link HikariConfigMXBean} methods.
*/
public HikariDataSource()
{super();fastPathPool = null;
}/**
* Construct a HikariDataSource with the specified configuration. The
* {@link HikariConfig} is copied and the pool is started by invoking this
* constructor.
*
* The {@link HikariConfig} can be modified without affecting the HikariDataSource
* and used to initialize another HikariDataSource instance.
*
* @param configuration a HikariConfig instance
*/
public HikariDataSource(HikariConfig configuration)
{configuration.validate();configuration.copyStateTo(this);LOGGER.info("{} - Starting...", configuration.getPoolName());pool = fastPathPool = new HikariPool(this);LOGGER.info("{} - Start completed.", configuration.getPoolName());this.seal();
}
HikariConfig 有三个构造方法:
- 默认构造器:使用 setter 方法设置配置
- 使用 Properties 构造:传入 Properties 配置
- 使用 Properties 文件路径构造:给到 Properties 配置文件路径,然后加载为 Properties
/**
* Default constructor
*/
public HikariConfig()
{dataSourceProperties = new Properties();healthCheckProperties = new Properties();minIdle = -1;maxPoolSize = -1;maxLifetime = MAX_LIFETIME;connectionTimeout = CONNECTION_TIMEOUT;validationTimeout = VALIDATION_TIMEOUT;idleTimeout = IDLE_TIMEOUT;initializationFailTimeout = 1;isAutoCommit = true;keepaliveTime = DEFAULT_KEEPALIVE_TIME;String systemProp = System.getProperty("hikaricp.configurationFile");if (systemProp != null) {loadProperties(systemProp);}
}/**
* Construct a HikariConfig from the specified properties object.
*
* @param properties the name of the property file
*/
public HikariConfig(Properties properties)
{this();PropertyElf.setTargetFromProperties(this, properties);
}/**
* Construct a HikariConfig from the specified property file name. <code>propertyFileName</code>
* will first be treated as a path in the file-system, and if that fails the
* Class.getResourceAsStream(propertyFileName) will be tried.
*
* @param propertyFileName the name of the property file
*/
public HikariConfig(String propertyFileName)
{this();loadProperties(propertyFileName);
}
最简单的构造案例
最简单的方式,就是直接使用 HikariDataSource 的默认构造器,然后使用 setter 方法设置属性。
HikariDataSource ds = new HikariDataSource();
ds.setJdbcUrl("jdbc:mysql://localhost:3306/simpsons");
ds.setUsername("bart");
ds.setPassword("51mp50n");
是不是很 easy?😊
SpringBoot 如何构造?
SpringBoot 提供了对 HikariCP 连接池的自动化配置。当满足如下条件时,自动配置 HikariCP 数据源:
- 重点1:有 HikariDataSource 类,且没有定义 DataSource Bean
- 重点2:spring.datasource.type 未填值,或者值为
com.zaxxer.hikari.HikariDataSource
时 - 重点3:根据配置和 Jdbc 连接明细创建 HikariDataSource
/*** Hikari DataSource configuration.*/
@Configuration(proxyBeanMethods = false)
// 重点1:有 HikariDataSource 类,且没有定义 DataSource Bean
@ConditionalOnClass(HikariDataSource.class)
@ConditionalOnMissingBean(DataSource.class)
// 重点2:spring.datasource.type 未填值,或者值为 com.zaxxer.hikari.HikariDataSource 时
@ConditionalOnProperty(name = "spring.datasource.type", havingValue = "com.zaxxer.hikari.HikariDataSource",matchIfMissing = true)
static class Hikari {@Beanstatic HikariJdbcConnectionDetailsBeanPostProcessor jdbcConnectionDetailsHikariBeanPostProcessor(ObjectProvider<JdbcConnectionDetails> connectionDetailsProvider) {return new HikariJdbcConnectionDetailsBeanPostProcessor(connectionDetailsProvider);}// 重点3:根据 spring.datasource.hikari 配置和 Jdbc 连接明细创建 HikariDataSource@Bean@ConfigurationProperties(prefix = "spring.datasource.hikari")HikariDataSource dataSource(DataSourceProperties properties, JdbcConnectionDetails connectionDetails) {HikariDataSource dataSource = createDataSource(connectionDetails, HikariDataSource.class,properties.getClassLoader());if (StringUtils.hasText(properties.getName())) {dataSource.setPoolName(properties.getName());}return dataSource;}}
spring.datasource.hikari
相关配置项将直接应用到 HikariDataSource 类上,该类继承关系如下:
HikariDataSource extends HikariConfig implements DataSource, Closeable
在 HikariConfig 类包含可配置的属性:比如 connectionTimeout
这样,通过配置文件 + 自动化配置即可完成自定义 HikariCP 数据源配置啦!😊
相关文章
1.高性能 数据库连接池 | HikariCP 简介
2.高性能 数据库连接池 HikariCP | 构造 HikariCP 数据源
3.高性能 数据库连接池 HikariCP | HikariCP 配置详解
4.高性能 数据库连接池 HikariCP | 连接池大小配置误区
5.高性能 数据库连接池 HikariCP | MySQL 最佳性能实践
这篇关于高性能 数据库连接池 HikariCP | 构造 HikariCP 数据源的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!