HiKariCP数据库连接池

介绍HiKariCP数据库连接池的特点与配置方式,包括不同Java版本的Maven依赖、初始化方法及Spring配置示例。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

HiKariCP是数据库连接池的一个后起之秀,号称性能最好,可以完美地PK掉其他连接池

官网:https://github.com/brettwooldridge/HikariCP

 

Java 8 maven artifact:

    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP</artifactId>
        <version>2.6.2</version>
    </dependency>

Java 9 Early Access maven artifact:

    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP-java9ea</artifactId>
        <version>2.6.1</version>
    </dependency>

Java 7 maven artifact (maintenance mode):

    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP-java7</artifactId>
        <version>2.4.12</version>
    </dependency>

Java 6 maven artifact (maintenance mode):

    <dependency>
        <groupId>com.zaxxer</groupId>
        <artifactId>HikariCP-java6</artifactId>
        <version>2.3.13</version>
    </dependency

Initialization

You can use the HikariConfig class like so1:

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/simpsons");
config.setUsername("bart");
config.setPassword("51mp50n");
config.addDataSourceProperty("cachePrepStmts", "true");
config.addDataSourceProperty("prepStmtCacheSize", "250");
config.addDataSourceProperty("prepStmtCacheSqlLimit", "2048");

HikariDataSource ds = new HikariDataSource(config);

 1 MySQL-specific example, do not copy verbatim.

or directly instantiate a HikariDataSource like so:

HikariDataSource ds = new HikariDataSource();
ds.setJdbcUrl("jdbc:mysql://localhost:3306/simpsons");
ds.setUsername("bart");
ds.setPassword("51mp50n");
...

or property file based:

// Examines both filesystem and classpath for .properties file
HikariConfig config = new HikariConfig("/some/path/hikari.properties");
HikariDataSource ds = new HikariDataSource(config);

Example property file:

dataSourceClassName=org.postgresql.ds.PGSimpleDataSource
dataSource.user=test
dataSource.password=test
dataSource.databaseName=mydb
dataSource.portNumber=5432
dataSource.serverName=localhost

or java.util.Properties based:

Properties props = new Properties();
props.setProperty("dataSourceClassName", "org.postgresql.ds.PGSimpleDataSource");
props.setProperty("dataSource.user", "test");
props.setProperty("dataSource.password", "test");
props.setProperty("dataSource.databaseName", "mydb");
props.put("dataSource.logWriter", new PrintWriter(System.out));

HikariConfig config = new HikariConfig(props);
HikariDataSource ds = new HikariDataSource(config);

There is also a System property available, hikaricp.configurationFile, that can be used to specify the location of a properties file. If you intend to use this option, construct a HikariConfig or HikariDataSource instance using the default constructor and the properties file will be loaded.

Spring配置文件

 

 

<!-- Hikari Datasource -->

<bean id="dataSourceHikari" class="com.zaxxer.hikari.HikariDataSource"

destroy-method="shutdown">

<property name="driverClassName" value="${jdbc.driver}" />

<property name="jdbcUrl" value="${jdbc.url}" />

<property name="username" value="${jdbc.username}" />

<property name="password" value="${jdbc.password}" />

<!-- 连接只读数据库时配置为true, 保证安全 -->

<property name="readOnly" value="false" />

<!-- 等待连接池分配连接的最大时长(毫秒),超过这个时长还没可用的连接则发生SQLException, 缺省:30秒 -->

<property name="connectionTimeout" value="30000" />

<!-- 一个连接idle状态的最大时长(毫秒),超时则被释放(retired),缺省:10分钟 -->

<property name="idleTimeout" value="600000" />

<!-- 一个连接的生命时长(毫秒),超时而且没被使用则被释放(retired),缺省:30分钟,建议设置比数据库超时时长少30秒,参考MySQL

wait_timeout参数(show variables like '%timeout%';) -->

<property name="maxLifetime" value="1800000" />

<!-- 连接池中允许的最大连接数。缺省值:10;推荐的公式:((core_count * 2) + effective_spindle_count) -->

<property name="maximumPoolSize" value="60" />

<property name="minimumIdle" value="10" />

</bean>


 

HikariCP所做的一些优化,总结如下:

  • 字节码精简:优化代码,直到编译后的字节码最少,这样,CPU缓存可以加载更多的程序代码;
  • 优化代理和拦截器:减少代码,例如HikariCP的Statement proxy只有100行代码,只有BoneCP的十分之一;
  • 自定义数组类型(FastStatementList)代替ArrayList:避免每次get()调用都要进行range check,避免调用remove()时的从头到尾的扫描;
  • 自定义集合类型(ConcurrentBag):提高并发读写的效率;
  • 其他针对BoneCP缺陷的优化,比如对于耗时超过一个CPU时间片的方法调用的研究(但没说具体怎么优化)。
### HikariCP 数据库连接池配置方法与参数说明 HikariCP 是一个高性能的 Java 数据库连接池,广泛应用于 Spring Boot 等框架中。以下是关于其配置方法、参数说明以及最佳实践的详细内容。 #### 1. 基本配置项 HikariCP 的基本配置项包括 `dataSourceClassName` 或 `jdbcUrl`、`username` 和 `password`,这些是必须设置的参数[^1]。此外,还可以通过 YAML 文件或属性文件进行配置,例如在 Spring Boot 中使用如下配置: ```yaml spring: datasource: type: com.zaxxer.hikari.HikariDataSource driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/foodie-dev?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true username: root password: 123456 ``` #### 2. 非必需配置项 除了基本配置外,HikariCP 提供了许多非必需的配置项以优化性能和可靠性。以下是一些常用配置项及其作用: - **`connectionTimeout`**: 控制等待连接池分配连接的最大时长(毫秒)。默认值为 30 秒。如果超过此时间仍未获得连接,则会抛出异常[^4]。 - **`minimumIdle`**: 控制连接池中最小空闲连接数。建议不要设置该值,以使 HikariCP 作为固定大小的连接池运行[^3]。 - **`maximumPoolSize`**: 设置连接池中最大连接数。默认值为 10。根据实际需求调整此值可以显著影响性能[^4]。 - **`idleTimeout`**: 连接空闲的最大时长(毫秒)。默认值为 10 分钟。超时的连接将被释放[^4]。 - **`maxLifetime`**: 连接的生命时长(毫秒)。默认值为 30 分钟。超时且未使用的连接将被释放。 - **`autoCommit`**: 是否自动提交事务。默认值为 `true`[^4]。 #### 3. 最佳实践 为了充分发挥 HikariCP 的性能优势,以下是一些推荐的最佳实践: - **避免过度配置**:HikariCP 强烈反对向池中添加大量参数配置,建议仅配置必要的选项[^1]。 - **固定大小连接池**:不建议显式设置 `minimumIdle` 属性,而是让 HikariCP 保持固定大小的连接池。 - **合理设置 `maximumPoolSize`**:根据数据库服务器的负载能力和应用的需求,合理调整最大连接数。过大的值可能导致数据库资源耗尽,而过小的值可能限制并发能力。 - **监控连接池状态**:可以通过集成 Prometheus 或 SkyWalking 等工具来监控 HikariCP 的性能指标[^5]。 #### 4. 示例代码 以下是一个完整的 Spring Boot 配置示例: ```yaml spring: datasource: type: com.zaxxer.hikari.HikariDataSource driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/foodie-dev?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true username: root password: 123456 hikari: connection-timeout: 30000 # 30 秒 maximum-pool-size: 10 # 最大连接数 idle-timeout: 600000 # 10 分钟 max-lifetime: 1800000 # 30 分钟 ``` ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值