spring-boot多数据源配置示例

在Spring Boot应用中，多数据源配置是一项常见的需求，尤其在大型系统中，可能需要连接到不同的数据库以实现数据隔离或者实现读写分离。本文将详细介绍如何在Spring Boot项目中配置多个数据源，并通过实际的代码示例进行解析。 我们需要理解Spring Boot的核心理念是简化Spring应用的初始搭建以及配置工作。它提供了自动配置和起步依赖功能，使得开发者能够快速地创建一个运行的Spring应用。在多数据源配置中，Spring Boot同样提供了便利的方式。 1. **配置文件** Spring Boot允许我们在`application.properties`或`application.yml`中定义多个数据源。例如，我们可以为两个数据源分别定义`primary`和`secondary`： ```properties # application.properties 示例 spring.datasource.primary.url=jdbc:mysql://localhost:3306/main_db spring.datasource.primary.username=root spring.datasource.primary.password=root spring.datasource.primary.driver-class-name=com.mysql.jdbc.Driver spring.datasource.secondary.url=jdbc:mysql://localhost:3306/secondary_db spring.datasource.secondary.username=root spring.datasource.secondary.password=root spring.datasource.secondary.driver-class-name=com.mysql.jdbc.Driver ``` 或者使用YAML格式： ```yaml # application.yml 示例 spring: datasource: primary: url: jdbc:mysql://localhost:3306/main_db username: root password: root driver-class-name: com.mysql.jdbc.Driver secondary: url: jdbc:mysql://localhost:3306/secondary_db username: root password: root driver-class-name: com.mysql.jdbc.Driver ``` 2. **配置数据源** 在Spring Boot中，我们可以通过`@ConfigurationProperties`注解来绑定配置文件中的数据源属性，然后使用`@Bean`注解来创建数据源对象： ```java @Configuration @EnableConfigurationProperties({DataSourceProperties.class}) public class DataSourceConfig { @Autowired private DataSourceProperties primaryDataSourceProperties; @Autowired private DataSourceProperties secondaryDataSourceProperties; @Bean(name = "primaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.primary") public DataSource primaryDataSource() { return primaryDataSourceProperties.initializeDataSourceBuilder().build(); } @Bean(name = "secondaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.secondary") public DataSource secondaryDataSource() { return secondaryDataSourceProperties.initializeDataSourceBuilder().build(); } } ``` 3. **配置事务管理器** 对于多数据源，我们需要配置多个事务管理器。Spring Boot提供了`PlatformTransactionManager`接口的实现，如`DataSourceTransactionManager`。我们可以为每个数据源创建一个事务管理器： ```java @Configuration public class TransactionConfig { @Autowired @Qualifier("primaryDataSource") private DataSource primaryDataSource; @Autowired @Qualifier("secondaryDataSource") private DataSource secondaryDataSource; @Bean(name = "primaryTransactionManager") public PlatformTransactionManager primaryTransactionManager() { return new DataSourceTransactionManager(primaryDataSource); } @Bean(name = "secondaryTransactionManager") public PlatformTransactionManager secondaryTransactionManager() { return new DataSourceTransactionManager(secondaryDataSource); } } ``` 4. **使用数据源** 在业务逻辑中，我们可以使用`@Qualifier`注解来指定使用哪个数据源： ```java @Service public class UserService { @Autowired @Qualifier("primaryDataSource") private JdbcTemplate primaryJdbcTemplate; @Autowired @Qualifier("secondaryDataSource") private JdbcTemplate secondaryJdbcTemplate; // ... } ``` 5. **读写分离** 如果你想实现读写分离，可以定义主数据源作为写操作，次数据源用于读取操作。你可以使用AOP（面向切面编程）来实现这一策略，例如，创建一个自定义注解`@ReadFromSecondary`，并在切面中根据这个注解决定使用哪个数据源。 ```java @Aspect @Component public class DataSourceSwitcherAspect { @Autowired @Qualifier("primaryDataSource") private DataSource primaryDataSource; @Autowired @Qualifier("secondaryDataSource") private DataSource secondaryDataSource; @Around("@annotation(readFromSecondary)") public Object switchDataSource(ProceedingJoinPoint joinPoint, @ReadFromSecondary boolean readFromSecondary) throws Throwable { DataSource targetDataSource = readFromSecondary ? secondaryDataSource : primaryDataSource; ThreadLocalDataSourceHolder.setDataSource(targetDataSource); try { return joinPoint.proceed(); } finally { ThreadLocalDataSourceHolder.clearDataSource(); } } } ``` 6. **注意事项** - 在多数据源配置时，确保每个数据源的bean名称唯一，以便在其他组件中正确引用。 - 使用`@Transactional`注解时，需要指定事务管理器，如`@Transactional(value = "primaryTransactionManager")`。 - 考虑到性能和并发，合理设计数据源切换策略，避免不必要的数据源切换。 通过以上步骤，你可以在Spring Boot项目中成功配置并使用多数据源。`spring-boot配置多数据源.docx`文件和`DataSourceDemo`示例代码将提供更详细的实践指导，帮助你深入理解和应用这些概念。