【亲测免费】 SpringBoot-DynamicDataSource 使用教程

项目介绍

SpringBoot-DynamicDataSource 是一个用于 Spring Boot 项目的动态数据源管理库。它支持多数据源配置，包括主从分离、读写分离和分布式事务等功能。该项目旨在简化在 Spring Boot 应用中管理多个数据源的复杂性，提供了一种灵活且高效的方式来处理数据源切换和配置。

项目快速启动

1. 添加依赖

首先，在您的 Spring Boot 项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.github.helloworlde</groupId>
    <artifactId>spring-boot-dynamic-datasource</artifactId>
    <version>最新版本</version>
</dependency>

2. 配置数据源

在 application.yml 文件中配置您的数据源信息：

spring:
  datasource:
    dynamic:
      primary: master
      strict: false
      datasource:
        master:
          url: jdbc:mysql://localhost:3306/master_db
          username: root
          password: 123456
          driver-class-name: com.mysql.cj.jdbc.Driver
        slave_1:
          url: jdbc:mysql://localhost:3307/slave_db_1
          username: root
          password: 123456
          driver-class-name: com.mysql.cj.jdbc.Driver
        slave_2:
          url: jdbc:mysql://localhost:3308/slave_db_2
          username: root
          password: 123456
          driver-class-name: com.mysql.cj.jdbc.Driver

3. 创建数据源配置类

创建一个数据源配置类来初始化动态数据源：

import com.baomidou.dynamic.datasource.DynamicRoutingDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.sql.DataSource;

@Configuration
public class DataSourceConfig {

    @Bean
    public DataSource dataSource() {
        return new DynamicRoutingDataSource();
    }
}

4. 使用动态数据源

在您的服务类中使用 @DS 注解来切换数据源：

import com.baomidou.dynamic.datasource.annotation.DS;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @DS("master")
    public void saveUser() {
        // 保存用户到主数据库
    }

    @DS("slave_1")
    public void getUser() {
        // 从从数据库1读取用户
    }
}

应用案例和最佳实践

应用案例

假设您有一个电商系统，需要同时访问多个数据库，包括主数据库用于写操作，从数据库用于读操作。使用 SpringBoot-DynamicDataSource，您可以轻松实现这一需求。

最佳实践

1. 数据源分组：将数据源分组，例如将所有读操作的数据源分到一组，所有写操作的数据源分到另一组。
2. 严格匹配数据源：在生产环境中，建议开启严格匹配数据源模式，以确保数据源切换的准确性。
3. 优雅关闭数据源：在关闭应用时，确保所有数据源的连接都已正确关闭，避免资源泄漏。

典型生态项目

SpringBoot-DynamicDataSource 可以与以下生态项目集成，以提供更强大的功能：

1. MyBatis-Plus：简化 MyBatis 的使用，提供更多的 CRUD 操作。
2. Druid：阿里巴巴的数据库连接池，提供强大的监控和扩展功能。
3. Sharding-JDBC：分库分表中间件，支持水平拆分和垂直拆分。

通过这些集成，您可以构建一个高性能、可扩展的数据库访问层，满足复杂业务需求。