【架构实战】CQRS架构模式实战

news2026/5/10 9:15:29
一、CQRS概述CQRSCommand Query Responsibility Segregation命令查询职责分离是一种架构模式核心思想命令Command修改数据的操作查询Query读取数据的操作两者使用不同的模型和存储为什么需要CQRS读写负载不均衡读写数据结构差异大需要独立的读写优化二、CQRS核心概念1. 基本模型┌─────────────────────────────────────────────────────────────┐ │ CQRS架构 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ 命令端 │ │ 查询端 │ │ │ │ (写入优化) │──── 同步 ────▶│ (读取优化) │ │ │ └──────┬───────┘ └──────▲───────┘ │ │ │ │ │ │ ▼ │ │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ 命令数据库 │ │ 查询数据库 │ │ │ │ (事务存储) │ │ (只读副本) │ │ │ └──────────────┘ └──────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘2. 命令端// 命令接口publicinterfaceCommandHandlerCextendsCommand{voidhandle(Ccommand);}// 命令基类publicabstractclassCommand{privatefinalStringcommandId;privatefinalLocalDateTimetimestamp;protectedCommand(){this.commandIdUUID.randomUUID().toString();this.timestampLocalDateTime.now();}}// 创建订单命令publicclassCreateOrderCommandextendsCommand{privatefinalStringcustomerId;privatefinalListOrderItemDataitems;publicCreateOrderCommand(StringcustomerId,ListOrderItemDataitems){this.customerIdcustomerId;this.itemsitems;}}// 命令处理器ServicepublicclassOrderCommandHandlerimplementsCommandHandlerCreateOrderCommand{AutowiredprivateOrderRepositoryorderRepository;AutowiredprivateEventPublishereventPublisher;TransactionalOverridepublicvoidhandle(CreateOrderCommandcommand){// 创建订单聚合OrderorderOrder.create(OrderId.generate(),CustomerId.of(command.getCustomerId()));// 添加商品for(OrderItemDataitemData:command.getItems()){ProductproductproductRepository.findById(ProductId.of(itemData.getProductId()));order.addItem(product,itemData.getQuantity());}// 提交订单order.submit();// 保存orderRepository.save(order);// 发布事件eventPublisher.publish(newOrderCreatedEvent(order));}}3. 查询端// 查询接口publicinterfaceQueryHandlerQextendsQuery,R{Rhandle(Qquery);}// 查询基类publicabstractclassQuery{// 查询参数}// 订单查询DTO专为读取优化publicclassOrderQueryDTO{privateLongorderId;privateStringorderNo;privateStringcustomerName;// 可能需要JOINprivateStringstatusText;// 状态转换privateBigDecimaltotalAmount;privateListOrderItemQueryDTOitems;privateStringcreateTimeText;// 格式化时间// 允许非常灵活的查询模型}// 查询处理器ServicepublicclassOrderQueryHandlerimplementsQueryHandlerOrderQuery,ListOrderQueryDTO{AutowiredprivateOrderReadRepositoryreadRepository;OverridepublicListOrderQueryDTOhandle(OrderQueryquery){returnreadRepository.findOrders(query);}}三、数据同步方案1. 同步复制┌────────────┐ 同步写入 ┌────────────┐ │ 命令数据库 │ ──────────────▶│ 查询数据库 │ │ (OLTP) │ 实时同步 │ (OLAP) │ └────────────┘ └────────────┘// 同步复制实现ServicepublicclassSynchronousReplicationService{AutowiredprivateJdbcTemplatecommandJdbcTemplate;AutowiredprivateJdbcTemplatequeryJdbcTemplate;TransactionalpublicvoidsaveOrder(Orderorder){// 写入命令数据库StringsqlINSERT INTO orders (id, order_no, customer_id, status, total_amount) VALUES (?, ?, ?, ?, ?);commandJdbcTemplate.update(sql,order.getId(),order.getOrderNo(),order.getCustomerId(),order.getStatus().name(),order.getTotalAmount());// 同步写入查询数据库StringquerySqlINSERT INTO v_orders (id, order_no, customer_name, status_text, total_amount) VALUES (?, ?, ?, ?, ?);queryJdbcTemplate.update(querySql,order.getId(),order.getOrderNo(),order.getCustomerName(),// 查询端需要的字段order.getStatus().getText(),order.getTotalAmount());}}2. 事件驱动复制// 事件监听同步ComponentpublicclassOrderEventSynchronizer{AutowiredprivateOrderReadRepositoryreadRepository;KafkaListener(topicsorder-events)publicvoidhandleOrderEvent(OrderEventevent){if(eventinstanceofOrderCreatedEvent){OrderCreatedEventcreated(OrderCreatedEvent)event;// 转换为查询模型OrderQueryModelmodeltoQueryModel(created.getOrder());readRepository.save(model);}if(eventinstanceofOrderUpdatedEvent){OrderUpdatedEventupdated(OrderUpdatedEvent)event;readRepository.update(toQueryModel(updated.getOrder()));}if(eventinstanceofOrderCancelledEvent){OrderCancelledEventcancelled(OrderCancelledEvent)event;readRepository.delete(cancelled.getOrderId());}}privateOrderQueryModeltoQueryModel(Orderorder){returnOrderQueryModel.builder().id(order.getId()).orderNo(order.getOrderNo()).customerName(getCustomerName(order.getCustomerId())).statusText(order.getStatus().getText()).totalAmount(order.getTotalAmount()).items(order.getItems().stream().map(this::toItemModel).collect(Collectors.toList())).build();}}3. 最终一致性┌────────────┐ 事件 ┌────────────┐ 消费 ┌────────────┐ │ 命令端 │ ──────────▶│ 消息队列 │ ───────────▶│ 查询端 │ │ (聚合根) │ │ (Kafka) │ │ (投影) │ └────────────┘ └────────────┘ └────────────┘ │ ▼ ┌────────────┐ │ 事件存储 │ │ (EventStore)│ └────────────┘四、读写分离优化1. 命令端优化// 命令端事务优先保证一致性ServicepublicclassOrderCommandService{Transactional(isolationIsolation.REPEATABLE_READ)publicOrderDTOcreateOrder(CreateOrderCommandcommand){// 严格的业务校验validateBusinessRules(command);// 创建聚合OrderorderorderAggregateFactory.create(command);// 保存到主库orderRepository.save(order);// 发布领域事件eventPublisher.publish(order.getDomainEvents());returntoDTO(order);}privatevoidvalidateBusinessRules(CreateOrderCommandcommand){// 检查库存for(OrderItemDataitem:command.getItems()){if(!inventoryService.checkStock(item.getProductId(),item.getQuantity())){thrownewInsufficientStockException(item.getProductId());}}// 检查客户信用if(!creditService.checkCredit(command.getCustomerId(),command.getTotalAmount())){thrownewInsufficientCreditException(command.getCustomerId());}}}2. 查询端优化// 查询端性能优先支持各种读取场景ServicepublicclassOrderQueryService{AutowiredprivateJdbcTemplatejdbcTemplate;// 场景1订单列表分页publicPageOrderListDTOlistOrders(OrderListQueryquery){Stringsql SELECT o.*, c.name as customer_name, (SELECT COUNT(*) FROM order_items WHERE order_id o.id) as item_count FROM orders o LEFT JOIN customers c ON o.customer_id c.id WHERE o.status ? ORDER BY o.create_time DESC LIMIT ? OFFSET ? ;// 直接执行优化的查询returnjdbcTemplate.query(sql,(rs,rowNum)-toOrderListDTO(rs),query.getStatus(),query.getPageSize(),query.getOffset());}// 场景2订单详情JOIN多表publicOrderDetailDTOgetOrderDetail(LongorderId){Stringsql SELECT o.*, c.name as customer_name, c.phone as customer_phone, p.name as payment_name, p.method as payment_method FROM orders o LEFT JOIN customers c ON o.customer_id c.id LEFT JOIN payments p ON o.id p.order_id WHERE o.id ? ;returnjdbcTemplate.queryForObject(sql,this::toOrderDetailDTO,orderId);}// 场景3统计报表publicOrderStatisticsDTOgetStatistics(OrderStatisticsQueryquery){Stringsql SELECT DATE(create_time) as date, COUNT(*) as order_count, SUM(total_amount) as total_amount, AVG(total_amount) as avg_amount FROM orders WHERE create_time BETWEEN ? AND ? GROUP BY DATE(create_time) ;returnjdbcTemplate.query(sql,(rs,rowNum)-toStatisticsDTO(rs),query.getStartDate(),query.getEndDate()).stream().collect(Collectors.groupingBy(OrderStatisticsDTO::getDate)).values().stream().findFirst().orElse(newOrderStatisticsDTO());}}五、视图模型设计1. 查询数据库表设计-- 命令端规范化设计CREATETABLEorders(idBIGINTPRIMARYKEY,order_noVARCHAR(32),customer_idBIGINT,statusVARCHAR(20),total_amountDECIMAL(12,2),create_timeTIMESTAMP);CREATETABLEorder_items(idBIGINTPRIMARYKEY,order_idBIGINT,product_idBIGINT,quantityINT,priceDECIMAL(10,2));-- 查询端反规范化设计冗余常用字段CREATETABLEv_orders(idBIGINTPRIMARYKEY,order_noVARCHAR(32),-- 冗余的客户信息避免JOINcustomer_idBIGINT,customer_nameVARCHAR(100),customer_phoneVARCHAR(20),customer_addressVARCHAR(200),-- 状态文本避免转换statusVARCHAR(20),status_textVARCHAR(50),status_colorVARCHAR(20),-- 预计算的金额total_amountDECIMAL(12,2),discount_amountDECIMAL(12,2),final_amountDECIMAL(12,2),-- 预格式化的时间create_timeTIMESTAMP,create_time_textVARCHAR(50),create_time_dateDATE,-- 冗余的商品数量避免子查询item_countINT,item_namesTEXT,INDEXidx_customer(customer_id),INDEXidx_status(status),INDEXidx_create_time(create_time_date));2. ES查询模型// Elasticsearch视图模型Document(indexNameorders)publicclassOrderIndexModel{IdprivateStringid;Field(typeFieldType.Keyword)privateStringorderNo;Field(typeFieldType.Long)privateLongcustomerId;Field(typeFieldType.Text,analyzerik_max_word)privateStringcustomerName;Field(typeFieldType.Keyword)privateStringstatus;Field(typeFieldType.Text)privateStringstatusText;Field(typeFieldType.Double)privateBigDecimaltotalAmount;Field(typeFieldType.Nested)privateListOrderItemIndexitems;Field(typeFieldType.Date)privateLocalDateTimecreateTime;Field(typeFieldType.Text)privateStringcreateTimeText;// 支持全文搜索Field(typeFieldType.Text,analyzerik_max_word)privateStringsearchText;// orderNo customerName productNames}六、CQRS实现框架1. Axon Framework// Axon Framework实现CQRSSpringBootApplicationEnableAxonFrameworkpublicclassOrderApplication{}AggregatepublicclassOrderAggregate{AggregateIdentifierprivateStringorderId;CommandHandlerpublicOrderAggregate(CreateOrderCommandcommand){apply(newOrderCreatedEvent(command.getOrderId(),command.getCustomerId()));}EventSourcingHandlerpublicvoidon(OrderCreatedEventevent){this.orderIdevent.getOrderId();}CommandHandlerpublicvoidhandle(AddItemCommandcommand){apply(newItemAddedEvent(orderId,command.getProductId(),command.getQuantity()));}}ComponentpublicclassOrderEventHandler{EventHandlerpublicvoidon(OrderCreatedEventevent){// 更新查询端OrderProjectionprojectionOrderProjection.builder().orderId(event.getOrderId()).status(CREATED).build();orderProjectionRepository.save(projection);}}2. Spring CQRS示例// 命令端ServiceRequiredArgsConstructorpublicclassOrderCommandService{privatefinalCommandGatewaycommandGateway;publicStringcreateOrder(CreateOrderCommandcommand){returncommandGateway.send(command);}}// 查询端ServiceRequiredArgsConstructorpublicclassOrderQueryService{privatefinalJdbcTemplatejdbcTemplate;publicListOrderDTOlistOrders(LongcustomerId){returnjdbcTemplate.query(SELECT * FROM orders WHERE customer_id ?,(rs,rowNum)-toDTO(rs),customerId);}}七、CQRS最佳实践1. 何时使用CQRS场景建议简单CRUD不需要CQRS读写负载差异大考虑CQRS复杂业务逻辑考虑CQRS需要高并发读取适合CQRS报表和分析需求非常适合CQRS2. 注意事项1. 避免过度设计 - 小型应用不需要CQRS 2. 处理好最终一致性 - 命令端和查询端可能短暂不一致 3. 选择合适的数据同步方式 - 同步延迟低但影响写入性能 - 异步写入快但存在延迟 4. 保持命令和查询的独立性 - 不要在命令端直接查询3. 与其他模式结合CQRS DDD - 命令端使用DDD设计聚合根 - 查询端使用投影构建视图模型 CQRS Event Sourcing - 命令端存储事件 - 查询端订阅事件构建投影 CQRS 微服务 - 每个服务独立使用CQRS - 通过事件总线同步数据八、总结CQRS是一种强大的架构模式命令端专注业务逻辑保证一致性查询端专注读取性能支持灵活查询数据同步同步或异步根据场景选择适用场景读写负载不均、复杂业务、需要高并发最佳实践优先考虑简单架构根据实际需求决定是否使用CQRS处理好一致性问题做好监控和告警个人观点仅供参考

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2552478.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

SpringBoot-17-MyBatis动态SQL标签之常用标签

文章目录 1 代码1.1 实体User.java1.2 接口UserMapper.java1.3 映射UserMapper.xml1.3.1 标签if1.3.2 标签if和where1.3.3 标签choose和when和otherwise1.4 UserController.java2 常用动态SQL标签2.1 标签set2.1.1 UserMapper.java2.1.2 UserMapper.xml2.1.3 UserController.ja…

wordpress后台更新后 前端没变化的解决方法

使用siteground主机的wordpress网站,会出现更新了网站内容和修改了php模板文件、js文件、css文件、图片文件后,网站没有变化的情况。 不熟悉siteground主机的新手,遇到这个问题,就很抓狂,明明是哪都没操作错误&#x…

网络编程(Modbus进阶)

思维导图 Modbus RTU(先学一点理论) 概念 Modbus RTU 是工业自动化领域 最广泛应用的串行通信协议,由 Modicon 公司(现施耐德电气)于 1979 年推出。它以 高效率、强健性、易实现的特点成为工业控制系统的通信标准。 包…

UE5 学习系列(二)用户操作界面及介绍

这篇博客是 UE5 学习系列博客的第二篇,在第一篇的基础上展开这篇内容。博客参考的 B 站视频资料和第一篇的链接如下: 【Note】:如果你已经完成安装等操作,可以只执行第一篇博客中 2. 新建一个空白游戏项目 章节操作,重…

IDEA运行Tomcat出现乱码问题解决汇总

最近正值期末周,有很多同学在写期末Java web作业时,运行tomcat出现乱码问题,经过多次解决与研究,我做了如下整理: 原因: IDEA本身编码与tomcat的编码与Windows编码不同导致,Windows 系统控制台…

利用最小二乘法找圆心和半径

#include <iostream> #include <vector> #include <cmath> #include <Eigen/Dense> // 需安装Eigen库用于矩阵运算 // 定义点结构 struct Point { double x, y; Point(double x_, double y_) : x(x_), y(y_) {} }; // 最小二乘法求圆心和半径 …

使用docker在3台服务器上搭建基于redis 6.x的一主两从三台均是哨兵模式

一、环境及版本说明 如果服务器已经安装了docker,则忽略此步骤,如果没有安装,则可以按照一下方式安装: 1. 在线安装(有互联网环境): 请看我这篇文章 传送阵>> 点我查看 2. 离线安装(内网环境):请看我这篇文章 传送阵>> 点我查看 说明&#xff1a;假设每台服务器已…

XML Group端口详解

在XML数据映射过程中&#xff0c;经常需要对数据进行分组聚合操作。例如&#xff0c;当处理包含多个物料明细的XML文件时&#xff0c;可能需要将相同物料号的明细归为一组&#xff0c;或对相同物料号的数量进行求和计算。传统实现方式通常需要编写脚本代码&#xff0c;增加了开…

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器的上位机配置操作说明

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器专为工业环境精心打造&#xff0c;完美适配AGV和无人叉车。同时&#xff0c;集成以太网与语音合成技术&#xff0c;为各类高级系统&#xff08;如MES、调度系统、库位管理、立库等&#xff09;提供高效便捷的语音交互体验。 L…

(LeetCode 每日一题) 3442. 奇偶频次间的最大差值 I (哈希、字符串)

题目&#xff1a;3442. 奇偶频次间的最大差值 I 思路 &#xff1a;哈希&#xff0c;时间复杂度0(n)。 用哈希表来记录每个字符串中字符的分布情况&#xff0c;哈希表这里用数组即可实现。 C版本&#xff1a; class Solution { public:int maxDifference(string s) {int a[26]…

【大模型RAG】拍照搜题技术架构速览:三层管道、两级检索、兜底大模型

摘要 拍照搜题系统采用“三层管道&#xff08;多模态 OCR → 语义检索 → 答案渲染&#xff09;、两级检索&#xff08;倒排 BM25 向量 HNSW&#xff09;并以大语言模型兜底”的整体框架&#xff1a; 多模态 OCR 层 将题目图片经过超分、去噪、倾斜校正后&#xff0c;分别用…

【Axure高保真原型】引导弹窗

今天和大家中分享引导弹窗的原型模板&#xff0c;载入页面后&#xff0c;会显示引导弹窗&#xff0c;适用于引导用户使用页面&#xff0c;点击完成后&#xff0c;会显示下一个引导弹窗&#xff0c;直至最后一个引导弹窗完成后进入首页。具体效果可以点击下方视频观看或打开下方…

接口测试中缓存处理策略

在接口测试中&#xff0c;缓存处理策略是一个关键环节&#xff0c;直接影响测试结果的准确性和可靠性。合理的缓存处理策略能够确保测试环境的一致性&#xff0c;避免因缓存数据导致的测试偏差。以下是接口测试中常见的缓存处理策略及其详细说明&#xff1a; 一、缓存处理的核…

龙虎榜——20250610

上证指数放量收阴线&#xff0c;个股多数下跌&#xff0c;盘中受消息影响大幅波动。 深证指数放量收阴线形成顶分型&#xff0c;指数短线有调整的需求&#xff0c;大概需要一两天。 2025年6月10日龙虎榜行业方向分析 1. 金融科技 代表标的&#xff1a;御银股份、雄帝科技 驱动…

观成科技:隐蔽隧道工具Ligolo-ng加密流量分析

1.工具介绍 Ligolo-ng是一款由go编写的高效隧道工具&#xff0c;该工具基于TUN接口实现其功能&#xff0c;利用反向TCP/TLS连接建立一条隐蔽的通信信道&#xff0c;支持使用Let’s Encrypt自动生成证书。Ligolo-ng的通信隐蔽性体现在其支持多种连接方式&#xff0c;适应复杂网…

铭豹扩展坞 USB转网口 突然无法识别解决方法

当 USB 转网口扩展坞在一台笔记本上无法识别,但在其他电脑上正常工作时,问题通常出在笔记本自身或其与扩展坞的兼容性上。以下是系统化的定位思路和排查步骤,帮助你快速找到故障原因: 背景: 一个M-pard(铭豹)扩展坞的网卡突然无法识别了,扩展出来的三个USB接口正常。…

未来机器人的大脑:如何用神经网络模拟器实现更智能的决策?

编辑&#xff1a;陈萍萍的公主一点人工一点智能 未来机器人的大脑&#xff1a;如何用神经网络模拟器实现更智能的决策&#xff1f;RWM通过双自回归机制有效解决了复合误差、部分可观测性和随机动力学等关键挑战&#xff0c;在不依赖领域特定归纳偏见的条件下实现了卓越的预测准…

Linux应用开发之网络套接字编程(实例篇)

服务端与客户端单连接 服务端代码 #include <sys/socket.h> #include <sys/types.h> #include <netinet/in.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <arpa/inet.h> #include <pthread.h> …

华为云AI开发平台ModelArts

华为云ModelArts&#xff1a;重塑AI开发流程的“智能引擎”与“创新加速器”&#xff01; 在人工智能浪潮席卷全球的2025年&#xff0c;企业拥抱AI的意愿空前高涨&#xff0c;但技术门槛高、流程复杂、资源投入巨大的现实&#xff0c;却让许多创新构想止步于实验室。数据科学家…

深度学习在微纳光子学中的应用

深度学习在微纳光子学中的主要应用方向 深度学习与微纳光子学的结合主要集中在以下几个方向&#xff1a; 逆向设计 通过神经网络快速预测微纳结构的光学响应&#xff0c;替代传统耗时的数值模拟方法。例如设计超表面、光子晶体等结构。 特征提取与优化 从复杂的光学数据中自…