说起动态数据源，大家应该也不陌生。例如在读写分离系统中，则要对请求中的读写操作进行分离，让读和写落在不同的数据库上；例如在多租户系统中，则要根据请求来源租户的不同，让其落在不同租户的数据库上；例如在分库应用中，也要根据不同的规则让请求落在不同的数据库上。于是，我们的应用要根据请求的不同，操作不同的数据库，这时就需要动态数据源的帮助。
DynamicDataSource就是一个出色的动态数据源，他能让你在程序运行过程中动态增删和切换数据源。而且，它十分易用。使用它在一个请求中查询多个数据源变得无比简单。
1 特点
DynamicDataSource具有以下特点：
- 小巧：只实现最基本的数据源增删、切换功能，不涉及相关业务。
- 易用：只需要简单的配置和几个方法的调用便可以完成所有功能。
- 兼容：增加数据源时，数据源信息可以来自配置文件、前端界面输入、数据库查询等各种方式。
- 无侵入：切换数据源操作可以由切面触发、逻辑触发、注解触发等，均可以供开发者自由实现。
DynamicDataSource中常用的方法有：
- `boolean addDataSource(DataSourceInfo dataSourceInfo, Boolean overwrite)`：增加一个数据源，overwrite用来决定如果已经存在同名数据源时是否要覆盖
- `boolean addAndSwitchDataSource(DataSourceInfo dataSourceInfo, Boolean overwrite)`：增加一个数据源并切换到该数据源，overwrite用来决定如果已经存在同名数据源时是否要覆盖
- `boolean switchDataSource(String dataSourceName)`：切换到指定名称的数据源
- `boolean delDataSource(String dataSourceName)`：删除一个数据源
- `void switchDefaultDataSource()`：切换到默认的数据源
- `DataSource getDefaultDataSource()`：获取默认数据源
以上方法都是多线程安全的。你可以在切面、操作逻辑、注解中调用以上方法，完成数据源的动态增删与切换。
2 快速上手
在`\demo`文件夹下提供一个示例项目，供大家快速上手。以该demo项目为例，我们介绍DynamicDataSource的使用。
2.1 引入依赖包
在POM文件中引入DynamicDataSource的jar包。
2.2 基本配置
在application.properties文件中写入默认的数据源信息，下面为示例。可按照自己的数据源进行修改。
禁止Spring对DataSourceAutoConfiguration类的加载，否则该类会去加载固定的数据源。
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
增加对DynamicDataSource所在包的Bean的扫描。
@ComponentScan(basePackages = {"com.github.yeecode.dynamicdatasource","{other_package_root}"})
2.3 开始使用
至此，使用DynamicDataSource所需的全部配置就完成了。使用下面方式注入DynamicDataSource后便可以调用其中的数据源操作方法。
@Autowired
private DynamicDataSource dynamicDataSource;
我们可以按照`\demo\sql\DDL.md`文件所述建立两个数据源，然后测试DynamicDataSource的工作情况。
启动DynamicDataSourceDemo项目得到如下界面。
例如我们可以在一个接口内实现数据源的切换，从而在请求到达`/`接口时，先后查询了两个数据源中的数据，如代码所示。
可以得到下图所示的结果。下图打印的两行语句分别来自两个数据源。
数据源新增、删除、切换操作可以在切面中、业务逻辑中、注解中等各处进行触发。DynamicDataSource不做任何限制，交由开发人员按照实际需要实现。
3 总结
怎么样，DynamicDataSource的使用是不是非常简单。通过Maven仓库直接下载依赖，并且还有Demo项目指导，瞬间上手。
从此，动态数据源的切换So Easy！
实属架构师、程序员秘笈。收藏起来，日后用，其具体接口可能在日后升级中变动，请以最新版本的README文档为准。项目地址是：
https://github.com/yeecode/DynamicDataSource
