54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
---
|
||
applyTo: "src/Fengling.Member.Web/Application/DomainEventHandlers/*.cs"
|
||
---
|
||
|
||
# 领域事件处理器开发指南
|
||
|
||
## 开发原则
|
||
|
||
### 必须
|
||
|
||
- **处理器定义**：
|
||
- 必须实现 `IDomainEventHandler<T>` 接口。
|
||
- 实现方法：`public Task Handle(TEvent domainEvent, CancellationToken cancellationToken)`。
|
||
- 每个文件仅包含一个事件处理器。
|
||
- 使用主构造函数注入所需的仓储或服务。
|
||
- **命名规范**：按 `{DomainEvent}DomainEventHandlerFor{Action}` 命名，语义清晰、单一目的。
|
||
- **业务逻辑**：
|
||
- 在框架会将处理器中的命令作为事务的一部分执行。
|
||
- 通过发送 Command（`IMediator.Send`）驱动聚合变化，而不是直接操作聚合或数据库。
|
||
- 仅访问与该领域事件直接相关的数据或服务。
|
||
- 尊重事务与取消：使用 `async/await`，传递并尊重 `CancellationToken`。
|
||
|
||
### 必须不要
|
||
|
||
- **直接操作**：
|
||
- 不直接通过仓储或 DbContext 修改数据（始终通过命令）。
|
||
- **逻辑混合**：
|
||
- 不在一个文件中放多个处理器或混合不同事件的逻辑。
|
||
- **性能与异常**：
|
||
- 不执行长时间阻塞操作，耗时操作应放置在集成事件处理器中。
|
||
- 不吞掉异常或忽略 `CancellationToken`。
|
||
|
||
## 文件命名规则
|
||
|
||
- 类文件应放置在 `src/Fengling.Member.Web/Application/DomainEventHandlers/` 目录下。
|
||
- 文件名格式为 `{DomainEvent}DomainEventHandlerFor{Action}.cs`，其中 `{Action}` 准确描述该 Handler 的目的。
|
||
- 示例：`OrderCreatedDomainEventHandlerForSetPaymentInfo.cs`。
|
||
- 类命名：`{DomainEvent}DomainEventHandlerFor{Action}`。
|
||
|
||
## 代码示例
|
||
```csharp
|
||
using Fengling.Member.Web.Application.Commands;
|
||
using Fengling.Member.Web.Domain.DomainEvents;
|
||
public class OrderCreatedDomainEventHandlerForSetPaymentInfo(IMediator mediator) :
|
||
IDomainEventHandler<OrderCreatedDomainEvent>
|
||
{
|
||
public async Task Handle(OrderCreatedDomainEvent domainEvent, CancellationToken cancellationToken)
|
||
{
|
||
// 通过发送命令操作聚合，而不是直接操作服务
|
||
var command = new SetPaymentInfoCommand(domainEvent.OrderId, domainEvent.PaymentInfo);
|
||
await mediator.Send(command, cancellationToken);
|
||
}
|
||
}
|
||
``` |