<?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/guides/</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/guides/index.xml" rel="self" type="application/rss+xml"/><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</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>發佈 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>啟用 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/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>