Spring Boot 属性配置之 DataSource 配置列表

本文详细介绍了SpringBoot中数据源DataSource的各项配置参数,包括JDBC URL、用户名、密码、连接池名称、驱动类名等,帮助开发者理解并优化数据库连接配置。

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

在项目开发过程中,尤其是性能调优的时候,需要我们对应用的数据源进行优化和配置。以下是Spring Boot 提供的相应DataSource的配置清单,方便我们在使用的时候能够进行快速查找:

 

属性说明
spring.datasource.jdbc-url用来创建连接的JDBC URL
spring.datasource.username数据库的登录用户名
spring.datasource.password

数据库登录密码 

spring.datasource.pool-name连接池名称
spring.datasource.driver-class-nameJDBC驱动的全限定类名。默认根据URL自动检测
spring.datasource.maximum-pool-size连接池能达到的最大规模,包含空闲的连接数量和使用中的连接数量
spring.datasource.login-timeout连接数据库的超时时间(单位为秒)
spring.datasource.max-lifetime连接池中连接的最长寿命(单位为毫秒)
spring.datasource.max-wait连接池在等待返回连接时,最长等待多少毫秒再抛出异常
spring.datasource.max-active连接池中最大活跃连接数
spring.datasource.max-idle连接池中最大空闲连接数
spring.datasource.connection-timeout连接超时时间(单位为毫秒)
spring.datasource.connection-test-query用于测试连接有效的SQL查询
spring.datasource.data-source-jndi用户获取连接的数据源JNDI的位置
spring.datasource.min-idle连接池里始终应该保持的最小连接数(用于DBCP和Tomcat连接池)
spring.datasource.idle-timeout连接池中连接能保持闲置状态的最长时间单位为毫秒(默认值为10)
spring.datasource.initial-size在连接池启动的时候要建立的连接数
spring.datasource.test-on-connetct在建立连接时是否要进行测试
spring.datasource.jndi-name数据源JNDI的位置,设置了该属性则忽略类、URL、用户名和密码
spring.datasource.test-while-idle在连接空闲时是否要进行测试

参考书籍:《Spring Boot 实战》作者:【美】Craig Walls 著 , 丁雪丰 译

### 配置和使用 HikariDataSource HikariDataSourceSpring Boot 默认的数据源,因其性能优异而广泛使用。在 Spring Boot配置 HikariDataSource 主要通过 `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. 配置 HikariDataSource 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` 和 `HikariDataSource` 实例。这适用于更复杂的场景或动态加载配置文件的情况: ```java import com.zaxxer.hikari.HikariConfig; import com.zaxxer.hikari.HikariDataSource; import javax.sql.DataSource; public class DataSourceFactory { public static DataSource createDataSource() { HikariConfig config = new HikariConfig("/some/path/hikari.properties"); return new HikariDataSource(config); } } ``` 对应的 `hikari.properties` 文件内容如下: ```properties dataSourceClassName=org.postgresql.ds.PGSimpleDataSource 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.DruidDataSourceAutoConfigure ``` 并在 `pom.xml` 中添加 Druid 的依赖[^4]。 #### 5. 使用 HikariDataSource 进行数据库操作 一旦数据源配置完成,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); } } ``` ####
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值