49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
---
|
||
applyTo: "src/Fengling.Member.Web/Application/IntegrationEventConverters/*.cs"
|
||
---
|
||
|
||
# 集成事件转换器开发指南
|
||
|
||
## 开发原则
|
||
|
||
### 必须
|
||
|
||
- **转换器定义**：
|
||
- 必须实现 `IIntegrationEventConverter<TDomainEvent, TIntegrationEvent>` 接口。
|
||
- 转换器负责从领域事件创建集成事件。
|
||
- 集成事件使用 `record` 类型定义。
|
||
- **注册**：框架自动注册转换器。
|
||
|
||
### 必须不要
|
||
|
||
- **直接发布**：不要直接发布集成事件，应通过转换器。
|
||
|
||
## 文件命名规则
|
||
|
||
- 转换器应放置在 `src/Fengling.Member.Web/Application/IntegrationEventConverters/` 目录下。
|
||
- 转换器文件名格式为 `{Entity}{Action}IntegrationEventConverter.cs`。
|
||
|
||
## 代码示例
|
||
|
||
**文件**: `src/Fengling.Member.Web/Application/IntegrationEventConverters/UserCreatedIntegrationEventConverter.cs`
|
||
|
||
```csharp
|
||
using Fengling.Member.Domain.DomainEvents;
|
||
using Fengling.Member.Web.Application.IntegrationEvents;
|
||
|
||
namespace Fengling.Member.Web.Application.IntegrationEventConverters;
|
||
|
||
public class UserCreatedIntegrationEventConverter
|
||
: IIntegrationEventConverter<UserCreatedDomainEvent, UserCreatedIntegrationEvent>
|
||
{
|
||
public UserCreatedIntegrationEvent Convert(UserCreatedDomainEvent domainEvent)
|
||
{
|
||
var user = domainEvent.User;
|
||
return new UserCreatedIntegrationEvent(
|
||
user.Id,
|
||
user.Name,
|
||
user.Email,
|
||
DateTime.UtcNow);
|
||
}
|
||
}
|
||
``` |