RailsEventStore项目：实现唯一事件发布的模式解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01041/article/details/148993178

RailsEventStore项目：实现唯一事件发布的模式解析

rails_event_store A Ruby implementation of an Event Store based on Active Record 项目地址: https://gitcode.com/gh_mirrors/ra/rails_event_store

引言

在现代事件驱动架构中，确保事件的唯一性发布是一个常见且重要的需求。RailsEventStore作为Ruby生态中成熟的事件存储解决方案，提供了一套优雅的机制来处理这类场景。本文将深入探讨如何利用RailsEventStore的特性来实现事件的唯一性发布。

为什么需要唯一事件发布？

在分布式系统中，我们经常会遇到需要确保某个操作只执行一次的场景。例如：

处理来自外部系统的支付回调
接收第三方服务的Webhook通知
执行幂等性要求高的业务操作

在这些场景下，如果因为网络问题导致请求重试，或者系统崩溃后恢复重试，我们需要确保相同的事件不会被重复处理。

RailsEventStore的核心机制

RailsEventStore通过expected_version参数提供了一种简洁而强大的方式来实现这一需求。其核心思想是：

为每个需要唯一性的事件创建一个特殊的流(stream)
在发布事件时，指定期望该流当前为空
如果流已存在（即事件已发布），则捕获并处理冲突

实现模式详解

基础实现

def publish_event_uniquely(event, *fields)
  uniqueness_key = [event.event_type, *fields].join("_")
  event_store.publish(event, stream_name: "$unique_by_#{uniqueness_key}", expected_version: :none)
rescue RubyEventStore::WrongExpectedEventVersion
end

这段代码展示了最基本的实现方式：

构造唯一性键(uniqueness_key)：结合事件类型和其他关键字段
发布事件到特殊命名的流：以$unique_by_为前缀
设置expected_version: :none表示期望该流不存在
捕获WrongExpectedEventVersion异常处理冲突情况

唯一性键的设计要点

唯一性键的设计是整个模式的关键所在。好的唯一性键应该：

对于相同的业务操作，生成的键值相同
对于不同的业务操作，生成的键值不同
包含足够的信息来区分不同的业务场景

常见的键组成部分包括：

事件类型
业务实体ID
操作类型
时间窗口（如天/小时粒度）

高级应用场景

带时间窗口的唯一性

def publish_event_uniquely(event, entity_id, time_window = Date.today.to_s)
  uniqueness_key = [event.event_type, entity_id, time_window].join("_")
  event_store.publish(event, stream_name: "$unique_by_#{uniqueness_key}", expected_version: :none)
rescue RubyEventStore::WrongExpectedEventVersion
end

这种实现允许同一实体在一天内只发布一次特定类型的事件。

复合业务键

def publish_event_uniquely(event, user_id, product_id, operation_type)
  uniqueness_key = [event.event_type, user_id, product_id, operation_type].join("_")
  event_store.publish(event, stream_name: "$unique_by_#{uniqueness_key}", expected_version: :none)
rescue RubyEventStore::WrongExpectedEventVersion
end

这种实现适用于更复杂的业务场景，如用户对商品的特定操作。