2024年6月15日发(作者：)

baomidou dynamic-datasource 原理

Baomidou DynamicDataSource 是一个基于 Java 的动态数据源框架，

被广泛应用于各种基于关系型数据库的项目中。它能够根据业务需求在运

行时动态切换数据源，提供了一种简单、灵活、高效的解决方案。本文将

详细介绍 Baomidou DynamicDataSource 的原理，以及它是如何实现

动态数据源切换的。

一、Baomidou DynamicDataSource 的基本原理

Baomidou DynamicDataSource 的基本原理是利用 Spring 提供的

AbstractRoutingDataSource 来实现动态数据源切换。在 Spring 中，

AbstractRoutingDataSource 是一个抽象类，它继承自

AbstractDataSource，并且实现了 DataSource 接口。

AbstractRoutingDataSource 的作用是根据当前的数据源路由规则，确

定最终使用的数据源。

Baomidou DynamicDataSource 扩展了

AbstractRoutingDataSource，通过重写

determineCurrentLookupKey 方法，实现根据当前线程或其他条件来动

态选择数据源。具体而言，Baomidou DynamicDataSource 根据一个

ThreadLocal 线程变量来管理当前线程所使用的数据源。每次需要访问数

据库时，开发人员可以通过 Baomidou DynamicDataSource 提供的

API 来设置 ThreadLocal 中的数据源标识符，Baomidou

DynamicDataSource 内部会根据这个标识符来选择相应的数据源。

二、Baomidou DynamicDataSource 的实现步骤

下面一步一步介绍 Baomidou DynamicDataSource 是如何实现动态数

据源切换的。

1. 引入 Baomidou DynamicDataSource 依赖

首先，在 Maven 或 Gradle 构建工具中引入 Baomidou

DynamicDataSource 的相关依赖。Baomidou DynamicDataSource

可以与 Spring Boot、Spring Cloud 等框架很好地集成，因此可以直接

使用其提供的 Starter，简化项目配置。

2. 创建数据源

接下来，根据需要创建多个数据源。可以使用 Spring 提供的

DriverManagerDataSource 或其它 DataSource 实现类，也可以使用

连接池库提供的 DataSource 实现。

3. 配置数据源路由规则

创建一个数据源路由器类，继承自 AbstractRoutingDataSource，并实

现其 determineCurrentLookupKey 方法。这个方法的作用是返回当前

线程要使用的数据源标识符。可以根据 ThreadLocal 中的标识符来进行

选择。

4. 配置 Baomidou DynamicDataSource

在 Spring 配置文件中，通过配置 Baomidou DynamicDataSource

Bean，并设置它的 targetDataSources 属性为一个 Map，其中 key 为

数据源标识符，value 为具体的数据源。

5. 使用 Baomidou DynamicDataSource

在代码中需要访问数据库的地方，可以通过 Baomidou

DynamicDataSourceContextHolder 来设置当前线程使用的数据源。可

以使用 Baomidou DynamicDataSourceContextHolder 的静态方法

setDataSourceKey 来设置数据源标识符，也可以使用 setDataSource

方法来直接设置数据源。

6. 动态数据源切换

Baomidou DynamicDataSource 使用了 ThreadLocal 来管理当前线

程使用的数据源。每当调用设置数据源的 API 时，Baomidou

DynamicDataSource 会将数据源标识符设置到当前线程的

ThreadLocal 中。而在 AbstractRoutingDataSource 内部，每次访问

数据库时都会调用 determineCurrentLookupKey 方法来获取当前数据

源标识符。因此，当使用 Baomidou DynamicDataSource 执行数据库

操作时，它会根据当前线程的数据源标识符选择相应的数据源。

三、Baomidou DynamicDataSource 的优势

Baomidou DynamicDataSource 提供了一种简单而强大的动态切换数

据源的解决方案。它的优势主要体现在以下几个方面：

1. 灵活性：Baomidou DynamicDataSource 的数据源切换是在运行时

动态进行的，可以根据业务需求灵活选择数据源。

2. 扩展性：Baomidou DynamicDataSource 可以与各种数据库连接池、

ORM 框架集成，提供了很好的扩展性。

3. 高效性：Baomidou DynamicDataSource 使用了线程本地存储技术，

每个线程都有独立的数据源，避免了多线程并发访问数据库时的资源竞争

问题。

4. 可管理性：Baomidou DynamicDataSource 提供了一套管理动态数

据源的 API，可以方便地进行数据源的添加、删除、切换等操作。

总结：

本文通过介绍 Baomidou DynamicDataSource 的原理和实现步骤，以

及它的优势，详细阐述了该框架在实现动态数据源切换方面的作用。

Baomidou DynamicDataSource 不仅提供了简单易用的 API，还具备

灵活性、扩展性、高效性和可管理性，可广泛应用于各种基于关系型数据

库的项目中。