這些行為是刻意的設計,但很容易踩到。
一個類別實作多種 handler 介面
[DecorateWith<...>] 會套用到類別實作的每一個 handler 介面。這個類別處理幾種訊息,generator
就會用每一種訊息需要的 decorator 介面檢查一次。
[DecorateWith<AuditCommandDecorator>] // 只實作 ICommandDecorator
public sealed class OrderHandlers : ICommandHandler<PlaceOrder>, IQueryHandler<GetOrder, OrderDto>
{
// ...
}這會報 SENDR001:'AuditCommandDecorator' does not implement Davish.Sendr.IQueryDecorator, required to decorate 'OrderHandlers'.
怎麼做:
- 把類別拆成一個訊息一個 handler,只在需要的 handler 掛
[DecorateWith<...>]。 - 或者讓 decorator 實作這個類別需要的每一種 decorator 介面(這個例子是
ICommandDecorator和IQueryDecorator)。
衍生型別的 request 不會派送到 base 的 handler
兩種 sender 都用訊息的執行期型別找 handler,Microsoft.Extensions.DependencyInjection 也不會解析 variant 的 handler 型別。所以 base 型別的 handler 處理不了衍生型別:
public record BaseCommand : ICommand;
public sealed record DerivedCommand : BaseCommand;
services.AddCommandHandler<BaseCommand, BaseCommandHandler>();
await sender.SendAsync(new BaseCommand(), ct); // 由 BaseCommandHandler 處理
await sender.SendAsync(new DerivedCommand(), ct); // InvalidOperationException:DerivedCommand 沒有 handler這是刻意的取捨:用完全相同的型別查表只要讀一次 dictionary,每次送出都不用沿著繼承鏈往上找。
怎麼做:每個會送出的具體型別都註冊一個 handler。多個 handler 可以用共同的 base class 或服務共用邏輯。
在測試裡替換 handler
能不能把 handler 換成 test double,要看 sender 怎麼設定。
| Sender | 替換 I...Handler<...> 的註冊 | 替換 handler 類別本身的註冊 |
|---|---|---|
手動(AddXxxHandler) | 有效,但用 AddXxxHandler 設定的 decorator 不會套用到替換後的 handler | 沒有作用:註冊的是介面 |
Generated(UseGenerators()) | 沒有作用:generated sender 直接解析 handler 類別 | 有效,handler 的 [DecorateWith<...>] decorator 照常執行 |
用 generated sender 時,最簡單的做法是保留真正的 handler,替換它依賴的服務。需要不同的 handler
實例時,替換 handler 類別本身的註冊。handler 類別是在 AddSendr 裡註冊的,所以 Replace 要在
AddSendr 之後呼叫:
using Microsoft.Extensions.DependencyInjection.Extensions; // Replace 在這個命名空間
services.AddSendr(o => o.UseGenerators());
services.Replace(ServiceDescriptor.Transient<GetOrderHandler>(_ => new GetOrderHandler(fakeRepository)));實作了 handler 介面的 test double 本身就是一個 handler。它所在的專案如果參考了
Davish.Sendr.Generators,而真正的 handler 也在同一次 generator 執行中被找到(在同一個專案裡,或在
這個專案用 IncludeAssemblyOf<...>() 引入的組件裡),generator 就會因為重複而報 SENDR002。
之後的版本可能會調整這個行為。