Rails Event Store 核心概念：发布-订阅模式详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00280/article/details/148993184

Rails Event Store 核心概念：发布-订阅模式详解

前言

在现代应用开发中，事件驱动架构(EDA)正变得越来越流行。Rails Event Store 作为一个强大的事件存储和发布-订阅系统，为 Ruby on Rails 应用提供了实现这一架构的完整解决方案。本文将深入探讨其发布-订阅(Pub-Sub)机制的核心概念和使用方法。

什么是发布-订阅模式？

发布-订阅模式是一种消息传递范式，其中消息的发送者（发布者）不会直接将消息发送给特定的接收者（订阅者）。相反，发布的消息会被分类，订阅者只需接收感兴趣的消息类别，而不需要知道哪些发布者存在。

定义事件

在 Rails Event Store 中，事件是系统中最基本的构建块。每个事件都代表系统中发生的重要事实。

class OrderCancelled < RailsEventStore::Event
end

定义事件时需要注意：

事件类必须继承自 RailsEventStore::Event
事件名称应该使用过去时态，表示已经发生的事实
事件可以包含数据属性，记录事件发生时的上下文信息

配置事件存储客户端

在 Rails 应用中，我们通常在应用配置阶段初始化事件存储客户端：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    config.to_prepare { Rails.configuration.event_store = RailsEventStore::Client.new }
  end
end

这种配置方式确保了：

事件存储客户端在应用启动时初始化
在开发环境中，代码重新加载后也会重新初始化
整个应用都可以通过 Rails.configuration.event_store 访问

发布事件

发布事件是通知系统某个重要事实已经发生的方式：

class CancelOrder
  def call(order_id, user_id)
    order = Order.find_by!(customer_id: user_id, order_id: order_id)
    order.cancel!
    event_store.publish(
      OrderCancelled.new(data: { order_id: order.id, customer_id: order.customer_id }),
      stream_name: "Order-#{order.id}",
    )
  end

  private

  def event_store
    Rails.configuration.event_store
  end
end

关键点：

事件发布通常发生在业务操作完成后
data 哈希包含了事件的上下文信息
stream_name 指定了事件所属的流，便于后续查询

订阅事件

对象订阅方式

任何响应 call 方法的对象都可以作为事件处理器：

cancel_order = CancelOrder.new
event_store = Rails.configuration.event_store
listener = OrderNotifier.new

event_store.within { cancel_order.call(order_id, user_id) }.subscribe(listener, to: [OrderCancelled]).call

处理器实现示例：

class OrderNotifier
  def call(event)
    order_id = order.data.fetch(:order_id)
    case event
    when OrderCancelled
      # 发送取消通知
    else
      raise "不支持的事件类型 #{event.inspect}"
    end
  end
end

块订阅方式

对于简单处理逻辑，可以直接使用块：

event_store
  .within { cancel_order.call(order_id, user_id) }
  .subscribe(to: [OrderCancelled]) { |event| Rails.logger.warn(event.inspect) }
  .call

全局订阅

对于需要长期监听的事件，可以在应用配置中设置全局订阅：

# config/application.rb
module YourAppName
  class Application < Rails::Application
    config.to_prepare do
      Rails.configuration.event_store = event_store = RailsEventStore::Client.new
      event_store.subscribe(OrderNotifier.new, to: [OrderCancelled])
    end
  end
end