CQRS
CQRS 的意思是“命令-查询责任隔离”。我们分离了命令(写请求)和查询(读请求)之间的责任。写请求和读请求由不同的对象处理。
就是这样。我们可以进一步分割数据存储，使用单独的读写存储。一旦发生这种情况，可能会有许多读取存储，这些存储针对处理不同类型的查询或跨越多个边界上下文进行了优化。虽然经常讨论与 CQRS 相关的单独读写存储，但这并不是 CQRS 本身。CQRS 只是命令和查询的第一部分。
术语
Command
该命令是一个简单的数据结构，表示执行某些操作的请求。
Command Bus
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/command_bus.go
// ...
// CommandBus 将命令(commands)传输到命令处理程序(command handlers)。
type CommandBus struct {
// ... Command Processor
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/command_processor.go
// ...
// CommandProcessor 决定哪个 CommandHandler 应该处理这个命令
received from the command bus.
type CommandProcessor struct {
// ... Command Handler
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/command_processor.go
// ...
// CommandHandler 接收由 NewCommand 定义的命令，并使用 Handle 方法处理它。
// 如果使用 DDD, CommandHandler 可以修改并持久化聚合。
//
// 与 EvenHandler 相反，每个命令必须只有一个 CommandHandler。
//
// 在处理消息期间使用 CommandHandler 的一个实例。
// 当同时发送多个命令时，Handle 方法可以同时执行多次。
// 因此，Handle 方法必须是线程安全的！
type CommandHandler interface {
// ... Event
该事件表示已经发生的事情。 事件是不可变的。
Event Bus
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/event_bus.go
// ...
// EventBus 将事件传输到事件处理程序。
type EventBus struct {
// ... Event Processor
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/event_processor.go
// ...
// EventProcessor 确定哪个 EventHandler 应该处理从事件总线接收到的事件。
type EventProcessor struct {
// ... Event Handler
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/event_processor.go
// ...
// EventHandler 接收由 NewEvent 定义的事件，并使用其 Handle 方法对其进行处理。
// 如果使用 DDD，CommandHandler 可以修改并保留聚合。
// 它还可以调用流程管理器、saga 或仅仅构建一个读取模型。
// 与 CommandHandler 相比，每个 Event 可以具有多个 EventHandler。
//
// 在处理消息时使用 EventHandler 的一个实例。
// 当同时传递多个事件时，Handle 方法可以同时执行多次。
// 因此，Handle 方法必须是线程安全的！
type EventHandler interface {
// ... CQRS Facade
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/cqrs.go
// ...
// Facade 是用于创建 Command 和 Event buses 及 processors 的 facade。
// 创建它是为了在以标准方式使用 CQRS 时避免使用 boilerplate。
// 您还可以手动创建 buses 和 processors，并从 NewFacade 中获得灵感。
type Facade struct {
// ... Command and Event Marshaler
完整源码：
- github.com/ThreeDotsLabs/watermill/components/cqrs/marshaler.go
// ...
// CommandEventMarshaler 将命令和事件 marshal 给 Watermill 的消息，反之亦然。
// 该命令的有效载荷需要 marshal 至 []bytes。
type CommandEventMarshaler interface {
// Marshal marshal 命令或事件给 Watermill 的消息。
Marshal(v interface{}) (*message.Message, error)
// Unmarshal Unmarshal watermill的信息给 v Command 或 Event。
Unmarshal(msg *message.Message, v interface{}) (err error)
// Name 返回命令或事件的名称。
// Name 用于确定接收到的命令或事件是我们想要处理的事件。
Name(v interface{}) string
// NameFromMessage 从 Watermill 的消息(由 Marshal 生成)中返回命令或事件的名称。
//
//
// 当我们将 Command 或 Event marshal 到 Watermill 的消息中时，
// 我们应该使用 NameFromMessage 而不是 Name 来避免不必要的 unmarshaling。
NameFromMessage(msg *message.Message) string
}
// ... 用法
Example domain（领域模型示例）
作为示例，我们将使用一个简单的 domain，它负责处理酒店的房间预订。
我们将使用 Event Storming 表示法来展示这个 domain 的模型。
Legend:
- blue（蓝色）便利贴是命令
- orange（橙色）便利贴是事件
- green（绿色）便利贴是读取模型，从事件异步生成
- violet（紫色）便利贴是策略，由事件触发并产生命令
- pink（粉色）便利贴是热点（hot-spots）；我们标记经常发生问题的地方
domain（领域模型）很简单：
- 客人可以预订房间（book a room）。
每当预订房间时，我们都会为客人订购啤酒（Whenever a room is booked, we order a beer）（因为我们爱客人）。
- 我们知道有时候啤酒不够（not enough beers）。
- 我们根据预订生成财务报告（financial report）。
Sending a command（发送命令）
首先，我们需要模拟访客的动作。
完整源码：
- github.com/ThreeDotsLabs/watermill/_examples/basic/5-cqrs-protobuf/main.go
// ...
bookRoomCmd := &BookRoom{
RoomId: fmt.Sprintf("%d", i),
GuestName: "John",
StartDate: startDate,
EndDate: endDate,
}
if err := commandBus.Send(context.Background(), bookRoomCmd); err != nil {
panic(err)
}
// ... Command handler
BookRoomHandler 将处理我们的命令。
完整源码：
- github.com/ThreeDotsLabs/watermill/_examples/basic/5-cqrs-protobuf/main.go
// ...
// BookRoomHandler 是一个命令处理程序，它处理 BookRoom 命令并发出 RoomBooked。
//
// 在 CQRS 中，一个命令只能由一个处理程序处理。
// 将具有此命令的另一个处理程序添加到命令处理器时，将返回错误。
type BookRoomHandler struct {
eventBus *cqrs.EventBus
}
func (b BookRoomHandler) HandlerName() string {
return "BookRoomHandler"
}
// NewCommand 返回该 handle 应该处理的命令类型。它必须是一个指针。
func (b BookRoomHandler) NewCommand() interface{} {
return &BookRoom{}
}
func (b BookRoomHandler) Handle(ctx context.Context, c interface{}) error {
// c 始终是 `NewCommand` 返回的类型，因此强制转换始终是安全的
cmd := c.(*BookRoom)
// 一些随机的价格，在生产中你可能会用更明智的方式计算
price := (rand.Int63n(40) + 1) * 10
log.Printf(
"Booked %s for %s from %s to %s",
cmd.RoomId,
cmd.GuestName,
time.Unix(cmd.StartDate.Seconds, int64(cmd.StartDate.Nanos)),
time.Unix(cmd.EndDate.Seconds, int64(cmd.EndDate.Nanos)),
)
// RoomBooked 将由 OrderBeerOnRoomBooked 事件处理程序处理，