Alawn/druid-spring-boot
1
0
Fork 0
mirror of https://github.com/drtrang/druid-spring-boot.git synced 2026-11-03 16:03:42 +00:00
Code Issues Releases Wiki Activity

doc

Browse Source
This commit is contained in:
trang
2018-04-08 16:36:15 +08:00
parent a145779384
commit 2202a8fa6f
1 changed files with 9 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/Druid 多数据源支持.md
+9 -11
View File
@@ -1,14 +1,14 @@
# Druid 多数据源支持
1.0.2 版本新增了支持多数据源的 DruidDataSource2，Starter 可以自动将 `spring.datasource` 和 `spring.datasource.druid` 开头的属性注入到每一个数据源，用户只需要声明每个数据源单独的属性即可。
1.0.2 版本新增了支持多数据源的 DruidDataSource2，druid-starter 可以自动将 `spring.datasource` 和 `spring.datasource.druid` 开头的属性注入到每一个数据源，用户只需要声明每个数据源单独的属性即可。
1.1.2 版本则更进一步，改进了多数据源的注册方式，无需任何代码，由 Starter 自动发现配置并注册到 ApplicationContext，旨在简化开发人员的劳动力。
1.1.2 版本则更进一步，改进了多数据源的注册方式，无需任何代码，由 druid-starter 自动发现配置并注册到 ApplicationContext，旨在简化开发人员的劳动力。
## 使用方式
编辑 application 配置文件，Starter 会将 `spring.datasource.druid.data-sources` 开头的的属性注入到 Map<String, DruidDataSource2> 中，并根据该 Map 构建数据源。
编辑 application 配置文件，druid-starter 会将 `spring.datasource.druid.data-sources` 开头的的属性注入到 Map<String, DruidDataSource> 中，并根据该 Map 构建数据源。
```yaml
spring:
autoconfigure:
@@ -21,8 +21,6 @@ spring:
username: root
password: 123456
druid:
username: root
password: 123456
     ## 多数据源的标识，若该属性存在则为多数据源环境，不存在则为单数据源环境
     data-sources:
### master 数据源的配置，以下为 master 数据源独有的配置
@@ -50,11 +48,11 @@ spring:
## 原理
### 公共配置
多数据源其实很好实现，编写 N 个数据源的配置，并且声明 N 个 Bean 即可，但带来的一个问题是各数据源之间存在大量相同的配置，每个数据源全部声明一遍既繁琐又无用，为了解决这个问题，Starter 中新增了两个类：DruidDataSource2 和 DruidDataSource2Support。
多数据源其实很好实现，编写 N 个数据源的配置，并且声明 N 个 Bean 即可，但带来的一个问题是各数据源之间存在大量相同的配置，每个数据源全部声明一遍既繁琐又无用，为了解决这个问题，druid-starter 中新增了两个类：DruidDataSource2 和 AbstractDruidDataSource2。
其中 DruidDataSource2Support 是个抽象类，继承自 com.alibaba.druid.pool.DruidDataSource，主要作用是自动注入 `spring.datasource` 和 `spring.datasource.druid` 开头的属性，并作为 parent bean 为各个数据源实例提供公共配置。
其中 AbstractDruidDataSource2 是个抽象类，继承自 com.alibaba.druid.pool.DruidDataSource，主要作用是自动注入 `spring.datasource` 和 `spring.datasource.druid` 开头的属性，并作为 parent bean 为各个数据源实例提供公共配置。
DruidDataSource2 继承自 DruidDataSource2Support，内部没有任何代码，目的是继承 DruidDataSource2Support 中的已注入的配置，同时可以注入各数据源单独的配置，如遇到相同的属性会覆盖父类的同名属性。
DruidDataSource2 继承自 AbstractDruidDataSource2，内部没有任何代码，目的是继承 AbstractDruidDataSource2 中的已注入的配置，同时可以注入各数据源单独的配置，如遇到相同的属性会覆盖父类的同名属性。
也就是说，以下两种方式是等价的：
@@ -92,9 +90,9 @@ spring:
### 自动配置
Starter 判断是否多数据源的条件是 application 文件中是否存在 `spring.datasource.druid.data-sources` 属性，若存在即为多数据源环境，不存在则为单数据源环境。
druid-starter 判断是否多数据源的条件是 application 文件中是否存在 `spring.datasource.druid.data-sources` 属性，若存在即为多数据源环境，不存在则为单数据源环境。
多数据源环境下，Starter 会将 `spring.datasource.druid.data-sources` 开头的属性注入到 Map<String, DruidDataSource2> 中，然后遍历该 Map，并通过构造 BeanDefinition 的方式来构造各个数据源，最后通过 PropertySourcesBinder 将各数据源单独的属性注入到各数据源。
多数据源环境下，druid-starter 会将 `spring.datasource.druid.data-sources` 开头的属性注入到 Map<String, DruidDataSource2> 中，然后遍历该 Map，并通过构造 BeanDefinition 的方式来构造各个数据源，最后通过 PropertySourcesBinder 将各数据源单独的属性注入到各数据源。
## 演示