ruoyi-vue-pro 开发指南 ruoyi-vue-pro 开发指南
      视频教程
        微服务版 (opens new window)
        作者博客 (opens new window)
        GitHub (opens new window)
        • 萌新必读

          • 简介
          • 交流群
          • 视频教程
          • 功能列表
          • 快速启动(后端项目)
          • 快速启动(前端项目)
          • 接口文档
          • 技术选型
          • 项目结构
          • 代码热加载
          • 一键改包
          • 删除功能
          • 内网穿透
          • 达梦数据库专属
        • 后端手册

          • 新建模块
          • 代码生成【单表】(新增功能)
          • 代码生成【主子表】
          • 代码生成(树表)
          • 功能权限
          • 数据权限
          • 用户体系
          • 三方登录
          • OAuth 2.0(SSO 单点登录)
          • SaaS 多租户【字段隔离】
          • SaaS 多租户【数据库隔离】
          • WebSocket 实时通信
          • 异常处理(错误码)
          • 参数校验、时间传参
          • 分页实现
          • VO 对象转换、数据翻译
          • 文件存储(上传下载)
          • Excel 导入导出
          • 操作日志、访问日志、异常日志
          • MyBatis 数据库
          • MyBatis 联表&分页查询
          • 多数据源(读写分离)、事务
            • Redis 缓存
            • 本地缓存
            • 异步任务
            • 分布式锁
            • 幂等性(防重复提交)
            • 请求限流(RateLimiter)
            • 单元测试
            • 验证码
            • 工具类 Util
            • 配置管理
            • 数据库文档
          • 中间件手册

            • 定时任务
            • 消息队列(内存)
            • 消息队列(Redis)
            • 消息队列(RocketMQ)
            • 消息队列(RabbitMQ)
            • 消息队列(Kafka)
            • 限流熔断
          • 工作流手册

            • 工作流演示
            • 功能开启
            • 工作流(达梦适配)
            • 审批接入(流程表单)
            • 审批接入(业务表单)
            • 流程设计器(BPMN)
            • 流程设计器(钉钉、飞书)
            • 选择审批人、发起人自选
            • 会签、或签、依次审批
            • 流程发起、取消、重新发起
            • 审批通过、不通过、驳回
            • 审批加签、减签
            • 审批转办、委派、抄送
            • 执行监听器、任务监听器
            • 流程表达式
            • 流程审批通知
          • 大屏手册

            • 报表设计器
            • 大屏设计器
          • 支付手册

            • 功能开启
            • 支付宝支付接入
            • 微信公众号支付接入
            • 微信小程序支付接入
            • 支付宝、微信退款接入
          • 会员手册

            • 功能开启
            • 微信公众号登录
            • 微信小程序登录
            • 会员用户、标签、分组
            • 会员等级、积分、签到
          • 商城手册

            • 商城演示
            • 功能开启
            • 商城装修
            • 【商品】商品分类
            • 【商品】商品属性
            • 【商品】商品 SPU 与 SKU
            • 【商品】商品评价
            • 【交易】购物车
            • 【交易】交易订单
            • 【交易】售后退款
            • 【交易】快递发货
            • 【交易】门店自提
            • 【交易】分销返佣
            • 【营销】优惠劵
            • 【营销】拼团活动
            • 【营销】秒杀活动
            • 【营销】砍价活动
            • 【营销】满减送
            • 【营销】限时折扣
            • 【营销】内容管理
            • 【统计】会员、商品、交易统计
          • ERP手册

            • ERP 演示
            • 功能开启
            • 【产品】产品信息、分类、单位
            • 【库存】产品库存、库存明细
            • 【库存】其它入库、其它出库
            • 【库存】库存调拨、库存盘点
            • 【采购】采购订单、入库、退货
            • 【销售】销售订单、出库、退货
            • 【财务】采购付款、销售收款
          • CRM手册

            • CRM 演示
            • 功能开启
            • 【线索】线索管理
            • 【客户】客户管理、公海客户
            • 【商机】商机管理、商机状态
            • 【合同】合同管理、合同提醒
            • 【回款】回款管理、回款计划
            • 【产品】产品管理、产品分类
            • 【通用】数据权限
            • 【通用】跟进记录、待办事项
          • 公众号手册

            • 功能开启
            • 公众号接入
            • 公众号粉丝
            • 公众号标签
            • 公众号消息
            • 自动回复
            • 公众号菜单
            • 公众号素材
            • 公众号图文
            • 公众号统计
          • 系统手册

            • 短信配置
            • 邮件配置
            • 站内信配置
            • 数据脱敏
            • 敏感词
            • 地区 & IP 库
          • 运维手册

            • 开发环境
            • Linux 部署
            • Docker 部署
            • Jenkins 部署
            • HTTPS 证书
            • 服务监控
          • 前端手册 Vue 3.x

            • 开发规范
            • 菜单路由
            • Icon 图标
            • 字典数据
            • 系统组件
            • 通用方法
            • 配置读取
            • CRUD 组件
            • 国际化
            • IDE 调试
            • 代码格式化
          • 前端手册 Vue 2.x

            • 开发规范
            • 菜单路由
            • Icon 图标
            • 字典数据
            • 系统组件
            • 通用方法
            • 配置读取
          • 更新日志

            • 【v2.1.0】开发中
            • 【v2.0.1】2024-03-01
            • 【v2.0.0】2024-01-26
            • 【v1.9.0】2023-12-01
            • 【v1.8.3】2023-10-24
          • 开发指南
          • 后端手册
          芋道源码
          2022-04-02
          目录
          1. 数据连接池
          1.1 Druid 监控配置
          1.2 Druid 监控界面
          1.3 如何开启登录?
          2. 多数据源
          2.1 多数据源配置
          2.2 数据源切换
          3. 事务相关
          3.1 @Transactional 注解
          3.2 @DSTransactional 注解
          3.3 分布式事务
          4. 分库分表

          多数据源(读写分离)、事务

          yudao-spring-boot-starter-mybatis (opens new window) 技术组件,除了提供 MyBatis 数据库操作,还提供了如下 2 种功能:

          • 数据连接池:基于 Alibaba Druid (opens new window) 实现,额外提供监控的能力。
          • 多数据源(读写分离):基于 Dynamic Datasource (opens new window) 实现,支持 Druid 连接池,可集成 Seata (opens new window) 实现分布式事务。

          # 1. 数据连接池

          友情提示:

          如果你未学习过 Druid 数据库连接池,可以后续阅读 《芋道 Spring Boot 数据库连接池入门》 (opens new window) 文章。

          <dependency>
              <groupId>com.alibaba</groupId>
              <artifactId>druid-spring-boot-starter</artifactId>
          </dependency>
          

          # 1.1 Druid 监控配置

          在 application-local.yaml (opens new window) 配置文件中,通过 spring.datasource.druid 配置项,仅仅设置了 Druid 监控相关的配置项目,具体数据库的设置需要使用 Dynamic Datasource 的配置项。如下图所示:

           配置项

          # 1.2 Druid 监控界面

          ① 访问后端的 /druid/index.html 路径,例如说本地的 http://127.0.0.1:48080/druid/index.html 地址,可以查看到 Druid 监控界面。如下图所示:

          Druid 监控界面

          ② 访问前端的 [基础设施 -> MySQL 监控] 菜单,也可以查看到 Druid 监控界面。如下图所示:

          Druid 监控界面

          补充说明:

          前端 [基础设施 -> MySQL 监控] 菜单,通过 iframe 内嵌后端的 /druid/index.html 路径。

          如果你想自定义地址,可以前往 [基础设置 -> 配置管理] 菜单,设置 key 为 url.druid 配置项。

          # 1.3 如何开启登录?

          生产环境下,建议 Druid 监控界面开启“安全认证”的功能,避免出现安全事故。

          只需要在 spring.datasource.druid.stat-view-servlet 配置项中,设置 login-username 和 login-password 即可。开启后,登录界面如下图所示:

          Druid 登录界面

          # 2. 多数据源

          友情提示:

          如果你未学习过多数据源,可以后续阅读 《芋道 Spring Boot 多数据源(读写分离)入门》 (opens new window) 文章。

          <dependency>
              <groupId>com.baomidou</groupId>
              <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
          </dependency>
          

          # 2.1 多数据源配置

          在 application-local.yaml (opens new window) 配置文件中,通过 spring.datasource.dynamic 配置项,配置了 Master-Slave 主从两个数据源。如下图所示:

           配置项

          # 2.2 数据源切换

          # 2.2.1 @Master 注解

          在方法上添加 @Master (opens new window) 注解,使用名字为 master 的数据源,即使用【主】库,一般适合【写】场景。示例如下图:

          @Master 注解

          由于项目的 spring.datasource.dynamic.primary 为 master,默认使用【主】库,所以无需手动添加 @Master 注解。

          # 2.2.2 @Slave 注解

          在方法上添加 @Slave (opens new window) 注解,使用名字为 slave 的数据源,即使用【从】库,一般适合【读】场景。示例如下图:

          @Slave 注解

          # 2.2.3 @DS 注解

          在方法上添加 @DS (opens new window) 注解,使用指定名字的数据源,适合多数据源的情况。示例如下图:

          @DS 注解

          # 3. 事务相关

          事务一共有 3 种解决方案,分别是:

          • 单机 + 单数据源:@Transactional 注解
          • 单机 + 多数据源:@DSTransactional 注解
          • 多机 + 单/多数据源:Seata 分布式事务

          # 3.1 @Transactional 注解

          大多数情况下,是单机 + 单个数据源的操作,只需要在方法上添加 Spring @Transactional 注解,声明事务即可。

          具体的使用,可以项目里搜 @Transactional 关键字,就可以看到非常多的使用示例。

          # 3.2 @DSTransactional 注解

          如果单机 + 多个数据源的操作,使用 @Transactional 声明的事务中,无法进行数据源的切换。此时,可以使用 Dynamic Datasource 提供的 @DSTransactional (opens new window) 注解,支持多数据源的切换。

          友情提示:

          @DSTransactional 注解,提供相对可靠的多数据源的事务一致性,但是不绝对,可学习 《DSTransactional 实现源码分析 》 (opens new window) 文章。

          使用的示例,AService 调用 BService、CService,并且分别对应 a、b、c 各自的数据源,代码如下所示:

          public class AService {
              
              @Resource
              private BService bService;
              @Resource
              private CService cService;
              
              @DS("a") // 注意:如果 a 是默认数据源时,则不需要 @DS 注解
              @DSTransactional
              public void create() {
                  bService.createB();
                  CService.createC();
              }
              
          }
          
              public class BService {
                  
                  @DS("b")
                  public void createB() {
                      // 调用 bMapper 逻辑
                  }
                  
              }
              
              public class CService {
                  
                  @DS("c")
                  public void createC() {
                      // 调用 cMapper 逻辑
                  }
                  
              }
          

          场景问题:

          问题 ①:c 数据源的操作发生异常,a、b 数据源会回滚么?

          • 答案:会的,因为最终是最外层的 @DSTransactional 注解对应的方法结束后,才进行事务的提交,所以它实际不需要回滚。
          • 注意:但是有一点要注意,如果提交时某个数据源的事务提交失败,则可能导致事务的不一致。

          问题 ②:b、c 数据源的方法,也添加 @DSTransactional 注解,会不会影响事务?

          • 答案:不会,可以放心大胆的加。

          # 3.3 分布式事务

          在多机分布式场景下,无论是单数据源、多数据源,本质上都是分布式事务,建议引入 Seata 框架,提供完整的分布式事务的解决方案,可学习 《芋道 Seata 极简入门 》 (opens new window) 文章。

          不过如果你是单机项目,则可以不用关注着一点哈!

          # 4. 分库分表

          建议采用 ShardingSphere 的子项目 Sharding-JDBC 完成分库分表的功能,可阅读 《芋道 Spring Boot 分库分表入门 》 (opens new window) 文章,学习如何整合进项目。

          MyBatis 联表&分页查询
          Redis 缓存

          ← MyBatis 联表&分页查询 Redis 缓存→

          Theme by Vdoing | Copyright © 2019-2024 芋道源码 | MIT License
            ×