MyBaits-Flex 内置了功能完善的多数据源支持^1.0.6，不需要借助第三方插件或者依赖，开箱即用， 支持包括 druid、hikaricp、dbcp2、beecp 在内的任何数据源，MyBatis-Flex 多数据源配置如下：

在以上配置中，ds1 和 ds2 是由用户自定义的，我们可以理解为数据源的名称，或者数据源的 key，这个在动态切换数据库中非常有用。

在无 Spring 框架的场景下，代码如下：

默认使用第一个配置的数据源：

通过编码的方式，切换到数据源 ds2：

或者

MyBatis-Flex 提供了 4 种方式来配置数据源：

在 SpringBoot 项目上，@UseDataSource("dataSourceName") 也可用于在 Controller 或者 Service 上。若是 Spring 项目（非 SpringBoot）, 用户需要参考 MultiDataSourceAutoConfiguration 进行配置后才能使用。

DataSourceKey.use 示例：

@UseDataSource("dataSourceName") 示例：

或者

@Table(dataSource="dataSourceName") 示例：

数据源配置的优先级

DataSourceKey.use() > @UseDataSource()在方法上 > @UseDataSource()在类上 >@Table(dataSource="...")

在以上配置中，ds1 和 ds2 并未指定使用哪个数据连接池，MyBatis-Flex 会 自动探测 当前项目依赖了哪个连接池。 目前支持了 druid、hikaricp、dbcp2、beecp 的自动探测，如果项目中使用的不是这 4 种类型只有，需要添加 type 配置，如下所示：

同时，项目若使用到了多个数据源类型，则也需要添加 type 来指定当前数据源的类型。

除了 type、url、username、password 的配置以外，MyBatis-Flex 支持该 DataSource 类型的所有参数配置， 例如，在 DruidDataSource 类中存在 setAsyncInit 方法，我们就可以添加 asyncInit 的配置，如下所示：

因此，只要该 DataSource 有 setter 方法，我们就可以在配置文件中进行配。与此相反的是：若该 DataSource 类型没有该属性，则不能使用这个配置。

提示

在数据源的配置中，type 可以配置为某个 DataSource 的类名，也可以配置为别名，别名支持有：druid、 hikari、hikaricp、bee、beecp、dbcp、dbcp2。

在多租户等某些场景下，我们可能需要用到动态的添加新的数据源，此时可以通过如下的方式进行添加。

需要注意的是： 通过 FlexGlobalConfig 去获取 FlexDataSource 时，需等待应用完全启动成功后，才能正常获取 FlexDataSource， 否则将会得到 null 值。

Spring 用户可以通过 ApplicationListener 去监听 ContextRefreshedEvent 事件，然后再去添加新的数据源，如下代码所示：

数据源负载均衡指的是：在进行数据查询的时候，随机使用一个数据源。 这是的在高并发的场景下，起到负载的效果。

假设多数据源配置如下：

以上配置了三个数据源，分别为：ds1、ds2、other，假设我们想负载均衡使用 ds1、ds2 ，那么代码如下：

DataSourceKey.use("ds*") 中的 ds* 指的是使用 ds 开头的任意一个数据源。ds* 必须以 "*" 结尾， 中间不能有空格，比如 "ds *" 中间有空格是不行的。