60 lines
2.2 KiB
Markdown
60 lines
2.2 KiB
Markdown
---
|
||
applyTo: "src/Fengling.Member.Web/Application/IntegrationEventHandlers/*.cs"
|
||
---
|
||
|
||
# 集成事件处理器开发指南
|
||
|
||
## 开发原则
|
||
|
||
### 必须
|
||
|
||
- **处理器定义**：
|
||
- 必须实现 `IIntegrationEventHandler<T>` 接口。
|
||
- 实现方法：`public Task HandleAsync(TIntegrationEvent integrationEvent, CancellationToken cancellationToken)`。
|
||
- 每个集成事件可以对应多个处理器，每个处理器对应特定的业务目的。
|
||
- 使用主构造函数注入所需的服务。
|
||
- **业务逻辑**：
|
||
- 处理来自其他服务的集成事件。
|
||
- 主要用于跨服务的数据同步和业务协调。
|
||
- 通过发送 Command 来操作聚合，而不是直接操作。
|
||
- **注册**：框架自动注册事件处理器。
|
||
|
||
### 必须不要
|
||
|
||
- **直接操作**：不要直接操作聚合，应通过 Command。
|
||
|
||
## 文件命名规则
|
||
|
||
- 类文件应放置在 `src/Fengling.Member.Web/Application/IntegrationEventHandlers/` 目录下。
|
||
- 文件名格式为 `{IntegrationEvent}HandlerFor{Action}.cs`，其中 `{Action}` 需要准确描述该 Handler 的目的。
|
||
- 一个文件仅包含一个集成事件处理器。
|
||
|
||
## 代码示例
|
||
|
||
**文件**: `src/Fengling.Member.Web/Application/IntegrationEventHandlers/UserCreatedIntegrationEventHandlerForSendNotifyEmail.cs`
|
||
|
||
```csharp
|
||
using Fengling.Member.Web.Application.IntegrationEvents;
|
||
using Fengling.Member.Web.Application.Commands.Users;
|
||
|
||
namespace Fengling.Member.Web.Application.IntegrationEventHandlers;
|
||
|
||
public class UserCreatedIntegrationEventHandlerForSendNotifyEmail(
|
||
ILogger<UserCreatedIntegrationEventHandlerForSendNotifyEmail> logger,
|
||
IMediator mediator)
|
||
: IIntegrationEventHandler<UserCreatedIntegrationEvent>
|
||
{
|
||
public async Task HandleAsync(UserCreatedIntegrationEvent integrationEvent, CancellationToken cancellationToken)
|
||
{
|
||
logger.LogInformation("发送用户创建通知邮件：{UserId}", integrationEvent.UserId);
|
||
|
||
// 通过Command发送通知邮件
|
||
var command = new SendWelcomeEmailCommand(
|
||
integrationEvent.UserId,
|
||
integrationEvent.Email,
|
||
integrationEvent.Name);
|
||
|
||
await mediator.Send(command, cancellationToken);
|
||
}
|
||
}
|
||
``` |