<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Davish.Sendr</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/</link><description>Recent content on Davish.Sendr</description><generator>Hugo</generator><language>zh-TW</language><atom:link href="https://davidchen617.github.io/Davish.Sendr/zh-tw/index.xml" rel="self" type="application/rss+xml"/><item><title>分派模型</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/dispatch-model/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/dispatch-model/</guid><description>&lt;h2 id="三種獨立的訊息分類"&gt;三種獨立的訊息分類&lt;a class="anchor" href="#%e4%b8%89%e7%a8%ae%e7%8d%a8%e7%ab%8b%e7%9a%84%e8%a8%8a%e6%81%af%e5%88%86%e9%a1%9e"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;Davish.Sendr 把訊息合約分成三種，全部透過 &lt;code&gt;ISender&lt;/code&gt; 分派：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;IRequest&lt;/code&gt; / &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; — 一般的 request/response。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;ICommand&lt;/code&gt; / &lt;code&gt;ICommand&amp;lt;TResponse&amp;gt;&lt;/code&gt; — 明確的 CQRS command 合約。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;IQuery&amp;lt;TResponse&amp;gt;&lt;/code&gt; — 明確的 CQRS query 合約。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;&lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt; 與 &lt;code&gt;IRequest&lt;/code&gt; 互相獨立：command 的 handler 實作 &lt;code&gt;ICommandHandler&lt;/code&gt;，&#10;不是 &lt;code&gt;IRequestHandler&lt;/code&gt;。每一種都有自己的 handler 介面、&lt;code&gt;ISender.SendAsync&lt;/code&gt; 多載、&#10;註冊方法（&lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&lt;code&gt;AddQueryHandler&lt;/code&gt;），以及 decorator&#10;介面。在呼叫端，&lt;code&gt;ISender.SendAsync&lt;/code&gt; 會依引數的靜態型別自動選對多載，呼叫端不需要知道&#10;某個訊息屬於哪一種。&lt;/p&gt;&#10;&lt;p&gt;&lt;code&gt;IStreamRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; / &lt;code&gt;IStreamRequestHandler&amp;lt;TRequest, TResponse&amp;gt;&lt;/code&gt; 是第四種，&#10;透過 &lt;code&gt;IStreamSender&lt;/code&gt;（&lt;code&gt;ISender&lt;/code&gt; 也實作了這個介面）分派，回傳的是&#10;&lt;code&gt;IAsyncEnumerable&amp;lt;TResponse&amp;gt;&lt;/code&gt;，而不是 &lt;code&gt;Task&lt;/code&gt;/&lt;code&gt;Task&amp;lt;TResponse&amp;gt;&lt;/code&gt;。&lt;/p&gt;&#10;&lt;p&gt;四種放在一起看：&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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrder&lt;/span&gt;(Guid Id) : IRequest; &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 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;PlaceOrder&lt;/span&gt;(Guid Id) : ICommand; &lt;span style="color:#75715e"&gt;// 無回應值，CQRS&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;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrder&lt;/span&gt;(Guid Id) : IQuery&amp;lt;OrderDto&amp;gt;; &lt;span style="color:#75715e"&gt;// CQRS，有回應值&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;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;ListOrders&lt;/span&gt; : IStreamRequest&amp;lt;OrderDto&amp;gt;; &lt;span style="color:#75715e"&gt;// async stream&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="每個-requestresponse-組合只能有一個-handler"&gt;每個 request/response 組合只能有一個 handler&lt;a class="anchor" href="#%e6%af%8f%e5%80%8b-requestresponse-%e7%b5%84%e5%90%88%e5%8f%aa%e8%83%bd%e6%9c%89%e4%b8%80%e5%80%8b-handler"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;IRequest&lt;/code&gt;、&lt;code&gt;ICommand&lt;/code&gt;、&lt;code&gt;IQuery&lt;/code&gt;、&lt;code&gt;IStreamRequest&lt;/code&gt; 這四種，每個 request 型別（對於&#10;泛型形式，則是每個 request/response 型別組合）都只允許註冊恰好一個 handler。為同一組合&#10;註冊第二個 handler，會在註冊時就丟出 &lt;code&gt;InvalidOperationException&lt;/code&gt;。分派一個沒有註冊&#10;handler 的 request，同樣會丟出 &lt;code&gt;InvalidOperationException&lt;/code&gt;。詳細訊息見&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/exceptions-and-diagnostics/"&gt;例外與診斷&lt;/a&gt;。對 stream 來說，這件事發生在&#10;開始列舉（enumerate）時，而不是呼叫 &lt;code&gt;SendStream&lt;/code&gt; 時，因為處理本身就是從列舉開始才啟動&#10;（見下方說明）。&lt;/p&gt;</description></item><item><title>快速上手</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/getting-started/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/getting-started/</guid><description>&lt;h2 id="安裝"&gt;安裝&lt;a class="anchor" href="#%e5%ae%89%e8%a3%9d"&gt;&lt;/a&gt;&lt;/h2&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-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;dotnet add package Davish.Sendr&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果某個 domain/application 組件只需要參照訊息合約（&lt;code&gt;IRequest&lt;/code&gt;、&lt;code&gt;IRequestHandler&lt;/code&gt;、&#10;&lt;code&gt;ISender&lt;/code&gt; 等），而不想連帶依賴 DI 實作，可以改參照合約套件：&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-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;dotnet add package Davish.Sendr.Abstractions&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;Davish.Sendr&lt;/code&gt; 本身已經依賴 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;，所以應用程式的進入點專案只需要&#10;安裝前者即可。&lt;/p&gt;&#10;&lt;h2 id="註冊-addsendr-與-handler"&gt;註冊 &lt;code&gt;AddSendr&lt;/code&gt; 與 handler&lt;a class="anchor" href="#%e8%a8%bb%e5%86%8a-addsendr-%e8%88%87-handler"&gt;&lt;/a&gt;&lt;/h2&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;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;CreateOrder, CreateOrderHandler&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&amp;gt;();&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;AddRequestHandler&amp;lt;TRequest, THandler&amp;gt;&lt;/code&gt; 用於沒有回傳值的 request（&lt;code&gt;IRequest&lt;/code&gt;）；&#10;&lt;code&gt;AddRequestHandler&amp;lt;TRequest, TResponse, THandler&amp;gt;&lt;/code&gt; 用於會回傳值的 request&#10;（&lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;）。每個 request/response 組合最多只能註冊一個 handler。註冊了&#10;第二個、或完全沒有註冊，會發生什麼事，見&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/dispatch-model/"&gt;分派模型&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="定義訊息與-handler"&gt;定義訊息與 handler&lt;a class="anchor" href="#%e5%ae%9a%e7%be%a9%e8%a8%8a%e6%81%af%e8%88%87-handler"&gt;&lt;/a&gt;&lt;/h2&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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrder&lt;/span&gt;(Guid Id) : IRequest;&#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;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;CreateOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;CreateOrder&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;public&lt;/span&gt; Task HandleAsync(CreateOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.CompletedTask;&#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;}&#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;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;GetOrder&lt;/span&gt;(Guid Id) : IRequest&amp;lt;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:#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;OrderDto&lt;/span&gt;(Guid Id, &lt;span style="color:#66d9ef"&gt;string&lt;/span&gt; Number);&#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;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;GetOrderHandler&lt;/span&gt; : IRequestHandler&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:#66d9ef"&gt;public&lt;/span&gt; Task&amp;lt;OrderDto&amp;gt; HandleAsync(GetOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.FromResult(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; OrderDto(request.Id, &lt;span style="color:#e6db74"&gt;&amp;#34;SO-001&amp;#34;&lt;/span&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&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="發送"&gt;發送&lt;a class="anchor" href="#%e7%99%bc%e9%80%81"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;解析出 &lt;code&gt;ISender&lt;/code&gt; 並呼叫 &lt;code&gt;SendAsync&lt;/code&gt;：&lt;/p&gt;</description></item><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>註冊 handler</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/registering-handlers/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/registering-handlers/</guid><description>&lt;p&gt;這篇涵蓋 request、command、query 的手動註冊。Stream 的部分見下方「Stream」小節。若要&#10;改用 source-generated 的方式，見&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/enabling-source-generation/"&gt;啟用 source generation&lt;/a&gt;。&#10;這幾種訊息之間的關係，背景說明見&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/dispatch-model/"&gt;分派模型&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="request"&gt;Request&lt;a class="anchor" href="#request"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;沒有回傳值的 command，用 &lt;code&gt;IRequest&lt;/code&gt;：&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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;CreateOrder&lt;/span&gt;(Guid Id) : IRequest;&#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;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;CreateOrderHandler&lt;/span&gt; : IRequestHandler&amp;lt;CreateOrder&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;public&lt;/span&gt; Task HandleAsync(CreateOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.CompletedTask;&#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&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Request/response 用 &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;：&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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;GetOrder&lt;/span&gt;(Guid Id) : IRequest&amp;lt;OrderDto&amp;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;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderDto&lt;/span&gt;(Guid Id, &lt;span style="color:#66d9ef"&gt;string&lt;/span&gt; Number);&#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;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;GetOrderHandler&lt;/span&gt; : IRequestHandler&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:#66d9ef"&gt;public&lt;/span&gt; Task&amp;lt;OrderDto&amp;gt; HandleAsync(GetOrder request, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.FromResult(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; OrderDto(request.Id, &lt;span style="color:#e6db74"&gt;&amp;#34;SO-001&amp;#34;&lt;/span&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&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;兩個都註冊好後，透過 &lt;code&gt;ISender&lt;/code&gt; 分派：&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;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;CreateOrder, CreateOrderHandler&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&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;var&lt;/span&gt; sender = serviceProvider.GetRequiredService&amp;lt;ISender&amp;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; CreateOrder(Guid.NewGuid()), cancellationToken);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; order = &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; sender.SendAsync(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; GetOrder(Guid.NewGuid()), cancellationToken);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="command-與-querycqrs"&gt;Command 與 query（CQRS）&lt;a class="anchor" href="#command-%e8%88%87-querycqrs"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;ICommand&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; 是跟 &lt;code&gt;IRequest&lt;/code&gt; 獨立的合約，有&#10;自己的 handler 介面（&lt;code&gt;ICommandHandler&lt;/code&gt;、&lt;code&gt;IQueryHandler&lt;/code&gt;）與註冊方法&#10;（&lt;code&gt;AddCommandHandler&lt;/code&gt;、&lt;code&gt;AddQueryHandler&lt;/code&gt;）。當你想在程式碼裡使用明確的 CQRS 語彙，而不&#10;是泛用的 &lt;code&gt;IRequest&lt;/code&gt; 時，可以用這一組。&lt;/p&gt;</description></item><item><title>Decorator pipeline</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/decorator-pipeline/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/decorator-pipeline/</guid><description>&lt;p&gt;Decorator 是一個非泛型的 pipeline 行為，用來包裝 handler 的執行，像是記錄&#10;（logging）、交易（transaction）、驗證等橫切關注點。「非泛型」的意思是：一個&#10;decorator 類別可以包裝任意數量、彼此無關的 request/command/query/stream/notification&#10;型別，這點跟 handler 不同：handler 是針對某一個特定訊息型別寫的。&lt;/p&gt;&#10;&lt;h2 id="每種訊息各自一個介面外加一個有回應值的變體"&gt;每種訊息各自一個介面，外加一個有回應值的變體&lt;a class="anchor" href="#%e6%af%8f%e7%a8%ae%e8%a8%8a%e6%81%af%e5%90%84%e8%87%aa%e4%b8%80%e5%80%8b%e4%bb%8b%e9%9d%a2%e5%a4%96%e5%8a%a0%e4%b8%80%e5%80%8b%e6%9c%89%e5%9b%9e%e6%87%89%e5%80%bc%e7%9a%84%e8%ae%8a%e9%ab%94"&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;訊息種類&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Decorator 介面&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;IRequest&lt;/code&gt;（無回應值）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequestDecorator&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;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IRequestDecorator.WithResponse&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;ICommand&lt;/code&gt;（無回應值）&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommandDecorator&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;ICommand&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;ICommandDecorator.WithResponse&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;IQuery&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IQueryDecorator&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;IStreamRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;IStreamRequestDecorator&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;INotification&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;INotificationDecorator&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;一個類別可以同時實作某一種訊息的無回應值版本與 &lt;code&gt;WithResponse&lt;/code&gt; 版本（README 裡的&#10;&lt;code&gt;LoggingDecorator&lt;/code&gt; 範例就同時實作了 &lt;code&gt;IRequestDecorator&lt;/code&gt; 與&#10;&lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt;），讓一個 decorator 就能包裝這種訊息的所有形式。&lt;/p&gt;&#10;&lt;p&gt;以 &lt;code&gt;IRequestDecorator&lt;/code&gt; 為例，介面本身不是泛型，但 &lt;code&gt;HandleAsync&lt;/code&gt; 方法是泛型的，這就是&#10;一個 decorator 能包裝任意 request 型別的原因：&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;interface&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;IRequestDecorator&lt;/span&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; Task HandleAsync&amp;lt;TRequest&amp;gt;(TRequest request, RequestHandlerDelegate next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken) &lt;span style="color:#66d9ef"&gt;where&lt;/span&gt; TRequest : IRequest;&#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;h2 id="順序依宣告順序由外到內"&gt;順序：依宣告順序，由外到內&lt;a class="anchor" href="#%e9%a0%86%e5%ba%8f%e4%be%9d%e5%ae%a3%e5%91%8a%e9%a0%86%e5%ba%8f%e7%94%b1%e5%a4%96%e5%88%b0%e5%85%a7"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;無論是透過 &lt;code&gt;x.Decorator.With&amp;lt;T&amp;gt;()&lt;/code&gt;（手動註冊），還是 &lt;code&gt;[DecorateWith&amp;lt;T1, T2, ...&amp;gt;]&lt;/code&gt;&#10;（產生出來的註冊），把 decorator 附加到 handler 上時，第一個列出的就是最外層，會最先&#10;執行、最後結束。之後每一個都巢狀包在前一個裡面。&lt;/p&gt;</description></item><item><title>使用 decorator</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/using-decorators/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/using-decorators/</guid><description>&lt;p&gt;Pipeline 模型與順序規則的背景說明，見&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/decorator-pipeline/"&gt;Decorator pipeline&lt;/a&gt;。這篇示範手動與產生出來的兩種&#10;附加方式。&lt;/p&gt;&#10;&lt;h2 id="手動xdecoratorwitht"&gt;手動：&lt;code&gt;x.Decorator.With&amp;lt;T&amp;gt;()&lt;/code&gt;&lt;a class="anchor" href="#%e6%89%8b%e5%8b%95xdecoratorwitht"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;在註冊呼叫傳入 &lt;code&gt;configure&lt;/code&gt; delegate，並依「外到內」的順序串接 &lt;code&gt;With&amp;lt;T&amp;gt;()&lt;/code&gt;：&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;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendr()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddRequestHandler&amp;lt;GetOrder, OrderDto, GetOrderHandler&amp;gt;(x =&amp;gt; x.Decorator&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;TransactionDecorator&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .With&amp;lt;LoggingDecorator&amp;gt;());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;這裡 &lt;code&gt;TransactionDecorator&lt;/code&gt; 是最外層（最先執行、最後結束）；&lt;code&gt;LoggingDecorator&lt;/code&gt; 巢狀&#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-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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;class&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;LoggingDecorator&lt;/span&gt;(ILogger&amp;lt;LoggingDecorator&amp;gt; logger)&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; : IRequestDecorator, IRequestDecorator.WithResponse&#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;public&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;async&lt;/span&gt; Task HandleAsync&amp;lt;TRequest&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&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;where&lt;/span&gt; TRequest : IRequest&#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; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#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; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#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;&#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;async&lt;/span&gt; Task&amp;lt;TResponse&amp;gt; HandleAsync&amp;lt;TRequest, TResponse&amp;gt;(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; TRequest request,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; RequestHandlerDelegate&amp;lt;TResponse&amp;gt; next,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&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;where&lt;/span&gt; TRequest : IRequest&amp;lt;TResponse&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; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handling {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;var&lt;/span&gt; response = &lt;span style="color:#66d9ef"&gt;await&lt;/span&gt; next();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; logger.LogInformation(&lt;span style="color:#e6db74"&gt;&amp;#34;Handled {Request}&amp;#34;&lt;/span&gt;, &lt;span style="color:#66d9ef"&gt;typeof&lt;/span&gt;(TRequest).Name);&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#66d9ef"&gt;return&lt;/span&gt; response;&#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&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;同時實作 &lt;code&gt;IRequestDecorator&lt;/code&gt; 與 &lt;code&gt;IRequestDecorator.WithResponse&lt;/code&gt;，讓一個類別可以同時&#10;包裝 &lt;code&gt;IRequest&lt;/code&gt; 與 &lt;code&gt;IRequest&amp;lt;TResponse&amp;gt;&lt;/code&gt; 的 handler。同樣的模式也適用於&#10;&lt;code&gt;ICommandDecorator&lt;/code&gt;/&lt;code&gt;ICommandDecorator.WithResponse&lt;/code&gt;、&lt;code&gt;IQueryDecorator&lt;/code&gt;、&#10;&lt;code&gt;IStreamRequestDecorator&lt;/code&gt;，以及 &lt;code&gt;INotificationDecorator&lt;/code&gt;（notification 特有的設定方式&#10;見&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/publishing-notifications/"&gt;發佈 notification&lt;/a&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>Notification 模型</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/notification-model/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/notification-model/</guid><description>&lt;h2 id="零個或多個-handler分成兩個群組"&gt;零個或多個 handler，分成兩個群組&lt;a class="anchor" href="#%e9%9b%b6%e5%80%8b%e6%88%96%e5%a4%9a%e5%80%8b-handler%e5%88%86%e6%88%90%e5%85%a9%e5%80%8b%e7%be%a4%e7%b5%84"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;跟 request/command/query（恰好一個 handler）不同，&lt;code&gt;INotification&lt;/code&gt; 可以有任意數量的&#10;handler，包括零個。若 &lt;code&gt;IPublisher.PublishAsync&lt;/code&gt; 發佈的 notification 型別沒有任何已註冊&#10;的 handler，這就是一個 no-op（什麼都不會發生）。&lt;/p&gt;&#10;&lt;p&gt;某個 notification 型別的 handler 會被組織成兩個命名群組：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Sequence（序列）&lt;/strong&gt; — 依註冊順序，一次執行一個 handler。某個 handler 丟出例外，&#10;不會阻止 Sequence 群組裡剩下的 handler 繼續執行。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Parallel（平行）&lt;/strong&gt; — 群組內所有 handler 同時啟動。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;Sequence 群組與 Parallel 群組彼此是&lt;strong&gt;同時&lt;/strong&gt;執行的。Parallel 的 handler 不會等&#10;Sequence 群組跑完才開始，反過來也一樣：&lt;/p&gt;&#10;&lt;pre class="mermaid"&gt;sequenceDiagram&#10; participant Caller&#10; participant Sequence as Sequence 群組&#10; participant Parallel as Parallel 群組&#10; par Sequence（依序執行）&#10; Caller-&amp;gt;&amp;gt;Sequence: Handler 1&#10; Sequence-&amp;gt;&amp;gt;Sequence: Handler 2&#10; and Parallel（同時啟動）&#10; Caller-&amp;gt;&amp;gt;Parallel: Handler 3&#10; Caller-&amp;gt;&amp;gt;Parallel: Handler 4&#10; end&#10; Sequence--&amp;gt;&amp;gt;Caller: 完成&#10; Parallel--&amp;gt;&amp;gt;Caller: 完成&lt;/pre&gt;&lt;p&gt;&lt;code&gt;AddNotificationHandler&amp;lt;TNotification&amp;gt;&lt;/code&gt; 對同一個 notification 型別只能呼叫一次，該&#10;型別所有的 handler 都要在那一次呼叫裡一起宣告，這樣 Sequence 的順序才會一眼可見。&#10;第二次呼叫會丟出例外。跟這個函式庫其他地方的 handler 註冊一樣，設定會被立即擷取下來；&#10;之後修改傳給 &lt;code&gt;configure&lt;/code&gt; 的物件不會有任何效果。&lt;/p&gt;</description></item><item><title>發佈 notification</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/publishing-notifications/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/publishing-notifications/</guid><description>&lt;p&gt;Sequence/Parallel 語意與例外聚合規則的背景說明，見&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/notification-model/"&gt;Notification 模型&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="定義-notification-與它的-handler"&gt;定義 notification 與它的 handler&lt;a class="anchor" href="#%e5%ae%9a%e7%be%a9-notification-%e8%88%87%e5%ae%83%e7%9a%84-handler"&gt;&lt;/a&gt;&lt;/h2&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;sealed&lt;/span&gt; &lt;span style="color:#66d9ef"&gt;record&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;OrderPlaced&lt;/span&gt;(Guid OrderId) : INotification;&#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;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;ReserveInventoryHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&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;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.CompletedTask;&#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;}&#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;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;SendConfirmationEmailHandler&lt;/span&gt; : INotificationHandler&amp;lt;OrderPlaced&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;public&lt;/span&gt; Task HandleAsync(OrderPlaced notification, CancellationToken cancellationToken = &lt;span style="color:#66d9ef"&gt;default&lt;/span&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;return&lt;/span&gt; Task.CompletedTask;&#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&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="註冊手動"&gt;註冊：手動&lt;a class="anchor" href="#%e8%a8%bb%e5%86%8a%e6%89%8b%e5%8b%95"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;呼叫一次 &lt;code&gt;AddSendrNotification()&lt;/code&gt;，然後在&lt;strong&gt;同一次&lt;/strong&gt; &lt;code&gt;AddNotificationHandler&lt;/code&gt; 呼叫裡，&#10;把某個 notification 型別的所有 handler 全部註冊好，並分配到 Sequence 和/或 Parallel&#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-csharp" data-lang="csharp"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSendrNotification()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddNotificationHandler&amp;lt;OrderPlaced&amp;gt;(x =&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; x.Handler.Sequence.With&amp;lt;ReserveInventoryHandler&amp;gt;();&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; x.Handler.Parallel.With&amp;lt;SendConfirmationEmailHandler&amp;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;h2 id="發佈"&gt;發佈&lt;a class="anchor" href="#%e7%99%bc%e4%bd%88"&gt;&lt;/a&gt;&lt;/h2&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;var&lt;/span&gt; publisher = serviceProvider.GetRequiredService&amp;lt;IPublisher&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; publisher.PublishAsync(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; OrderPlaced(order.Id), cancellationToken);&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;PublishAsync&lt;/code&gt; 接受非泛型的 &lt;code&gt;INotification&lt;/code&gt;，所以像是從 outbox 讀回來的一批不同型別的&#10;事件，可以在呼叫端不知道每一個具體 notification 型別的情況下發佈。沒有任何已註冊&#10;handler 的 notification，發佈就是個 no-op。&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>啟用 source generation</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/enabling-source-generation/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/enabling-source-generation/</guid><description>&lt;p&gt;Source generator 做了什麼、為什麼要用它，背景說明見&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/compile-time-discovery/"&gt;編譯期發現&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="安裝"&gt;安裝&lt;a class="anchor" href="#%e5%ae%89%e8%a3%9d"&gt;&lt;/a&gt;&lt;/h2&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-xml" data-lang="xml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;3.5.0&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&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:#f92672"&gt;&amp;lt;PackageReference&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Include=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;Davish.Sendr.Generators&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;Version=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;2.1.0&amp;#34;&lt;/span&gt; &lt;span style="color:#a6e22e"&gt;PrivateAssets=&lt;/span&gt;&lt;span style="color:#e6db74"&gt;&amp;#34;all&amp;#34;&lt;/span&gt; &lt;span style="color:#f92672"&gt;/&amp;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;PrivateAssets=&amp;quot;all&amp;quot;&lt;/code&gt; 讓這個 generator 本身（一個 analyzer 類型的套件）不會流到下游、&#10;參照這個專案的其他專案。&lt;/p&gt;&#10;&lt;h2 id="開啟它"&gt;開啟它&lt;a class="anchor" href="#%e9%96%8b%e5%95%9f%e5%ae%83"&gt;&lt;/a&gt;&lt;/h2&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;builder.Services.AddSendr(o =&amp;gt; o.UseGenerators());&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;builder.Services.AddSendrNotification(o =&amp;gt; o.UseGenerators());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;單純呼叫 &lt;code&gt;AddSendr()&lt;/code&gt;/&lt;code&gt;AddSendrNotification()&lt;/code&gt;（不帶 &lt;code&gt;UseGenerators()&lt;/code&gt;）會維持預設的&#10;反射式 sender/publisher。一旦用了 &lt;code&gt;UseGenerators()&lt;/code&gt;，同一個 sender/publisher 的手動&#10;&lt;code&gt;AddXHandler&lt;/code&gt;/&lt;code&gt;AddNotificationHandler&lt;/code&gt; 呼叫就不會擴充它的分派表。每個 sender、每個&#10;publisher 都只能選一種註冊方式。&lt;/p&gt;&#10;&lt;h2 id="發現另一個專案裡的-handler"&gt;發現另一個專案裡的 handler&lt;a class="anchor" href="#%e7%99%bc%e7%8f%be%e5%8f%a6%e4%b8%80%e5%80%8b%e5%b0%88%e6%a1%88%e8%a3%a1%e7%9a%84-handler"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;預設只會發現呼叫 &lt;code&gt;UseGenerators()&lt;/code&gt; 那個專案自己的 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:#75715e"&gt;// assembly 裡任何一個型別都可以當這個 marker，它不需要實作任何特定介面。&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;ApplicationAssemblyMarker&lt;/span&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;builder.Services.AddSendr(o =&amp;gt; o.UseGenerators(g =&amp;gt; g.IncludeAssemblyOf&amp;lt;ApplicationAssemblyMarker&amp;gt;()));&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;要納入不只一個 assembly，就串接起來：&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;o.UseGenerators(g =&amp;gt; g&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .IncludeAssemblyOf&amp;lt;ApplicationAssemblyMarker&amp;gt;()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .IncludeAssemblyOf&amp;lt;InfrastructureAssemblyMarker&amp;gt;());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;這對應到 repo 自己 sample 裡一個實際可運作的範例：&lt;code&gt;samples/ConsoleApp&lt;/code&gt; 參照了&#10;&lt;code&gt;samples/ConsoleLib&lt;/code&gt;，並在 &lt;code&gt;AddSendr&lt;/code&gt; 與 &lt;code&gt;AddSendrNotification&lt;/code&gt; 兩邊都透過&#10;&lt;code&gt;IncludeAssemblyOf&amp;lt;IAssemblyMarker&amp;gt;()&lt;/code&gt; 把它納入，而 &lt;code&gt;ConsoleLib&lt;/code&gt; 本身完全沒有呼叫&#10;&lt;code&gt;UseGenerators()&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>編譯期發現</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/compile-time-discovery/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/compile-time-discovery/</guid><description>&lt;p&gt;&lt;code&gt;Davish.Sendr.Generators&lt;/code&gt; 是一個 Roslyn incremental source generator。它會在編譯期發現&#10;handler 的實作，並產生出 reflection-free 的 &lt;code&gt;ISender&lt;/code&gt;/&lt;code&gt;IStreamSender&lt;/code&gt;（以及另外，給&#10;notification 用的 reflection-free &lt;code&gt;IPublisher&lt;/code&gt;），同時避開執行期 assembly 掃描與&#10;反射式呼叫這兩件事。手動註冊（見&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/concepts/dispatch-model/"&gt;分派模型&lt;/a&gt;）雖然也不會掃描&#10;assembly，但在分派時仍是以反射方式解析並呼叫 handler；source generator 進一步把這個&#10;反射也拿掉了。&lt;/p&gt;&#10;&lt;h2 id="如何啟用"&gt;如何啟用&lt;a class="anchor" href="#%e5%a6%82%e4%bd%95%e5%95%9f%e7%94%a8"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;&lt;code&gt;AddSendr(o =&amp;gt; o.UseGenerators())&lt;/code&gt; 會安裝產生出來的 sender；單純呼叫 &lt;code&gt;AddSendr()&lt;/code&gt; 則&#10;維持預設的反射式 sender。這兩者互斥，一旦 &lt;code&gt;UseGenerators()&lt;/code&gt; 生效，手動呼叫的&#10;&lt;code&gt;AddRequestHandler&lt;/code&gt;/&lt;code&gt;AddCommandHandler&lt;/code&gt;/&lt;code&gt;AddQueryHandler&lt;/code&gt;/&lt;code&gt;AddStreamRequestHandler&lt;/code&gt; 就不會&#10;擴充產生出來的分派表。Notification 這邊也是同樣的關係，獨立運作：透過&#10;&lt;code&gt;AddSendrNotification(o =&amp;gt; o.UseGenerators())&lt;/code&gt;。&lt;/p&gt;&#10;&lt;p&gt;分派表是以訊息型別、以及（若適用）回應型別為 key 產生的字典。&lt;/p&gt;&#10;&lt;h2 id="發現的範圍"&gt;發現的範圍&lt;a class="anchor" href="#%e7%99%bc%e7%8f%be%e7%9a%84%e7%af%84%e5%9c%8d"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;預設情況下，source generator 只會發現呼叫 &lt;code&gt;UseGenerators()&lt;/code&gt; 那個專案自己宣告的&#10;handler。如果 handler 位於某個被參照的專案或 NuGet 套件裡，需要明確宣告：&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;o.UseGenerators(g =&amp;gt; g.IncludeAssemblyOf&amp;lt;ApplicationAssemblyMarker&amp;gt;());&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;ApplicationAssemblyMarker&lt;/code&gt; 可以是那個 assembly 裡任何一個型別，它不需要實作任何特定&#10;介面，只是用來識別要納入的 assembly。&lt;code&gt;IncludeAssemblyOf&amp;lt;TMarker&amp;gt;()&lt;/code&gt; 可以串接，納入不只&#10;一個 assembly。這裡的「發現」只包含以這種方式指名的 assembly，不包含它們的間接依賴。&#10;目前這個專案永遠會自動被包含，所以再指名自己的 assembly 一次並不會出錯。&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><item><title>從已棄用套件遷移</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/migrating-from-deprecated-packages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/migrating-from-deprecated-packages/</guid><description>&lt;p&gt;有三個套件是已棄用的相容性用殼（shim）。每一個都沒有自己的內容：它們存在的唯一目的，&#10;是讓已經參照它們的專案，透過依賴被合併進去的那個套件繼續正常運作，而且都預計在未來的&#10;主要版本中移除。&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;Davish.Sendr.Message&lt;/code&gt;&lt;/td&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;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt; 3.1.0+&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;&lt;code&gt;Davish.Sendr&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&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;&lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;&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;&lt;code&gt;Davish.Sendr.Message&lt;/code&gt; 原本帶著 &lt;code&gt;ICommand&lt;/code&gt;/&lt;code&gt;ICommandHandler&lt;/code&gt;/&lt;code&gt;IQuery&lt;/code&gt;/&#10;&lt;code&gt;IQueryHandler&lt;/code&gt;。&lt;code&gt;Davish.Sendr.Notification&lt;/code&gt; 與 &lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt;&#10;原本帶著 &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;&#10;（以及 &lt;code&gt;AddSendrNotification&lt;/code&gt;/&lt;code&gt;AddNotificationHandler&lt;/code&gt; 這組註冊介面）。這些型別在搬移&#10;前後都位於 &lt;code&gt;Davish.Sendr&lt;/code&gt; 這個命名空間下，所以遷移只是換套件參照，不需要改&#10;&lt;code&gt;using&lt;/code&gt;/命名空間：&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-diff" data-lang="diff"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;- &amp;lt;PackageReference Include=&amp;#34;Davish.Sendr.Message&amp;#34; Version=&amp;#34;2.0.0&amp;#34; /&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;- &amp;lt;PackageReference Include=&amp;#34;Davish.Sendr.Notification&amp;#34; Version=&amp;#34;3.0.0&amp;#34; /&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#a6e22e"&gt;+ &amp;lt;PackageReference Include=&amp;#34;Davish.Sendr&amp;#34; Version=&amp;#34;3.5.0&amp;#34; /&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&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-diff" data-lang="diff"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#f92672"&gt;- &amp;lt;PackageReference Include=&amp;#34;Davish.Sendr.Notification.Abstractions&amp;#34; Version=&amp;#34;4.0.0&amp;#34; /&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#a6e22e"&gt;+ &amp;lt;PackageReference Include=&amp;#34;Davish.Sendr.Abstractions&amp;#34; Version=&amp;#34;4.0.0&amp;#34; /&amp;gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果某個專案只需要合約（不需要 DI 實作），請直接參照 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;，&#10;而不是 &lt;code&gt;Davish.Sendr.Notification.Abstractions&lt;/code&gt; 或 &lt;code&gt;Davish.Sendr.Message&lt;/code&gt;。如果也需要&#10;DI 實作，請直接參照 &lt;code&gt;Davish.Sendr&lt;/code&gt;，而不是 &lt;code&gt;Davish.Sendr.Notification&lt;/code&gt;。&#10;&lt;code&gt;Davish.Sendr&lt;/code&gt; 本身已經依賴 &lt;code&gt;Davish.Sendr.Abstractions&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>Tracing</title><link>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/tracing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://davidchen617.github.io/Davish.Sendr/zh-tw/guides/tracing/</guid><description>&lt;p&gt;Sendr 會為它分派的每一個 request、command、query 與 notification 送出&#10;&lt;a href="https://learn.microsoft.com/dotnet/api/system.diagnostics.activity"&gt;&lt;code&gt;Activity&lt;/code&gt;&lt;/a&gt; span。&#10;這些 span 都來自同一個名為 &lt;code&gt;Davish.Sendr&lt;/code&gt; 的 &lt;code&gt;ActivitySource&lt;/code&gt;，所以任何能依名稱訂閱&#10;&lt;code&gt;ActivitySource&lt;/code&gt; 的 listener（OpenTelemetry 的 tracer provider，或你自己寫的&#10;&lt;code&gt;ActivityListener&lt;/code&gt;）都能收集到它們。&lt;/p&gt;&#10;&lt;p&gt;在有 listener 訂閱之前，不會送出任何東西。&lt;code&gt;AddSendr()&lt;/code&gt;、&lt;code&gt;AddSendrNotification()&lt;/code&gt; 與&#10;&lt;code&gt;UseGenerators()&lt;/code&gt; 都沒有需要另外打開的開關。&lt;/p&gt;&#10;&lt;p&gt;span 的確切名稱與 tag 列在&#10;&lt;a href="https://davidchen617.github.io/Davish.Sendr/zh-tw/reference/tracing-spans-and-tags/"&gt;Tracing 的 span 與 tag&lt;/a&gt;。&lt;/p&gt;&#10;&lt;h2 id="用-opentelemetry-訂閱"&gt;用 OpenTelemetry 訂閱&lt;a class="anchor" href="#%e7%94%a8-opentelemetry-%e8%a8%82%e9%96%b1"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;把 source 名稱加進你的 tracer provider。這個範例使用 console exporter&#10;（&lt;code&gt;OpenTelemetry.Exporter.Console&lt;/code&gt;）：&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;using&lt;/span&gt; OpenTelemetry;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#66d9ef"&gt;using&lt;/span&gt; OpenTelemetry.Trace;&#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;using&lt;/span&gt; var tracer = Sdk.CreateTracerProviderBuilder()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddSource(SendrActivitySource.Name) &lt;span style="color:#75715e"&gt;// &amp;#34;Davish.Sendr&amp;#34;&lt;/span&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .AddConsoleExporter()&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; .Build();&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;SendrActivitySource.Name&lt;/code&gt; 是公開常數，所以不需要自己重複寫這個字串。&lt;/p&gt;&#10;&lt;h2 id="不用-opentelemetry-訂閱"&gt;不用 OpenTelemetry 訂閱&lt;a class="anchor" href="#%e4%b8%8d%e7%94%a8-opentelemetry-%e8%a8%82%e9%96%b1"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;單純的 &lt;code&gt;ActivityListener&lt;/code&gt; 也一樣能運作：&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;using&lt;/span&gt; System.Diagnostics;&#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;ActivitySource.AddActivityListener(&lt;span style="color:#66d9ef"&gt;new&lt;/span&gt; ActivityListener&#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; ShouldListenTo = source =&amp;gt; source.Name == SendrActivitySource.Name,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; Sample = (&lt;span style="color:#66d9ef"&gt;ref&lt;/span&gt; ActivityCreationOptions&amp;lt;ActivityContext&amp;gt; _) =&amp;gt; ActivitySamplingResult.AllData,&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; ActivityStopped = activity =&amp;gt; Console.WriteLine(&#10;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e6db74"&gt;$&amp;#34;{activity.DisplayName} {activity.Duration.TotalMilliseconds:F2} ms&amp;#34;&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;h2 id="你會看到什麼"&gt;你會看到什麼&lt;a class="anchor" href="#%e4%bd%a0%e6%9c%83%e7%9c%8b%e5%88%b0%e4%bb%80%e9%ba%bc"&gt;&lt;/a&gt;&lt;/h2&gt;&#10;&lt;p&gt;span 會巢狀在你呼叫 &lt;code&gt;SendAsync&lt;/code&gt; 或 &lt;code&gt;PublishAsync&lt;/code&gt; 當下的 &lt;code&gt;Activity&lt;/code&gt; 之下，例如一個&#10;ASP.NET Core 請求。一個會發佈 notification 的 query handler，會產生這樣的樹：&lt;/p&gt;</description></item></channel></rss>