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