Marten 8 中新增 FetchLatestGoodState API 解析
2025-06-26 18:53:48作者:董宙帆
Marten 是一个.NET平台上的事件溯源和文档数据库库,最近在其第8版中引入了一个重要的增强功能——FetchLatestGoodState API。这个新功能解决了在严格事件处理模式下获取聚合状态的核心问题。
背景与问题
在事件溯源系统中,聚合状态是通过按顺序应用事件流中的事件来重建的。Marten 8 版本之前,当处理包含删除操作的事件流时,系统行为存在一些模糊地带。具体来说,当事件流的最新位置是一个标记为ShouldDelete()的操作时,传统的AggregateStreamAsync()方法会返回null,表示聚合已被删除。
这种严格的行为在某些业务场景下会带来不便。例如,当我们需要了解被删除聚合的最后有效状态时(可能是为了审计、分析或恢复目的),原有的API就无法满足需求。
解决方案:FetchLatestGoodState
Marten 8 引入了FetchLatestGoodState<T>(streamId/Key)方法,它提供了与AggregateStreamAsync()相似的功能,但有一个关键区别:无论流的最新操作是什么,它都会返回聚合的最后已知"有效"状态。
这个API的设计哲学是:
- 如果流没有被删除,行为与
AggregateStreamAsync()完全相同 - 如果流已被删除,返回删除前的最后一个有效状态
- 提供了一种"安全"的方式来访问历史状态,不会因为删除操作而丢失信息
技术实现要点
从代码提交历史可以看出,这个功能的实现经过了精心设计:
- 底层查询被优化为只获取必要的版本信息
- 保持了与现有API一致的使用模式
- 性能考虑到了大规模事件流的情况
- 与Marten的其他特性(如快照)保持兼容
使用场景
这个新API特别适用于以下场景:
- 审计追踪:即使聚合被删除,也能查看其最后状态
- 错误恢复:当需要撤销删除操作时,可以基于最后状态重建
- 分析报告:统计被删除聚合的最终特征
- 业务工作流:在某些业务流程中,删除后仍需要参考先前状态
最佳实践
在使用这个新API时,建议:
- 明确区分业务上需要"当前状态"还是"最后有效状态"
- 对于关键业务操作,仍然使用严格的
AggregateStreamAsync() - 在读取密集但更新少的场景,考虑结合快照功能使用
- 注意事务边界,确保读取的状态与业务预期一致
总结
Marten 8的FetchLatestGoodState API为事件溯源系统提供了更灵活的状态访问方式,填补了严格事件处理模式下的使用空白。这个看似简单的增强,实际上为复杂业务场景下的状态管理提供了重要工具,体现了Marten项目对实际开发需求的深刻理解和快速响应能力。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00
PaddleOCR-VL-1.5PaddleOCR-VL-1.5 是 PaddleOCR-VL 的新一代进阶模型,在 OmniDocBench v1.5 上实现了 94.5% 的全新 state-of-the-art 准确率。 为了严格评估模型在真实物理畸变下的鲁棒性——包括扫描伪影、倾斜、扭曲、屏幕拍摄和光照变化——我们提出了 Real5-OmniDocBench 基准测试集。实验结果表明,该增强模型在新构建的基准测试集上达到了 SOTA 性能。此外,我们通过整合印章识别和文本检测识别(text spotting)任务扩展了模型的能力,同时保持 0.9B 的超紧凑 VLM 规模,具备高效率特性。Python00
xw-cli实现国产算力大模型零门槛部署,一键跑通 Qwen、GLM-4.7、Minimax-2.1、DeepSeek-OCR 等模型Go06
yuanrongopenYuanrong runtime:openYuanrong 多语言运行时提供函数分布式编程,支持 Python、Java、C++ 语言,实现类单机编程高性能分布式运行。Go051
pc-uishopTNT开源商城系统使用java语言开发,基于SpringBoot架构体系构建的一套b2b2c商城,商城是满足集平台自营和多商户入驻于一体的多商户运营服务系统。包含PC 端、手机端(H5\APP\小程序),系统架构以及实现案例中应满足和未来可能出现的业务系统进行对接。Vue00
ebook-to-mindmapepub、pdf 拆书 AI 总结TSX01
热门内容推荐
最新内容推荐
Degrees of Lewdity中文汉化终极指南:零基础玩家必看的完整教程Unity游戏翻译神器:XUnity Auto Translator 完整使用指南PythonWin7终极指南:在Windows 7上轻松安装Python 3.9+终极macOS键盘定制指南:用Karabiner-Elements提升10倍效率Pandas数据分析实战指南:从零基础到数据处理高手 Qwen3-235B-FP8震撼升级:256K上下文+22B激活参数7步搞定机械键盘PCB设计:从零开始打造你的专属键盘终极WeMod专业版解锁指南:3步免费获取完整高级功能DeepSeek-R1-Distill-Qwen-32B技术揭秘:小模型如何实现大模型性能突破音频修复终极指南:让每一段受损声音重获新生
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
541
3.77 K
Ascend Extension for PyTorch
Python
351
419
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
889
615
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
338
186
openJiuwen agent-studio提供零码、低码可视化开发和工作流编排,模型、知识库、插件等各资源管理能力
TSX
988
253
openGauss kernel ~ openGauss is an open source relational database management system
C++
169
233
暂无简介
Dart
778
194
华为昇腾面向大规模分布式训练的多模态大模型套件,支撑多模态生成、多模态理解。
Python
115
141
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.35 K
759