SpringBoot配置属性之DataSource(三)

本文详细介绍了 Spring 框架中数据源配置的各种参数及其作用,涵盖了连接池管理、事务控制、安全性设置等方面,帮助开发者更好地理解并配置数据源。

datasource

spring.dao.exceptiontranslation.enabled
是否开启PersistenceExceptionTranslationPostProcessor,默认为true

spring.datasource.abandon-when-percentage-full
设定超时被废弃的连接占到多少比例时要被关闭或上报

spring.datasource.allow-pool-suspension
使用Hikari pool时,是否允许连接池暂停,默认为: false

spring.datasource.alternate-username-allowed
是否允许替代的用户名.

spring.datasource.auto-commit
指定updates是否自动提交.

spring.datasource.catalog
指定默认的catalog.

spring.datasource.commit-on-return
设置当连接被归还时,是否要提交所有还未完成的事务

spring.datasource.connection-init-sql
指定连接被创建,再被添加到连接池之前执行的sql.

spring.datasource.connection-init-sqls
使用DBCP connection pool时,指定初始化时要执行的sql

spring.datasource.connection-properties.[key]
在使用DBCP connection pool时指定要配置的属性

spring.datasource.connection-test-query
指定校验连接合法性执行的sql语句

spring.datasource.connection-timeout
指定连接的超时时间,毫秒单位.

spring.datasource.continue-on-error
在初始化数据库时,遇到错误是否继续,默认false

spring.datasource.data
指定Data (DML)脚本

spring.datasource.data-source-class-name
指定数据源的全限定名.

spring.datasource.data-source-jndi
指定jndi的地址

spring.datasource.data-source-properties.[key]
使用Hikari connection pool时,指定要设置的属性

spring.datasource.db-properties
使用Tomcat connection pool,指定要设置的属性

spring.datasource.default-auto-commit
是否自动提交.

spring.datasource.default-catalog
指定连接默认的catalog.

spring.datasource.default-read-only
是否设置默认连接只读.

spring.datasource.default-transaction-isolation
指定连接的事务的默认隔离级别.

spring.datasource.driver-class-name
指定driver的类名,默认从jdbc url中自动探测.

spring.datasource.fair-queue
是否采用FIFO返回连接.

spring.datasource.health-check-properties.[key]
使用Hikari connection pool时,在心跳检查时传递的属性

spring.datasource.idle-timeout
指定连接多久没被使用时,被设置为空闲,默认为10ms

spring.datasource.ignore-exception-on-pre-load
当初始化连接池时,是否忽略异常.

spring.datasource.init-sql
当连接创建时,执行的sql

spring.datasource.initial-size
指定启动连接池时,初始建立的连接数量

spring.datasource.initialization-fail-fast
当创建连接池时,没法创建指定最小连接数量是否抛异常

spring.datasource.initialize
指定初始化数据源,是否用data.sql来初始化,默认: true

spring.datasource.isolate-internal-queries
指定内部查询是否要被隔离,默认为false

spring.datasource.jdbc-interceptors
使用Tomcat connection pool时,指定jdbc拦截器,分号分隔

spring.datasource.jdbc-url
指定JDBC URL.

spring.datasource.jmx-enabled
是否开启JMX,默认为: false

spring.datasource.jndi-name
指定jndi的名称.

spring.datasource.leak-detection-threshold
使用Hikari connection pool时,多少毫秒检测一次连接泄露.

spring.datasource.log-abandoned
使用DBCP connection pool,是否追踪废弃statement或连接,默认为: false

spring.datasource.log-validation-errors
当使用Tomcat connection pool是否打印校验错误.

spring.datasource.login-timeout
指定连接数据库的超时时间.

spring.datasource.max-active
指定连接池中最大的活跃连接数.

spring.datasource.max-age
指定连接池中连接的最大年龄

spring.datasource.max-idle
指定连接池最大的空闲连接数量.

spring.datasource.max-lifetime
指定连接池中连接的最大生存时间,毫秒单位.

spring.datasource.max-open-prepared-statements
指定最大的打开的prepared statements数量.

spring.datasource.max-wait
指定连接池等待连接返回的最大等待时间,毫秒单位.

spring.datasource.maximum-pool-size
指定连接池最大的连接数,包括使用中的和空闲的连接.

spring.datasource.min-evictable-idle-time-millis
指定一个空闲连接最少空闲多久后可被清除.

spring.datasource.min-idle
指定必须保持连接的最小值(For DBCP and Tomcat connection pools)

spring.datasource.minimum-idle
指定连接维护的最小空闲连接数,当使用HikariCP时指定.

spring.datasource.name
指定数据源名.

spring.datasource.num-tests-per-eviction-run
指定运行每个idle object evictor线程时的对象数量

spring.datasource.password
指定数据库密码.

spring.datasource.platform
指定schema要使用的Platform(schema-${platform}.sql),默认为: all

spring.datasource.pool-name
指定连接池名字.

spring.datasource.pool-prepared-statements
指定是否池化statements.

spring.datasource.propagate-interrupt-state
在等待连接时,如果线程被中断,是否传播中断状态.

spring.datasource.read-only
当使用Hikari connection pool时,是否标记数据源只读

spring.datasource.register-mbeans
指定Hikari connection pool是否注册JMX MBeans.

spring.datasource.remove-abandoned
指定当连接超过废弃超时时间时,是否立刻删除该连接.

spring.datasource.remove-abandoned-timeout
指定连接应该被废弃的时间.

spring.datasource.rollback-on-return
在归还连接时,是否回滚等待中的事务.

spring.datasource.schema
指定Schema (DDL)脚本.

spring.datasource.separator
指定初始化脚本的语句分隔符,默认: ;

spring.datasource.sql-script-encoding
指定SQL scripts编码.

spring.datasource.suspect-timeout
指定打印废弃连接前的超时时间.

spring.datasource.test-on-borrow
当从连接池借用连接时,是否测试该连接.

spring.datasource.test-on-connect
创建时,是否测试连接

spring.datasource.test-on-return
在连接归还到连接池时是否测试该连接.

spring.datasource.test-while-idle
当连接空闲时,是否执行连接测试.

spring.datasource.time-between-eviction-runs-millis
指定空闲连接检查、废弃连接清理、空闲连接池大小调整之间的操作时间间隔

spring.datasource.transaction-isolation
指定事务隔离级别,使用Hikari connection pool时指定

spring.datasource.url
指定JDBC URL.

spring.datasource.use-disposable-connection-facade
是否对连接进行包装,防止连接关闭之后被使用.

spring.datasource.use-equals
比较方法名时是否使用String.equals()替换==.

spring.datasource.use-lock
是否对连接操作加锁

spring.datasource.username
指定数据库名.

spring.datasource.validation-interval
指定多少ms执行一次连接校验.

spring.datasource.validation-query
指定获取连接时连接校验的sql查询语句.

spring.datasource.validation-query-timeout
指定连接校验查询的超时时间.

spring.datasource.validation-timeout
设定连接校验的超时时间,当使用Hikari connection pool时指定

spring.datasource.validator-class-name
用来测试查询的validator全限定名.

spring.datasource.xa.data-source-class-name
指定数据源的全限定名.

spring.datasource.xa.properties
指定传递给XA data source的属性

JPA

spring.jpa.database
指定目标数据库.

spring.jpa.database-platform
指定目标数据库的类型.

spring.jpa.generate-ddl
是否在启动时初始化schema,默认为false

spring.jpa.hibernate.ddl-auto
指定DDL mode (none, validate, update, create, create-drop). 当使用内嵌数据库时,默认是create-drop,否则为none.

spring.jpa.hibernate.naming-strategy
指定命名策略.

spring.jpa.open-in-view
是否注册OpenEntityManagerInViewInterceptor,绑定JPA EntityManager到请求线程中,默认为: true

spring.jpa.properties
添加额外的属性到JPA provider.

spring.jpa.show-sql
是否开启sql的log,默认为: false

jooq

spring.jooq.sql-dialect
指定JOOQ使用的SQLDialect,比如POSTGRES.

h2

spring.h2.console.enabled
是否开启控制台,默认为false

spring.h2.console.path
指定控制台路径,默认为: /h2-console

JTA

spring.jta.allow-multiple-lrc
是否允许 multiple LRC,默认为: false

spring.jta.asynchronous2-pc
指定两阶段提交是否可以异步,默认为: false

spring.jta.background-recovery-interval
指定多少分钟跑一次recovery process,默认为: 1

spring.jta.background-recovery-interval-seconds
指定多久跑一次recovery process,默认: 60

spring.jta.current-node-only-recovery
是否过滤掉其他非本JVM的recovery,默认为: true

spring.jta.debug-zero-resource-transaction
是否追踪没有使用指定资源的事务,默认为: false

spring.jta.default-transaction-timeout
设定默认的事务超时时间,默认为60

spring.jta.disable-jmx
是否禁用jmx,默认为false

spring.jta.enabled
是否开启JTA support,默认为: true

spring.jta.exception-analyzer
设置指定的异常分析类

spring.jta.filter-log-status
使用Bitronix Transaction Manager时,是否写mandatory logs,开启的话,可以节省磁盘空间,但是调试会复杂写,默认为false

spring.jta.force-batching-enabled
使用Bitronix Transaction Manager时,是否批量写磁盘,默认为true.

spring.jta.forced-write-enabled
使用Bitronix Transaction Manager时,是否强制写日志到磁盘,默认为true

spring.jta.graceful-shutdown-interval
当使用Bitronix Transaction Manager,指定shutdown时等待事务结束的时间,超过则中断,默认为60

spring.jta.jndi-transaction-synchronization-registry-name
当使用Bitronix Transaction Manager时,在JNDI下得事务同步registry,默认为: java:comp/TransactionSynchronizationRegistry

spring.jta.jndi-user-transaction-name
指定在JNDI使用Bitronix Transaction Manager的名称,默认:java:comp/UserTransaction

spring.jta.journal
当使用Bitronix Transaction Manager,指定The journal是否disk还是null还是一个类的全限定名,默认disk

spring.jta.log-dir
Transaction logs directory.

spring.jta.log-part1-filename
指定The journal fragment文件1的名字,默认: btm1.tlog

spring.jta.log-part2-filename
指定The journal fragment文件2的名字,默认: btm2.tlog

spring.jta.max-log-size-in-mb
指定journal fragments大小的最大值. 默认: 2M

spring.jta.resource-configuration-filename
指定Bitronix Transaction Manager配置文件名.

spring.jta.server-id
指定Bitronix Transaction Manager实例的id.

spring.jta.skip-corrupted-logs
是否忽略corrupted log files文件,默认为false.

spring.jta.transaction-manager-id
指定Transaction manager的唯一标识.

spring.jta.warn-about-zero-resource-transaction
当使用Bitronix Transaction Manager时,是否对没有使用指定资源的事务进行警告,默认为: true
<think>首先,用户的问题是关于查找Spring Boot多数据源DataSource配置方法。查询是:"请问Spring Boot多数据源DataSource配置"。 参考系统指令: - 所有行内数学表达式必须使用$...$格式。 - 独立公式必须使用$$...$$格式。 - LaTeX语法正确。 - 使用中文回答。 - 生成相关问题。 - 回答中引用的段落末尾自然地添加引用标识。 另外,用户提供了站内引用: - 引用[1]:讨论Spring Boot多数据源配置的概述。 - 引用[2]:提供具体的代码示例,配置多个数据源的Bean。 - 引用[3]:简要提到单个数据源配置- 引用[4]:另一个配置示例,涉及MapperScan。 从这些引用中,重点是配置多个数据源的具体方法。我需要从中提取相关信息来回答用户的问题。 关键点从引用中: - 引用[2] 提供了核心代码:使用@Configuration类,定义多个DataSource Bean,每个用@Bean注解,并指定配置前缀。 - 引用[4] 补充了MyBatis的配置,如SqlSessionFactory和事务管理器。 用户的问题是具体的:"Spring Boot多数据源DataSource配置",所以我需要专注于如何配置DataSource本身。引用[2] 直接提供了这个。 回答结构应该清晰,逐步解决问题: 1. 概述多数据源配置的基本步骤。 2. 提供代码示例。 3. 解释关键部分。 4. 生成相关问题。 使用中文回答。 在回答末尾自然地添加引用标识。例如,如果引用代码来自[2],就在那段代码后加[^2]。 最后,生成相关问题。 组织回答: - 先简要介绍。 - 然后分步骤解释配置方法,包括代码。 - 确保代码格式正确(使用代码块)。 - 结尾添加相关问题。 代码示例:从引用[2]中提取并呈现。 独立公式:问题中没有数学相关内容,所以可能不需要。但如果用户提到方程等,我会处理。这里看起来纯技术问题,跳过LaTeX。 生成相关问题: - 基于主题,如优化、常见问题、事务管理等。 完整回答框架: 1. **简介**:解释多数据源配置的好处和基本概念。 2. **配置步骤**: - 添加依赖。 - 创建配置类。 - 定义多个DataSource Bean。 - 配置属性文件。 - 事务管理(如果需要)。 3. **代码示例**:展示核心代码。 4. **总结**。 5. **相关问题**。 引用标识:在解释引用内容时添加。 </think>### Spring Boot多数据源DataSource配置方法 在Spring Boot项目中,配置多数据源DataSource可以帮助支持复杂的业务场景,如读写分离、分库分表或多租户系统。核心方法是定义一个或多个DataSource Bean,并通过属性文件指定连接参数。下面我将基于引用内容,逐步说明配置步骤,确保回答可靠且实用。 #### 1. **添加依赖** 首先,确保项目中包含必要的依赖。Spring Boot Starter Data JDBC或Spring Boot Starter Data JPA是基础: ```xml <!-- pom.xml 示例 --> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <!-- 如果使用MyBatis,添加 --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> </dependencies> ``` #### 2. **创建配置类定义DataSource Bean** 核心是通过一个@Configuration类定义多个DataSource Bean,每个Bean对应一个数据源。使用@Primary注解标记主数据源。代码示例基于引用[2]和[^4]: ```java import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.boot.jdbc.DataSourceBuilder; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary; import javax.sql.DataSource; @Configuration public class DataSourceConfig { // 主数据源配置 @Bean(name = "primaryDataSource") @Primary // 标记为主数据源 @ConfigurationProperties(prefix = "spring.datasource.primary") // 绑定属性前缀 public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); // 自动构建DataSource } // 次数据源配置 @Bean(name = "secondaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.secondary") // 绑定属性前缀 public DataSource secondaryDataSource() { return DataSourceBuilder.create().build(); } } ``` - **解释**:每个@Bean方法定义一个DataSource,@ConfigurationProperties读取属性文件中以指定前缀开头的配置(如数据库URL、用户名)。@Primary确保事务管理器默认使用主数据源[^2][^4]。 #### 3. **配置属性文件** 在`application.properties`或`application.yml`中定义数据源详细信息: ```properties # 主数据源配置 spring.datasource.primary.url=jdbc:mysql://localhost:3306/db_primary spring.datasource.primary.username=root spring.datasource.primary.password=password spring.datasource.primary.driver-class-name=com.mysql.cj.jdbc.Driver # 次数据源配置 spring.datasource.secondary.url=jdbc:mysql://localhost:3306/db_secondary spring.datasource.secondary.username=root spring.datasource.secondary.password=password spring.datasource.secondary.driver-class-name=com.mysql.cj.jdbc.Driver ``` - **注意事项**:属性前缀必须匹配代码中的@ConfigurationProperties前缀。如果使用其他数据库(如PostgreSQL),调整URL和驱动类[^1][^3]。 #### 4. **配置事务和MyBatis(可选)** 如果使用MyBatis或JPA,需要额外配置SqlSessionFactory和事务管理器,以避免冲突。基于引用[2]和[^4]: ```java import org.apache.ibatis.session.SqlSessionFactory; import org.mybatis.spring.SqlSessionFactoryBean; import org.springframework.context.annotation.Bean; import org.springframework.jdbc.datasource.DataSourceTransactionManager; import org.springframework.transaction.PlatformTransactionManager; import javax.sql.DataSource; @Configuration public class MyBatisConfig { // 主数据源的SqlSessionFactory @Bean(name = "mainSessionFactory") public SqlSessionFactory mainSqlSessionFactory(DataSource primaryDataSource) throws Exception { SqlSessionFactoryBean sessionFactoryBean = new SqlSessionFactoryBean(); sessionFactoryBean.setDataSource(primaryDataSource); return sessionFactoryBean.getObject(); } // 主数据源的事务管理器 @Bean public PlatformTransactionManager primaryTransactionManager(DataSource primaryDataSource) { return new DataSourceTransactionManager(primaryDataSource); } // 次数据源的事务管理器(如果需要) @Bean public PlatformTransactionManager secondaryTransactionManager(DataSource secondaryDataSource) { return new DataSourceTransactionManager(secondaryDataSource); } } ``` - **解释**:每个SqlSessionFactory绑定到特定的DataSource。事务管理器确保操作的一致性。在MapperScan中指定对应的SqlSessionFactoryRef,如引用[4]所示[^2][^4]。 #### 5. **使用和验证** - 在Service或DAO层,通过@Qualifier注入特定数据源: ```java @Service public class MyService { @Autowired @Qualifier("primaryDataSource") private DataSource primaryDataSource; @Autowired @Qualifier("secondaryDataSource") private DataSource secondaryDataSource; } ``` - 启动应用检查日志:确保没有数据源冲突错误。Spring Boot会自动加载Bean[^1][^3]。 #### 总结 配置多数据源DataSource的核心是定义多个@Bean并使用属性文件绑定参数。这种方法灵活扩展性强,适合高并发系统。实践中,确保事务管理正确以避免脏读或死锁[^1][^2]。更多细节可参考[Spring Boot官方文档](https://docs.spring.io/spring-boot/docs/current/reference/html/data.html)
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值