<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>參考文件 on Davish.Sendr</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/</link><description>Recent content in 參考文件 on Davish.Sendr</description><generator>Hugo</generator><language>zh-TW</language><atom:link href="https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/index.xml" rel="self" type="application/rss+xml"/><item><title>套件列表</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/packages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/packages/</guid><description>&lt;p&gt;這個 repo 產出的每一個套件、它的用途，以及目前版本（來自各專案的 &lt;code&gt;.csproj&lt;/code&gt;；請以&#10;&lt;code&gt;.csproj&lt;/code&gt; 目前的值為準，這份表格只是某一刻的快照）。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;PackageId&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;版本&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;狀態&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;用途&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3.6.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;目前主力&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Request/response 與 stream 分派、notification 發佈、decorator pipeline、tracing（&lt;code&gt;SendrActivitySource&lt;/code&gt;）、DI 註冊（&lt;code&gt;AddSendr&lt;/code&gt;、&lt;code&gt;AddSendrNotification&lt;/code&gt;）。依賴 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;目前主力&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;只有合約：&lt;code&gt;IRequest&lt;/code&gt;、&lt;code&gt;IRequestHandler&lt;/code&gt;、&lt;code&gt;IRequestDecorator&lt;/code&gt;、&lt;code&gt;ISender&lt;/code&gt;、&lt;code&gt;ICommand&lt;/code&gt;、&lt;code&gt;IQuery&lt;/code&gt;、&lt;code&gt;INotification&lt;/code&gt;、&lt;code&gt;INotificationHandler&lt;/code&gt;、&lt;code&gt;INotificationDecorator&lt;/code&gt;、&lt;code&gt;IPublisher&lt;/code&gt; 等相關型別。沒有 DI 實作。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Generators&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.2.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;目前主力，選用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Roslyn incremental source generator：編譯期 handler 發現、&lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; 佈線，透過 &lt;code&gt;UseGenerators()&lt;/code&gt; 提供 reflection-free 的 &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;2.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;已棄用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;ICommandHandler&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt;/&lt;code&gt;IQueryHandler&lt;/code&gt; 的相容性用殼，現在移到 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;。沒有自己的內容；未來的主要版本會移除。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;3.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;已棄用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Notification 發佈（&lt;code&gt;IPublisher&lt;/code&gt;、&lt;code&gt;AddSendrNotification&lt;/code&gt;、&lt;code&gt;AddNotificationHandler&lt;/code&gt; 等）的相容性用殼，現在移到 &lt;code&gt;Davish.Sendr&lt;/code&gt;。沒有自己的內容；未來的主要版本會移除。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;4.0.0&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;已棄用&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;INotification&lt;/code&gt;/&lt;code&gt;INotificationHandler&lt;/code&gt;/&lt;code&gt;INotificationDecorator&lt;/code&gt;/&lt;code&gt;IPublisher&lt;/code&gt; 合約的相容性用殼，現在移到 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;。沒有自己的內容；未來的主要版本會移除。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;從已棄用套件遷移的方式，見&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/migrating-from-deprecated-packages/"&gt;從已棄用套件遷移&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="不會發行的專案"&gt;不會發行的專案&lt;a class="anchor" href="#%e4%b8%8d%e6%9c%83%e7%99%bc%e8%a1%8c%e7%9a%84%e5%b0%88%e6%a1%88"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;Sendr.Shared&lt;/code&gt;（專案的 &lt;code&gt;PackageId&lt;/code&gt; 會退回用專案名稱；它的 &lt;code&gt;AssemblyName&lt;/code&gt; 是&#10;&lt;code&gt;Davish.Sendr.Shared&lt;/code&gt;）設定了 &lt;code&gt;IsPackable=false&lt;/code&gt;，它不會以自己的 NuGet 套件形式發行。&#10;它保存的是這個 repo 裡其他專案直接參照的原始碼，包括 &lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; 所使用的&#10;&lt;code&gt;DecorateWithAttribute&amp;lt;...&amp;gt;&lt;/code&gt; 系列。&lt;/p&gt;</description></item><item><title>例外與診斷</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/exceptions-and-diagnostics/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/exceptions-and-diagnostics/</guid><description>&lt;h2 id="執行期例外"&gt;執行期例外&lt;a class="anchor" href="#%e5%9f%b7%e8%a1%8c%e6%9c%9f%e4%be%8b%e5%a4%96"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;h3 id="找不到-handler--invalidoperationexception"&gt;找不到 handler — &lt;code&gt;InvalidOperationException&lt;/code&gt;&lt;a class="anchor" href="#%e6%89%be%e4%b8%8d%e5%88%b0-handler--invalidoperationexception"&gt;&lt;/a&gt;&lt;/h3&gt;&#10;&lt;p&gt;當分派一個沒有註冊 handler 的 request/command/query/stream 時丟出（對 stream 來說，&#10;是在開始列舉時）。訊息裡會指名缺少的那個具體註冊呼叫：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Davish.Sendr: no handler is registered for &amp;#39;&amp;lt;requestType&amp;gt;&amp;#39;. Call services.&amp;lt;registrationMethod&amp;gt;&amp;lt;&amp;lt;requestType&amp;gt;, YourHandler&amp;gt;() during startup.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;或者，對有回應型別的 request/command/query 而言：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;Davish.Sendr: no handler is registered for &amp;#39;&amp;lt;requestType&amp;gt;&amp;#39; with response &amp;#39;&amp;lt;responseType&amp;gt;&amp;#39;. Call services.&amp;lt;registrationMethod&amp;gt;&amp;lt;&amp;lt;requestType&amp;gt;, &amp;lt;responseType&amp;gt;, YourHandler&amp;gt;() during startup.&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;&amp;lt;registrationMethod&amp;gt;&lt;/code&gt; 會是 &lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&#10;&lt;code&gt;AddQueryHandler&lt;/code&gt;/&lt;code&gt;AddStreamRequestHandler&lt;/code&gt; 裡，符合該訊息種類的那一個。&lt;/p&gt;&#10;&lt;h4 id="covariant-轉型之後"&gt;covariant 轉型之後&lt;a class="anchor" href="#covariant-%e8%bd%89%e5%9e%8b%e4%b9%8b%e5%be%8c"&gt;&lt;/a&gt;&lt;/h4&gt;&#10;&lt;p&gt;&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;、&lt;code&gt;ICommand&amp;lt;TResponse&amp;gt;&lt;/code&gt;、&lt;code&gt;IQuery&amp;lt;TResponse&amp;gt;&lt;/code&gt;、&#10;&lt;code&gt;IStreamRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; 都是 covariant，所以下面這段可以編譯：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;IQuery&amp;lt;&lt;span style="color:#66d9ef"&gt;object&lt;/span&gt;&amp;gt; query = &lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; StringQuery(); &lt;span style="color:#75715e"&gt;// StringQuery : IQuery&amp;lt;string&amp;gt;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; sender.SendAsync(query, cancellationToken);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;查 handler 時用的是訊息的執行期型別加上靜態的 response 型別，這裡是 &lt;code&gt;(StringQuery, object)&lt;/code&gt;，&#10;所以找不到 &lt;code&gt;StringQuery&lt;/code&gt; 的 handler。這時手動與 generated 兩種 sender 都會指出是轉型造成的，&#10;不會建議註冊 handler：&lt;/p&gt;</description></item><item><title>擴充性</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/extensibility/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/extensibility/</guid><description>&lt;p&gt;用於接上自訂的 &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt; 或 &lt;code&gt;IPublisher&lt;/code&gt; 實作，取代預設的反射式版本&#10;或產生出來的版本。&lt;/p&gt;&#10;&lt;h2 id="sendroptions"&gt;&lt;code&gt;SendrOptions&lt;/code&gt;&lt;a class="anchor" href="#sendroptions"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;傳給 &lt;code&gt;AddSendr(configure)&lt;/code&gt; 的 &lt;code&gt;configure&lt;/code&gt; delegate。&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;成員&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;簽章&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;說明&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Services&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IServiceCollection Services { get; }&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;AddSendr&lt;/code&gt; 正在設定的那個 collection。像產生出來的 &lt;code&gt;UseGenerators()&lt;/code&gt; 這種擴充，會用它來在自訂 sender 之外一併註冊 handler/decorator。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;UseSender&amp;lt;TSender&amp;gt;()&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SendrOptions UseSender&amp;lt;TSender&amp;gt;() where TSender : class, ISender, IStreamSender&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;把 &lt;code&gt;TSender&lt;/code&gt; 同時註冊為 &lt;code&gt;ISender&lt;/code&gt; 與 &lt;code&gt;IStreamSender&lt;/code&gt;，取代預設的 sender。回傳 &lt;code&gt;this&lt;/code&gt; 以便串接。這正是 &lt;code&gt;UseGenerators()&lt;/code&gt; 內部用來安裝產生出來的 sender 的方法。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;在同一個 scope 內，&lt;code&gt;TSender&lt;/code&gt; 對 &lt;code&gt;ISender&lt;/code&gt; 與 &lt;code&gt;IStreamSender&lt;/code&gt; 會解析成同一個實例&#10;（&lt;code&gt;IStreamSender&lt;/code&gt; 是透過 &lt;code&gt;ISender&lt;/code&gt; 解析，而不是自己另外建構一個實例），但每個介面仍是&#10;各自獨立的 DI 註冊。如果 &lt;code&gt;TSender&lt;/code&gt; 實作了 &lt;code&gt;IDisposable&lt;/code&gt;/&lt;code&gt;IAsyncDisposable&lt;/code&gt;，某個 scope&#10;同時解析這兩個介面時，容器會依每個註冊各呼叫一次 disposal（總共兩次），請把 disposal&#10;實作成可重複呼叫（idempotent）。&lt;/p&gt;</description></item><item><title>Tracing 的 span 與 tag</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/tracing-spans-and-tags/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/tracing-spans-and-tags/</guid><description>&lt;p&gt;每個 span 都來自名為 &lt;code&gt;Davish.Sendr&lt;/code&gt; 的 &lt;code&gt;ActivitySource&lt;/code&gt;（&lt;code&gt;SendrActivitySource.Name&lt;/code&gt;），&#10;&lt;code&gt;ActivityKind&lt;/code&gt; 是 &lt;code&gt;Internal&lt;/code&gt;。如何訂閱它，見 &lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/tracing/"&gt;Tracing&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="span"&gt;Span&lt;a class="anchor" href="#span"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Span&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;顯示名稱&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;什麼時候送出&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Send&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Send &amp;lt;TypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每一次對 request、command 或 query 呼叫 &lt;code&gt;ISender.SendAsync&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Publish&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Publish &amp;lt;TypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每一次 &lt;code&gt;IPublisher.PublishAsync&lt;/code&gt;，且該 notification 至少有一個 handler。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Handle&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;Handle &amp;lt;HandlerTypeName&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;每一個實際執行的 notification handler，包含它的 decorator。是 &lt;code&gt;Publish&lt;/code&gt; span 的子 span。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;&lt;code&gt;&amp;lt;TypeName&amp;gt;&lt;/code&gt; 與 &lt;code&gt;&amp;lt;HandlerTypeName&amp;gt;&lt;/code&gt; 是該型別不含命名空間的簡短名稱。完整名稱放在 tag 裡。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;ISender.SendStream&lt;/code&gt; 目前還不會送出 span。&lt;/p&gt;&#10;&lt;h2 id="tag"&gt;Tag&lt;a class="anchor" href="#tag"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Tag&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;出現在&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;值&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;sendr.kind&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;所有 span&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;request&lt;/code&gt;、&lt;code&gt;command&lt;/code&gt;、&lt;code&gt;query&lt;/code&gt;、&lt;code&gt;notification&lt;/code&gt; 或 &lt;code&gt;notification.handler&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;sendr.request.type&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Send、Publish&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;request、command、query 或 notification 型別的完整名稱。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;sendr.handler.type&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Handle&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;handler 型別的完整名稱。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;sendr.notification.group&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Handle&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;sequence&lt;/code&gt; 或 &lt;code&gt;parallel&lt;/code&gt;。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;error.type&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;任何 span&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;例外型別的完整名稱。只在分派失敗時設定。&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;request 與 notification 的內容絕不會被記錄。&lt;/p&gt;</description></item><item><title>限制與注意事項</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/limitations/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/limitations/</guid><description>&lt;p&gt;這些行為是刻意的設計，但很容易踩到。&lt;/p&gt;&#10;&lt;h2 id="一個類別實作多種-handler-介面"&gt;一個類別實作多種 handler 介面&lt;a class="anchor" href="#%e4%b8%80%e5%80%8b%e9%a1%9e%e5%88%a5%e5%af%a6%e4%bd%9c%e5%a4%9a%e7%a8%ae-handler-%e4%bb%8b%e9%9d%a2"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt; 會套用到類別實作的每一個 handler 介面。這個類別處理幾種訊息，generator&#10;就會用每一種訊息需要的 decorator 介面檢查一次。&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#a6e22e"&gt;[DecorateWith&amp;lt;AuditCommandDecorator&amp;gt;]&lt;/span&gt; &lt;span style="color:#75715e"&gt;// 只實作 ICommandDecorator&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderHandlers&lt;/span&gt; : ICommandHandler&amp;lt;PlaceOrder&amp;gt;, IQueryHandler&amp;lt;GetOrder, OrderDto&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#75715e"&gt;// ...&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;這會報 &lt;code&gt;SENDR001&lt;/code&gt;：&lt;code&gt;'AuditCommandDecorator' does not implement Davish.Sendr.IQueryDecorator, required to decorate 'OrderHandlers'.&lt;/code&gt;&lt;/p&gt;&#10;&lt;p&gt;怎麼做：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;把類別拆成一個訊息一個 handler，只在需要的 handler 掛 &lt;code&gt;[DecorateWith&amp;lt;...&amp;gt;]&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;或者讓 decorator 實作這個類別需要的每一種 decorator 介面（這個例子是 &lt;code&gt;ICommandDecorator&lt;/code&gt; 和&#10;&lt;code&gt;IQueryDecorator&lt;/code&gt;）。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="衍生型別的-request-不會派送到-base-的-handler"&gt;衍生型別的 request 不會派送到 base 的 handler&lt;a class="anchor" href="#%e8%a1%8d%e7%94%9f%e5%9e%8b%e5%88%a5%e7%9a%84-request-%e4%b8%8d%e6%9c%83%e6%b4%be%e9%80%81%e5%88%b0-base-%e7%9a%84-handler"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;兩種 sender 都用訊息的執行期型別找 handler，Microsoft.Extensions.DependencyInjection 也不會解析&#10;variant 的 handler 型別。所以 base 型別的 handler 處理不了衍生型別：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;BaseCommand&lt;/span&gt; : ICommand;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;DerivedCommand&lt;/span&gt; : BaseCommand;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;services.AddCommandHandler&amp;lt;BaseCommand, BaseCommandHandler&amp;gt;();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; sender.SendAsync(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; BaseCommand(), ct); &lt;span style="color:#75715e"&gt;// 由 BaseCommandHandler 處理&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; sender.SendAsync(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; DerivedCommand(), ct); &lt;span style="color:#75715e"&gt;// InvalidOperationException：DerivedCommand 沒有 handler&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;這是刻意的取捨：用完全相同的型別查表只要讀一次 dictionary，每次送出都不用沿著繼承鏈往上找。&lt;/p&gt;</description></item></channel></rss>