【翻译】asp.net core中使用MediatR
這篇文章來自:https://ardalis.com/using-mediatr-in-aspnet-core-apps
本文作為翻譯,有一些單詞翻譯成中文可能會有一些誤解(對于讀者)或者錯誤(對于作者)的地方,所以在文章中你可以看到一些單詞沒有進行翻譯。如果有不對的地方,請指出,謝謝。
在Asp.net core中使用MediatR
我已經開始考慮使用MediatR作為我的領域事件實現。為了達到這個目的,我用asp.net core創建了一個示例程序,總的來說是非常容易的,如果你之前沒有使用過MediatR,或者你正在找一個使用它的示例程序,那么就繼續閱讀吧。
安裝MediatR
假設你使用的是Visual studio,你可以通過nuget的ui來安裝下面這兩個包:
不是用visual studio的話自己找辦法安裝吧。
在Startup類中配置MediatR
下一步,在Startup類中,在ConfigureServices方法中添加如下代碼:
services.AddMediatR();// if you have handlers/events in other assemblies
// services.AddMediatR(typeof(SomeHandler).Assembly, // ? ? ? typeof(SomeOtherHandler).Assembly);
在我的示例項目中因為我只有一個工程/程序集,所以沒有必要添加其他的。如果你有不只一個程序集需要被配置MediatR,那么你可以按照上面代碼中注釋掉的那樣來配置。
注意:起初我用了Steve Gordon’s helpful article to register my types這個指引,但是MediatR.Extensions.Microsoft.DependencyInjection?包得到了更好的支持和更健壯的成長(更別說更少的代碼)。我建議使用這個包。
MediatR 實戰
當然,如果你想要確認MediatR在你的asp.net core項目中運作,最高的辦法是創建一些簡單的類型并驗證是否能達到預期的效果。MediatR支持兩種消息類型:Request/Response和Notification。我使用它的大多數情況是Notification這種模式。因為我希望用它來做模型的領域事件(如果你對于領域事件不熟悉的話,先了解一下它再回來)。要想使用notifications所期望得到的行為,你需要定義一些實現了INotification的類型,和一些實現了INotificationHandler<sometype>的handler。當你要發布一個notification,每一個handler都會在response中。你可以使用下面的代碼來實踐一下并能看到最終的結果,如果你正在搞一個新項目,你可以把它放到Home Controller中。
上面的代碼擼完后,使用kestrel運行你的應用(你可以在項目的根目錄下面進入cmd然后輸入dotnet run來啟動一個控制臺面板,或者在visual studio中改變啟動方式,不過一般情況下我直接進到項目的properties目錄下面找到lauchSettings.json,吧IIS相關的東西都刪除了。)然后查看你的控制臺面板的輸出,你應該能看到輸出的日志:
如果你只是想用MediatR來發布事件,上面的就是了。如果你想要看看怎么用它來做request/response,你需要在實現幾個類:
上面的代碼定義了一個request以及它的返回類型(string,IRequest<string>).handlers必須實現一個Handle方法,這個方法會返回期望的響應。當你發送一個請求,只有一個handler會被調用并且會返回一個帶有合適類型的響應。
(作者在這里說明了一個問題,他給這個包的作者發了一個pull request要求如果有注冊了多個handler,那么應該調用注冊的第一個,因為只有第一個被添加到了DI系統中)。
當前的版本也不會拋出什么異常,但是即便在將來的版本中會拋出異常,也不會讓我感到驚訝什么的。
無論以何種方式,要使用上面定義的內容,你只需要在About 方法中添加如下代碼:
從瀏覽器中瀏覽/About頁面,你能看到調用的結果。目前版本已經更正了結果,你將看到的是注冊的第一個(按照你編碼的從上到下的順序,PingHandler是算第一個注冊的)handler的返回的結果。
上面就是你要開始研究MediatR的一個很好的開端了。我已經迫不及待的想要將他運用在我的eShopContainer(微軟示例項目,講微服務的)項目當中了。查看這里?Microsoft’s architecture learning hub去獲取更多微軟的相關技術的書書籍吧。
相關文章:
MEDIATR 一個低調的中介者類庫
原文地址:https://www.cnblogs.com/pangjianxin/p/9382696.html
.NET社區新聞,深度好文,歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結
以上是生活随笔為你收集整理的【翻译】asp.net core中使用MediatR的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Abp + Grpc 如何实现用户会话状
- 下一篇: ASP.NET Core MVC wit