安裝
dotnet add package Davish.Sendr如果某個 domain/application 組件只需要參照訊息合約(IRequest、IRequestHandler、
ISender 等),而不想連帶依賴 DI 實作,可以改參照合約套件:
dotnet add package Davish.Sendr.AbstractionsDavish.Sendr 本身已經依賴 Davish.Sendr.Abstractions,所以應用程式的進入點專案只需要
安裝前者即可。
註冊 AddSendr 與 handler
builder.Services
.AddSendr()
.AddRequestHandler<CreateOrder, CreateOrderHandler>()
.AddRequestHandler<GetOrder, OrderDto, GetOrderHandler>();AddRequestHandler<TRequest, THandler> 用於沒有回傳值的 request(IRequest);
AddRequestHandler<TRequest, TResponse, THandler> 用於會回傳值的 request
(IRequest<TResponse>)。每個 request/response 組合最多只能註冊一個 handler。註冊了
第二個、或完全沒有註冊,會發生什麼事,見分派模型。
定義訊息與 handler
public sealed record CreateOrder(Guid Id) : IRequest;
public sealed class CreateOrderHandler : IRequestHandler<CreateOrder>
{
public Task HandleAsync(CreateOrder request, CancellationToken cancellationToken = default)
{
return Task.CompletedTask;
}
}
public sealed record GetOrder(Guid Id) : IRequest<OrderDto>;
public sealed record OrderDto(Guid Id, string Number);
public sealed class GetOrderHandler : IRequestHandler<GetOrder, OrderDto>
{
public Task<OrderDto> HandleAsync(GetOrder request, CancellationToken cancellationToken = default)
{
return Task.FromResult(new OrderDto(request.Id, "SO-001"));
}
}發送
解析出 ISender 並呼叫 SendAsync:
var sender = serviceProvider.GetRequiredService<ISender>();
await sender.SendAsync(new CreateOrder(Guid.NewGuid()), cancellationToken);
var order = await sender.SendAsync(new GetOrder(Guid.NewGuid()), cancellationToken);接下來可以看
- 需要 CQRS 風格的合約(
ICommand/IQuery),而不是(或搭配)IRequest?見 註冊 handler。 - 需要在 handler 執行前後加上記錄、交易等行為?見 使用 decorator。
- 需要把一個事件同時發送給多個 handler?見 發佈 notification。
- 想要 reflection-free 的分派方式而不是預設的反射式 sender?見 啟用 source generation。