###
配置和使用 Hikari
DataSource
Hikari
DataSource 是
Spring Boot 默认的数据源，因其性能优异而广泛使用。在
Spring Boot 中
配置 Hikari
DataSource 主要通过 `application.yml` 或 `application.properties` 文件进行设置，并且可以结合数据库驱动依赖自动完成数据源的初始化。
#### 1. 添加依赖
当项目中引入了 `
spring-boot
-starter
-jdbc` 依赖时，会自动级联加入 HikariCP 的依赖，因此无需额外添加 Hikari 的 Maven 或 Gradle 依赖[^2]。
```xml
<dependency>
<groupId>org.
springframework.boot</groupId>
<artifactId>
spring-boot
-starter
-jdbc</artifactId>
</dependency>
```
同时，需要根据使用的数据库类型引入对应的 JDBC 驱动，例如 MySQL、PostgreSQL 等：
```xml
<!
-- MySQL 示例
-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql
-connector
-java</artifactId>
</dependency>
<!
-- PostgreSQL 示例
-->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
</dependency>
```
#### 2.
配置 Hikari
DataSource
Spring Boot 支持通过 `application.yml` 或 `application.properties` 文件对 Hikari 进行详细
配置。以下是一个典型的 `application.yml`
配置示例：
```yaml
spring:
datasource:
url: jdbc:mysql://localhost:3306/mydb?useSSL=false
username: root
password: root
driver
-class
-name: com.mysql.cj.jdbc.Driver
hikari:
auto
-commit: true
connection
-test
-query: SELECT 1
connection
-timeout: 30000
idle
-timeout: 30000
max
-lifetime: 1800000
maximum
-pool
-size: 15
minimum
-idle: 5
pool
-name: MyHikariPool
validation
-timeout: 10
```
如果使用 `application.properties`，则
配置如下：
```properties
spring.
datasource.url=jdbc:mysql://localhost:3306/mydb?useSSL=false
spring.
datasource.username=root
spring.
datasource.password=root
spring.
datasource.driver
-class
-name=com.mysql.cj.jdbc.Driver
spring.
datasource.hikari.auto
-commit=true
spring.
datasource.hikari.connection
-test
-query=SELECT 1
spring.
datasource.hikari.connection
-timeout=30000
spring.
datasource.hikari.idle
-timeout=30000
spring.
datasource.hikari.max
-lifetime=1800000
spring.
datasource.hikari.maximum
-pool
-size=15
spring.
datasource.hikari.minimum
-idle=5
spring.
datasource.hikari.pool
-name=MyHikariPool
spring.
datasource.hikari.validation
-timeout=10
```
上述
配置项解释如下：
- **url**: 数据库连接地址。
- **username/password**: 数据库登录凭据。
- **driver
-class
-name**: 数据库驱动类名。
- **auto
-commit**: 是否自动提交事务，默认为 `true`。
- **connection
-test
-query**: 测试连接是否有效的 SQL 查询语句。
- **connection
-timeout**: 获取连接的超时时间（毫秒）。
- **idle
-timeout**: 连接在池中保持空闲的最长时间（毫秒）。
- **max
-lifetime**: 连接的最大生命周期（毫秒）。
- **maximum
-pool
-size**: 连接池允许的最大连接数。
- **minimum
-idle**: 连接池中保持的最小空闲连接数。
- **pool
-name**: 连接池名称。
- **validation
-timeout**: 连接验证的超时时间（秒）[^5]。
#### 3. 自定义 HikariConfig
除了通过
配置文件方式外，还可以手动创建 `HikariConfig` 和 `Hikari
DataSource` 实例。这适用于更复杂的场景或动态加载
配置文件的情况：
```java
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.Hikari
DataSource;
import javax.sql.
DataSource;
public class
DataSourceFactory {
public static
DataSource create
DataSource() {
HikariConfig config = new HikariConfig("/some/path/hikari.properties");
return new Hikari
DataSource(config);
}
}
```
对应的 `hikari.properties` 文件内容如下：
```properties
dataSourceClassName=org.postgresql.ds.PGSimple
DataSource
dataSource.user=test
dataSource.password=test
dataSource.databaseName=mydb
dataSource.portNumber=5432
dataSource.serverName=localhost
```
#### 4. 切换其他数据源（如 Druid）
如果希望使用其他数据源实现（如 Alibaba Druid），可以通过 `
spring.
datasource.type` 属性指定：
```yaml
spring:
datasource:
type: com.alibaba.druid.
spring.boot.autoconfigure.Druid
DataSourceAutoConfigure
```
并在 `pom.xml` 中添加 Druid 的依赖[^4]。
#### 5. 使用 Hikari
DataSource 进行数据库操作
一旦数据源
配置完成，
Spring Boot 会自动注入 `
DataSource` Bean，可以直接在代码中使用：
```java
import org.
springframework.beans.factory.annotation.Autowired;
import org.
springframework.jdbc.core.JdbcTemplate;
import org.
springframework.stereotype.Service;
@Service
public class UserService {
private final JdbcTemplate jdbcTemplate;
@Autowired
public UserService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
public void createUser(String name, String email) {
String sql = "INSERT INTO users(name, email) VALUES(?, ?)";
jdbcTemplate.update(sql, name, email);
}
}
```
####
本文介绍了如何在Spring配置文件中使用property-placeholder来加载外部属性文件db.properties，并通过示例展示了如何配置BasicDataSource的数据源参数。
扫一扫
5427
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
