百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

SpringBoot + MyBatisPlus 实现多租户分库

wptr33 2024-12-15 17:12 62 浏览

引言

在如今的软件开发中,多租户(Multi-Tenancy)应用已经变得越来越常见。多租户是一种软件架构技术,它允许一个应用程序实例为多个租户提供服务。每个租户都有自己的数据和配置,但应用程序实例是共享的。而在我们的Spring Boot + MyBatis Plus环境中,我们可以利用动态数据源来实现多租户分库。

实现原理

SpringBoot + MyBatisPlus 动态数据源实现多租户分库的原理主要是通过切换不同的数据库连接来实现。对于每个租户,应用程序会使用一个独立的数据库连接,这样每个租户就拥有了自己的数据隔离空间。具体来说,当我们创建一个新的租户时,我们同时也为这个租户创建一个新的数据库连接。这些数据库连接被存储在一个数据源工厂中,我们可以根据租户的ID或者其他唯一标识符来获取对应的数据库连接。当一个租户需要访问其数据时,我们从数据源工厂中获取该租户对应的数据库连接,然后使用这个连接来执行数据库操作。

示例代码

在pom.xml中添加依赖

确保你的 `pom.xml` 中包含了以下依赖:

<dependencies>
    <!-- Spring Boot Web Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- MyBatis Plus Starter -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.4.3.3</version> <!-- 替换为最新版本 -->
    </dependency>

    <!-- Druid 数据源 -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid-spring-boot-starter</artifactId>
        <version>1.2.6</version> <!-- 替换为最新版本 -->
    </dependency>

    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
</dependencies>

接下来,我们按步骤创建一个多租户分库的示例:

数据库表结构

创建一个数据库表来存储多租户的数据源配置信息。

CREATE TABLE tenant_datasource (

    tenant_id VARCHAR(50) PRIMARY KEY,
    url VARCHAR(255),
    username VARCHAR(50),
    password VARCHAR(50)
);

数据源配置

在 `application.properties` 或 `application.yml` 中配置默认的数据源信息。

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/default_db
    username: root
    password: root

实现动态数据源配置

创建一个动态数据源配置类,用于动态切换数据源。

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "spring.datasource")
public class DynamicDataSourceProperties {

    private String url;
    private String username;
    private String password;
    // Getters and Setters
    // 根据配置创建数据源
    public DataSource createDataSource() {
        return DataSourceBuilder.create()
                .url(this.url)
                .username(this.username)
                .password(this.password)
                .build();
    }
}

创建动态数据源

创建一个动态数据源类,继承 `AbstractRoutingDataSource`,用于动态切换数据源。

import org.springframework.jdbc.datasource.lookup.AbstractRoutingDataSource;

public class DynamicDataSource extends AbstractRoutingDataSource {

    @Override
    protected Object determineCurrentLookupKey() {
        return TenantContext.getTenantId();
    }
}

创建租户上下文

创建一个租户上下文类,用于存储当前线程的租户标识。

public class TenantContext {

    private static ThreadLocal<String> tenantId = ThreadLocal.withInitial(() -> "default");

    public static String getTenantId() {
        return tenantId.get();
    }

    public static void setTenantId(String id) {
        tenantId.set(id);
    }

    public static void clear() {
        tenantId.remove();
    }
}

创建数据源管理器

创建一个数据源管理器,用于动态切换数据源。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;
import javax.sql.DataSource;
import java.util.HashMap;
import java.util.Map;

@Component
public class DataSourceManager {

    @Autowired
    private DynamicDataSourceProperties dynamicDataSourceProperties;
    private final Map<String, DataSource> dataSources = new HashMap<>();

    @PostConstruct
    public void init() {
        // 根据配置创建数据源并加入管理器
        dataSources.put("default", dynamicDataSourceProperties.createDataSource());
    }
    public void addDataSource(String tenantId, DataSource dataSource) {
        dataSources.put(tenantId, dataSource);
    }
    public DataSource getDataSource(String tenantId) {
        return dataSources.get(tenantId);
    }
}

创建数据源配置类

创建数据源配置类,用于配置动态数据源。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import java.util.HashMap;
import java.util.Map;

@Configuration
public class DynamicDataSourceConfig {

    @Autowired
    private DataSourceManager dataSourceManager;

    @Bean
    public DynamicDataSource dynamicDataSource() {
        DynamicDataSource dynamicDataSource = new DynamicDataSource();
        Map<Object, Object> targetDataSources = new HashMap<>();
        targetDataSources.putAll(dataSourceManager.getAllDataSources());
        dynamicDataSource.setTargetDataSources(targetDataSources);
        dynamicDataSource.setDefaultTargetDataSource(dataSourceManager.getDataSource("default"));
        return dynamicDataSource;
    }

    @Bean
    public DataSourceTransactionManager transactionManager(DynamicDataSource dynamicDataSource) {
        return new DataSourceTransactionManager(dynamicDataSource);
    }
}

创建 MyBatis 配置

创建 MyBatis 配置类,配置 MyBatis Plus 的分页插件。

import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
        return interceptor;
    }
}

创建多租户数据源服务

创建多租户数据源服务类,用于初始化多租户数据源。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import javax.annotation.PostConstruct;
import javax.sql.DataSource;
import java.util.List;

@Service
public class MultiTenantDataSourceService {

    @Autowired
    private DataSourceManager dataSourceManager;

    @Autowired
    private TenantDataSourceRepository tenantDataSourceRepository;

    @PostConstruct
    public void initialize() {
        List<TenantDataSource> tenantDataSources = tenantDataSourceRepository.findAll();
        for (TenantDataSource tenantDataSource : tenantDataSources) {
            DataSource dataSource = tenantDataSource.createDataSource();
            dataSourceManager.addDataSource(tenantDataSource.getTenantId(), dataSource);
        }
    }
}

创建多租户数据源实体类和 Repository

创建多租户数据源实体类和对应的 Repository 接口。

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;

@Entity
@Table(name = "tenant_datasource")
public class TenantDataSource {

    @Id
    @Column(name = "tenant_id")
    private String tenantId;

    private String url;

    private String username;

    private String password;

    // Getters and Setters

}
import org.springframework.data.jpa.repository.JpaRepository;

public interface TenantDataSourceRepository extends JpaRepository<TenantDataSource, String> {
}

创建业务服务类

创建一个业务服务类,用于处理业务逻辑。

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService extends ServiceImpl<UserMapper, User> {

    @Autowired
    private DataSourceManager dataSourceManager;

    public User getUserById(Long id) {
        String tenantId = TenantContext.getTenantId();
        DataSource dataSource = dataSourceManager.getDataSource(tenantId);
        // 设置当前数据源
        DataSourceContextHolder.setDataSource(dataSource);
        return getById(id);
    }
}

创建 Controller

创建一个 Controller 用于测试多租户分库功能。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/user/{tenantId}/{userId}")
    public User getUser(@PathVariable String tenantId, @PathVariable Long userId) {
        // 切换租户
        TenantContext.setTenantId(tenantId);
        // 查询用户
        return userService.getUserById(userId);
    }
}

多租户数据源配置表

在数据库中插入多租户的数据源配置信息,例如:

INSERT INTO tenant_datasource (tenant_id, url, username, password)
VALUES ('tenant1', 'jdbc:mysql://localhost:3306/tenant1_db', 'root', 'password1');

INSERT INTO tenant_datasource (tenant_id, url, username, password)
VALUES ('tenant2', 'jdbc:mysql://localhost:3306/tenant2_db', 'root', 'password2');

测试多租户分库功能

启动 Spring Boot 应用程序,通过访问 http://localhost:8080/user/{tenantId}/{userId} 来测试多租户分库功能。这样就完成了一个简单的 Spring Boot + MyBatis Plus 多租户分库的示例。在实际项目中,你需要根据业务需求进一步完善和优化代码。如果有任何问题或需要进一步解释,请随时提出。

适用场景

1. 多租户系统开发:适用于多租户系统,每个租户有独立的数据库,通过动态数据源切换实现多租户数据隔离。

2. 租户级数据隔离:当多个租户共享同一应用但需要数据隔离时,可以通过此模式实现。

3. 灵活扩展:适用于系统需求可能动态扩展租户,每个租户有独立数据库的场景,不需修改系统架构。

优点

1. 数据隔离性强:每个租户有独立的数据库,数据隔离,保护租户数据安全。

2. 性能优化:每个租户有独立的数据库,避免多租户共享同一数据库的性能瓶颈。

3. 方便扩展:可以轻松实现动态增加新租户,每个租户有独立的数据库。

4. 可维护性高:MyBatisPlus提供了便捷的操作数据库的功能,减少开发人员的工作量。

5. 易用性强:Spring Boot集成MyBatisPlus,简化了配置和集成流程,提高开发效率。

总结

Spring Boot与MyBatisPlus结合,通过动态数据源实现多租户分库,是一种高效、灵活、易维护的解决方案,适用于多租户系统的开发。可以有效地保护租户数据安全,提高系统性能,同时具有良好的可扩展性和可维护性。

相关推荐

MySQL进阶五之自动读写分离mysql-proxy

自动读写分离目前,大量现网用户的业务场景中存在读多写少、业务负载无法预测等情况,在有大量读请求的应用场景下,单个实例可能无法承受读取压力,甚至会对业务产生影响。为了实现读取能力的弹性扩展,分担数据库压...

Postgres vs MySQL_vs2022连接mysql数据库

...

3分钟短文 | Laravel SQL筛选两个日期之间的记录,怎么写?

引言今天说一个细分的需求,在模型中,或者使用laravel提供的EloquentORM功能,构造查询语句时,返回位于两个指定的日期之间的条目。应该怎么写?本文通过几个例子,为大家梳理一下。学习时...

一文由浅入深带你完全掌握MySQL的锁机制原理与应用

本文将跟大家聊聊InnoDB的锁。本文比较长,包括一条SQL是如何加锁的,一些加锁规则、如何分析和解决死锁问题等内容,建议耐心读完,肯定对大家有帮助的。为什么需要加锁呢?...

验证Mysql中联合索引的最左匹配原则

后端面试中一定是必问mysql的,在以往的面试中好几个面试官都反馈我Mysql基础不行,今天来着重复习一下自己的弱点知识。在Mysql调优中索引优化又是非常重要的方法,不管公司的大小只要后端项目中用到...

MySQL索引解析(联合索引/最左前缀/覆盖索引/索引下推)

目录1.索引基础...

你会看 MySQL 的执行计划(EXPLAIN)吗?

SQL执行太慢怎么办?我们通常会使用EXPLAIN命令来查看SQL的执行计划,然后根据执行计划找出问题所在并进行优化。用法简介...

MySQL 从入门到精通(四)之索引结构

索引概述索引(index),是帮助MySQL高效获取数据的数据结构(有序),在数据之外,数据库系统还维护者满足特定查询算法的数据结构,这些数据结构以某种方式引用(指向)数据,这样就可以在这些数据结构...

mysql总结——面试中最常问到的知识点

mysql作为开源数据库中的榜一大哥,一直是面试官们考察的重中之重。今天,我们来总结一下mysql的知识点,供大家复习参照,看完这些知识点,再加上一些边角细节,基本上能够应付大多mysql相关面试了(...

mysql总结——面试中最常问到的知识点(2)

首先我们回顾一下上篇内容,主要复习了索引,事务,锁,以及SQL优化的工具。本篇文章接着写后面的内容。性能优化索引优化,SQL中索引的相关优化主要有以下几个方面:最好是全匹配。如果是联合索引的话,遵循最...

MySQL基础全知全解!超详细无废话!轻松上手~

本期内容提醒:全篇2300+字,篇幅较长,可搭配饭菜一同“食”用,全篇无废话(除了这句),干货满满,可收藏供后期反复观看。注:MySQL中语法不区分大小写,本篇中...

深入剖析 MySQL 中的锁机制原理_mysql 锁详解

在互联网软件开发领域,MySQL作为一款广泛应用的关系型数据库管理系统,其锁机制在保障数据一致性和实现并发控制方面扮演着举足轻重的角色。对于互联网软件开发人员而言,深入理解MySQL的锁机制原理...

Java 与 MySQL 性能优化:MySQL分区表设计与性能优化全解析

引言在数据库管理领域,随着数据量的不断增长,如何高效地管理和操作数据成为了一个关键问题。MySQL分区表作为一种有效的数据管理技术,能够将大型表划分为多个更小、更易管理的分区,从而提升数据库的性能和可...

MySQL基础篇:DQL数据查询操作_mysql 查

一、基础查询DQL基础查询语法SELECT字段列表FROM表名列表WHERE条件列表GROUPBY分组字段列表HAVING分组后条件列表ORDERBY排序字段列表LIMIT...

MySql:索引的基本使用_mysql索引的使用和原理

一、索引基础概念1.什么是索引?索引是数据库表的特殊数据结构(通常是B+树),用于...