MybatisPlus 多租戶架構(Multi-tenancy)實現(xiàn)詳解

更新時間：2018年11月30日 09:28:14 作者：吳汶澤

這篇文章主要介紹了MybatisPlus 多租戶架構(Multi-tenancy)實現(xiàn)詳解，詳細的介紹了什么是多租戶架構以及使用MybatisPlus實現(xiàn)，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧

在進行多租戶架構(Multi-tenancy)實現(xiàn)之前，先了解一下相關的定義吧：

什么是多租戶

多租戶技術或稱多重租賃技術，簡稱SaaS，是一種軟件架構技術，是實現(xiàn)如何在多用戶環(huán)境下（此處的多用戶一般是面向企業(yè)用戶）共用相同的系統(tǒng)或程序組件，并且可確保各用戶間數(shù)據(jù)的隔離性。

簡單講：在一臺服務器上運行單個應用實例，它為多個租戶（客戶）提供服務。從定義中我們可以理解：多租戶是一種架構，目的是為了讓多用戶環(huán)境下使用同一套程序，且保證用戶間數(shù)據(jù)隔離。那么重點就很淺顯易懂了，多租戶的重點就是同一套程序下實現(xiàn)多用戶數(shù)據(jù)的隔離。

數(shù)據(jù)隔離方案

多租戶在數(shù)據(jù)存儲上存在三種主要的方案，分別是：

獨立數(shù)據(jù)庫

即一個租戶一個數(shù)據(jù)庫，這種方案的用戶數(shù)據(jù)隔離級別最高，安全性最好，但成本較高。

優(yōu)點：為不同的租戶提供獨立的數(shù)據(jù)庫，有助于簡化數(shù)據(jù)模型的擴展設計，滿足不同租戶的獨特需求；如果出現(xiàn)故障，恢復數(shù)據(jù)比較簡單。
缺點：增多了數(shù)據(jù)庫的安裝數(shù)量，隨之帶來維護成本和購置成本的增加。

共享數(shù)據(jù)庫，獨立 Schema

多個或所有租戶共享Database，但是每個租戶一個Schema（也可叫做一個user）。底層庫比如是：DB2、ORACLE等，一個數(shù)據(jù)庫下可以有多個SCHEMA。

優(yōu)點：為安全性要求較高的租戶提供了一定程度的邏輯數(shù)據(jù)隔離，并不是完全隔離；每個數(shù)據(jù)庫可支持更多的租戶數(shù)量。
缺點：如果出現(xiàn)故障，數(shù)據(jù)恢復比較困難，因為恢復數(shù)據(jù)庫將牽涉到其他租戶的數(shù)據(jù)；

共享數(shù)據(jù)庫，共享 Schema，共享數(shù)據(jù)表

即租戶共享同一個Database、同一個Schema，但在表中增加TenantID多租戶的數(shù)據(jù)字段。這是共享程度最高、隔離級別最低的模式。

簡單來講，即每插入一條數(shù)據(jù)時都需要有一個客戶的標識。這樣才能在同一張表中區(qū)分出不同客戶的數(shù)據(jù)，這也是我們系統(tǒng)目前用到的(provider_id)

優(yōu)點：三種方案比較，第三種方案的維護和購置成本最低，允許每個數(shù)據(jù)庫支持的租戶數(shù)量最多。
缺點：隔離級別最低，安全性最低，需要在設計開發(fā)時加大對安全的開發(fā)量；數(shù)據(jù)備份和恢復最困難，需要逐表逐條備份和還原。

利用MybatisPlus實現(xiàn)

這里我們選用了第三種方案（共享數(shù)據(jù)庫，共享 Schema，共享數(shù)據(jù)表）來實現(xiàn)，也就意味著，每個數(shù)據(jù)表都需要有一個租戶標識(provider_id)

現(xiàn)在有數(shù)據(jù)庫表(user)如下：

字段名	字段類型	描述
id	BIGINT(20)	主鍵
provider_id	BIGINT(20)	服務商ID
name	VARCHAR(30)	姓名

將provider_id視為租戶ID，用來隔離租戶與租戶之間的數(shù)據(jù)，如果要查詢當前服務商的用戶，SQL大致如下：

SELECT * FROM user t WHERE t.name LIKE '%Tom%' AND t.provider_id = 1;

試想一下，除了一些系統(tǒng)共用的表以外，其他租戶相關的表，我們都需要不厭其煩的加上AND t.provider_id = ?查詢條件，稍不注意就會導致數(shù)據(jù)越界，數(shù)據(jù)安全問題讓人擔憂。

好在有了MybatisPlus這個神器，可以極為方便的實現(xiàn)多租戶SQL解析器，官方文檔如下：
http://mp.baomidou.com/guide/tenant.html

這里終于進入了正題，開始搭建一個極為簡單的開發(fā)環(huán)境吧!

新建SpringBoot環(huán)境

POM文件如下，主要集成了MybatisPlus以及H2數(shù)據(jù)庫(方便測試)

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.wuwenze</groupId>
  <artifactId>mybatis-plus-multi-tenancy</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>mybatis-plus-multi-tenancy</name>
  <description>Demo project for Spring Boot</description>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.0.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>com.google.guava</groupId>
      <artifactId>guava</artifactId>
      <version>19.0</version>
    </dependency>

    <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus-boot-starter</artifactId>
      <version>3.0.5</version>
    </dependency>
    <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus</artifactId>
      <version>3.0.5</version>
    </dependency>
    <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus-generator</artifactId>
      <version>3.0.5</version>
    </dependency>

    <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

數(shù)據(jù)源配置(application.yml)

spring:
 datasource:
  driver-class-name: org.h2.Driver
  schema: classpath:db/schema.sql
  data: classpath:db/data.sql
  url: jdbc:h2:mem:test
  username: root
  password: test

logging:
 level:
  com.wuwenze.mybatisplusmultitenancy: debug

對應的H2數(shù)據(jù)庫初始化schema文件

#schema.sql
DROP TABLE IF EXISTS user;
CREATE TABLE user
(
  id BIGINT(20) NOT NULL COMMENT '主鍵',
  provider_id BIGINT(20) NOT NULL COMMENT '服務商ID',
  name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
  PRIMARY KEY (id)
);


#data.sql
INSERT INTO user (id, provider_id, name) VALUES (1, 1, 'Tony老師');
INSERT INTO user (id, provider_id, name) VALUES (2, 1, 'William老師');
INSERT INTO user (id, provider_id, name) VALUES (3, 2, '路人甲');
INSERT INTO user (id, provider_id, name) VALUES (4, 2, '路人乙');
INSERT INTO user (id, provider_id, name) VALUES (5, 2, '路人丙');
INSERT INTO user (id, provider_id, name) VALUES (6, 2, '路人丁');

MybatisPlus Config

基礎環(huán)境搭建完成，現(xiàn)在開始配置MybatisPlus多租戶相關的實現(xiàn)。

1) 核心配置：TenantSqlParser

@Configuration
@MapperScan("com.wuwenze.mybatisplusmultitenancy.mapper")
public class MybatisPlusConfig {

  private static final String SYSTEM_TENANT_ID = "provider_id";
  private static final List<String> IGNORE_TENANT_TABLES = Lists.newArrayList("provider");

  @Autowired
  private ApiContext apiContext;

  @Bean
  public PaginationInterceptor paginationInterceptor() {
    PaginationInterceptor paginationInterceptor = new PaginationInterceptor();

    // SQL解析處理攔截：增加租戶處理回調(diào)。
    TenantSqlParser tenantSqlParser = new TenantSqlParser()
        .setTenantHandler(new TenantHandler() {

          @Override
          public Expression getTenantId() {
            // 從當前系統(tǒng)上下文中取出當前請求的服務商ID，通過解析器注入到SQL中。
            Long currentProviderId = apiContext.getCurrentProviderId();
            if (null == currentProviderId) {
              throw new RuntimeException("#1129 getCurrentProviderId error.");
            }
            return new LongValue(currentProviderId);
          }

          @Override
          public String getTenantIdColumn() {
            return SYSTEM_TENANT_ID;
          }

          @Override
          public boolean doTableFilter(String tableName) {
            // 忽略掉一些表：如租戶表（provider）本身不需要執(zhí)行這樣的處理。
            return IGNORE_TENANT_TABLES.stream().anyMatch((e) -> e.equalsIgnoreCase(tableName));
          }
        });
    paginationInterceptor.setSqlParserList(Lists.newArrayList(tenantSqlParser));
    return paginationInterceptor;
  }

  @Bean(name = "performanceInterceptor")
  public PerformanceInterceptor performanceInterceptor() {
    return new PerformanceInterceptor();
  }
}

2) ApiContext

@Component
public class ApiContext {
  private static final String KEY_CURRENT_PROVIDER_ID = "KEY_CURRENT_PROVIDER_ID";
  private static final Map<String, Object> mContext = Maps.newConcurrentMap();

  public void setCurrentProviderId(Long providerId) {
    mContext.put(KEY_CURRENT_PROVIDER_ID, providerId);
  }

  public Long getCurrentProviderId() {
    return (Long) mContext.get(KEY_CURRENT_PROVIDER_ID);
  }
}

3) Entity、Mapper

@Data
@ToString
@Accessors(chain = true)
public class User {
  private Long id;
  private Long providerId;
  private String name;
}

public interface UserMapper extends BaseMapper<User> {

}

單元測試

com.wuwenze.mybatisplusmultitenancy.MybatisPlusMultiTenancyApplicationTests

@Slf4j
@RunWith(SpringRunner.class)
@FixMethodOrder(MethodSorters.JVM)
@SpringBootTest(classes = MybatisPlusMultiTenancyApplication.class)
public class MybatisPlusMultiTenancyApplicationTests {


  @Autowired
  private ApiContext apiContext;

  @Autowired
  private UserMapper userMapper;

  @Before
  public void before() {
    // 在上下文中設置當前服務商的ID
    apiContext.setCurrentProviderId(1L);
  }

  @Test
  public void insert() {
    User user = new User().setName("新來的Tom老師");
    Assert.assertTrue(userMapper.insert(user) > 0);

    user = userMapper.selectById(user.getId());
    log.info("#insert user={}", user);

    // 檢查插入的數(shù)據(jù)是否自動填充了租戶ID
    Assert.assertEquals(apiContext.getCurrentProviderId(), user.getProviderId());
  }

  @Test
  public void selectList() {
    userMapper.selectList(null).forEach((e) -> {
      log.info("#selectList, e={}", e);
      // 驗證查詢的數(shù)據(jù)是否超出范圍
      Assert.assertEquals(apiContext.getCurrentProviderId(), e.getProviderId());
    });
  }
}

運行結(jié)果

2018-11-29 21:07:14.262 INFO 18688 --- [      main] .MybatisPlusMultiTenancyApplicationTests : Started MybatisPlusMultiTenancyApplicationTests in 2.629 seconds (JVM running for 3.904)
2018-11-29 21:07:14.554 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.insert      : ==> Preparing: INSERT INTO user (id, name, provider_id) VALUES (?, ?, 1)
2018-11-29 21:07:14.577 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.insert      : ==> Parameters: 1068129257418178562(Long), 新來的Tom老師(String)
2018-11-29 21:07:14.577 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.insert      : <==  Updates: 1
 Time：0 ms - ID：com.wuwenze.mybatisplusmultitenancy.mapper.UserMapper.insert
Execute SQL：INSERT INTO user (id, name, provider_id) VALUES (?, ?, 1) {1: 1068129257418178562, 2: STRINGDECODE('\u65b0\u6765\u7684Tom\u8001\u5e08')}

2018-11-29 21:07:14.585 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectById    : ==> Preparing: SELECT id, provider_id, name FROM user WHERE user.provider_id = 1 AND id = ?
2018-11-29 21:07:14.595 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectById    : ==> Parameters: 1068129257418178562(Long)
2018-11-29 21:07:14.614 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectById    : <==   Total: 1
2018-11-29 21:07:14.615 INFO 18688 --- [      main] .MybatisPlusMultiTenancyApplicationTests : #insert user=User(id=1068129257418178562, providerId=1, name=新來的Tom老師)
 Time：19 ms - ID：com.wuwenze.mybatisplusmultitenancy.mapper.UserMapper.selectById
Execute SQL：SELECT id, provider_id, name FROM user WHERE user.provider_id = 1 AND id = ? {1: 1068129257418178562}

2018-11-29 21:07:14.626 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectList    : ==> Preparing: SELECT id, provider_id, name FROM user WHERE user.provider_id = 1
 Time：0 ms - ID：com.wuwenze.mybatisplusmultitenancy.mapper.UserMapper.selectList
Execute SQL：SELECT id, provider_id, name FROM user WHERE user.provider_id = 1

2018-11-29 21:07:14.629 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectList    : ==> Parameters:
2018-11-29 21:07:14.630 DEBUG 18688 --- [      main] c.w.m.mapper.UserMapper.selectList    : <==   Total: 3
2018-11-29 21:07:14.632 INFO 18688 --- [      main] .MybatisPlusMultiTenancyApplicationTests : #selectList, e=User(id=1, providerId=1, name=Tony老師)
2018-11-29 21:07:14.632 INFO 18688 --- [      main] .MybatisPlusMultiTenancyApplicationTests : #selectList, e=User(id=2, providerId=1, name=William老師)
2018-11-29 21:07:14.632 INFO 18688 --- [      main] .MybatisPlusMultiTenancyApplicationTests : #selectList, e=User(id=1068129257418178562, providerId=1, name=新來的Tom老師)

從打印的日志不難看出，這個方案相當完美，僅需簡單的配置，讓開發(fā)者完全忽略了(provider_id)字段的存在，同時又最大程度的保證了數(shù)據(jù)的安全性，可謂是一舉兩得！

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章:

springboot2中設置@ApiImplicitParam的dataType不起作用的解決
本文主要介紹了在SpringBoot2中使用Swagger時,@ApiImplicitParam的dataType屬性不起作用的問題及其解決方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
2026-03-03
java高并發(fā)ThreadPoolExecutor類解析線程池執(zhí)行流程
這篇文章主要為大家介紹了java高并發(fā)ThreadPoolExecutor類解析線程池執(zhí)行流程，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪
2022-09-09
Java實現(xiàn)導出Word文檔的示例代碼
poi-tl是一個基于Apache POI的Word模板引擎，也是一個免費開源的Java類庫，你可以非常方便的加入到你的項目中。本文就利用它實現(xiàn)導出Word文檔功能，需要的可以參考一下
2023-02-02
java設計模式--原型模式詳解
這篇文章主要為大家詳細介紹了Java設計模式之Prototype原型模式的相關資料，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2021-07-07
SpringBoot Shiro授權實現(xiàn)過程解析
這篇文章主要介紹了SpringBoot Shiro授權實現(xiàn)過程解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下
2019-11-11
解決mybatis-plus自定義xml的坑
這篇文章主要介紹了解決mybatis-plus自定義xml的坑，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教
2022-01-01
Java實現(xiàn)微信網(wǎng)頁授權的示例代碼
這篇文章主要介紹了Java實現(xiàn)微信網(wǎng)頁授權的示例代碼，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
2018-07-07
java內(nèi)存分布實現(xiàn)代碼
這篇文章主要介紹了淺談Java內(nèi)存區(qū)域劃分和內(nèi)存分配策略，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2021-07-07
Dubbo+zookeeper搭配分布式服務的過程詳解
Dubbo作為分布式架構比較后的框架，同時也是比較容易入手的框架，適合作為分布式的入手框架，下面是簡單的搭建過程，對Dubbo+zookeeper分布式服務搭建過程感興趣的朋友一起看看吧
2022-04-04
Django之多對多查詢與操作方法詳解
這篇文章主要介紹了Django之多對多查詢與操作方法詳解，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2019-05-05