怎么在ASP.NET Core中編寫高效的控制器

這篇文章主要講解了“怎么在ASP.NET Core中編寫高效的控制器”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“怎么在ASP.NET Core中編寫高效的控制器”吧！

通過遵循最佳實(shí)踐，可以編寫更好的控制器。所謂的“瘦”控制器（指代碼更少、職責(zé)更少的控制器）更容易閱讀和維護(hù)。而且，一旦你的控制器很瘦，可能就不需要對它們進(jìn)行太多測試了。相反，你可以專注于測試業(yè)務(wù)邏輯和數(shù)據(jù)訪問代碼。瘦控制器的另一個優(yōu)點(diǎn)是，它更容易維護(hù)控制器的多個版本。

這篇文章討論了使控制器變胖的壞習(xí)慣，然后探索了使控制器變瘦和易于管理的方法。我列出編寫控制器的最佳實(shí)踐可能并不全面，但我已經(jīng)討論了最重要的一些，并在適當(dāng)?shù)那闆r下提供了相關(guān)的源代碼。在接下來的幾節(jié)中，我們將研究什么是胖控制器，為什么它是一種代碼壞味道，瘦控制器是什么，為什么它是有益的，以及如何使控制器瘦、簡單、可測試和可管理。

從控制器中刪除數(shù)據(jù)訪問代碼

在編寫控制器時，你應(yīng)該堅(jiān)持單一責(zé)任原則，這意味著控制器應(yīng)該有“一個責(zé)任”或“有且只有一個原因可以更改”。換句話說，你希望將更改控制器代碼的原因減至最少。下面的代碼顯示了具有數(shù)據(jù)訪問邏輯的典型控制器。

在.NET生態(tài)系統(tǒng)中使用特定的技術(shù)堆棧會產(chǎn)生一些困惑，因?yàn)橛泻芏噙x擇，比如應(yīng)該使用哪種類型的運(yùn)行時?在這篇文章中，我們將試圖把這些要點(diǎn)都說清楚。

public class AuthorController : Controller{    private AuthorContext dataContext = new AuthorContext();    public ActionResult Index(int authorId)    {        var authors = dataContext.Authors            .OrderByDescending(x=>x.JoiningDate)            .Where(x=>x.AuthorId == authorId)            .ToList();        return View(authors);    }}

在action內(nèi)部使用數(shù)據(jù)上下文實(shí)例讀取數(shù)據(jù)，違反了單一職責(zé)原則，并使你的控制器充斥著不應(yīng)該出現(xiàn)在那里的代碼。在本例中，我們使用一個DataContext(假設(shè)我們使用Entity Framework Core)來連接、處理數(shù)據(jù)庫中的數(shù)據(jù)。

明天如果你決定更改數(shù)據(jù)訪問技術(shù)(為了更好的性能或其他原因)，你也必須更改你的控制器。例如，如果我想使用Dapper連接到底層數(shù)據(jù)庫該怎么辦?更好的方法是使用repository類來封裝數(shù)據(jù)訪問邏輯(盡管我不太喜歡repository模式)。讓我們用以下代碼更新AuthorController。

public class AuthorController : Controller{    private AuthorRepository authorRepository = new AuthorRepository();    public ActionResult Index(int authorId)    {        var authors = authorRepository.GetAuthor(authorId);        return View(authors);    }}

控制器現(xiàn)在看起來更瘦了。那么這是編寫這個控制器的最佳方法嗎?不是。如果你的控制器正在訪問數(shù)據(jù)訪問組件，那么它將做太多的事情，因此違反了單一職責(zé)原則?？刂破鞑粦?yīng)該有直接訪問數(shù)據(jù)訪問組件的數(shù)據(jù)訪問邏輯或代碼。下面是AuthorController類的改進(jìn)版本。

public class AuthorController : Controller{    private AuthorService authorService = new AuthorService();    public ActionResult Index(int authorId)    {        var authors = authorService.GetAuthor(authorId);        return View(authors);    }}

AuthorService類利用AuthorRepository類執(zhí)行CRUD操作。

public class AuthorService{    private AuthorRepository authorRepository = new AuthorRepository();    public Author GetAuthor (int authorId)    {        return authorRepository.GetAuthor(authorId);    }}

避免編寫樣板代碼來映射對象

你經(jīng)常需要映射數(shù)據(jù)傳輸對象(DTO)和域?qū)ο?，反之亦然。請參考下面給出的代碼片段，它顯示了控制器方法內(nèi)部的映射邏輯。

public IActionResult GetAuthor(int authorId){    var author = authorService.GetAuthor(authorId);    var authorDTO = new AuthorDTO();    authorDTO.AuthorId = author.AuthorId;    authorDTO.FirstName = author.FirstName;    authorDTO.LastName = author.LastName;    authorDTO.JoiningDate = author.JoiningDate; }

你不應(yīng)該在控制器中編寫這樣的映射邏輯，因?yàn)樗鼤箍刂破髋蛎洸⒃黾宇~外的責(zé)任。如果你要編寫映射邏輯，可以利用像AutoMapper這樣的對象映射器工具來避免編寫大量樣板代碼。

最后，你應(yīng)該將映射邏輯移到前面創(chuàng)建的服務(wù)類中。注意AutoMapper是如何被用來映射兩個不兼容的類型Author和AuthorDTO的。

public class AuthorService{    private AuthorRepository authorRepository = new AuthorRepository();    public AuthorDTO GetAuthor (int authorId)    {        var author = authorRepository.GetAuthor(authorId);        return Mapper.Map<AuthorDTO>(author);    }}

避免在控制器中編寫業(yè)務(wù)邏輯代碼

不應(yīng)該在控制器中編寫業(yè)務(wù)邏輯或驗(yàn)證邏輯。控制器應(yīng)該只接受一個請求，然后跳轉(zhuǎn)下一個action，除此之外沒有其他的。所有的業(yè)務(wù)邏輯代碼都應(yīng)該轉(zhuǎn)移到其他類中(比如我們前面創(chuàng)建的AuthorService類)。有幾種方法可以在請求管道中設(shè)置驗(yàn)證器，而不要在控制器中編寫驗(yàn)證邏輯。這會使你的控制器變得不必要的臃腫，并讓它負(fù)責(zé)它不應(yīng)該做的任務(wù)。

更喜歡依賴注入而不是組合

你應(yīng)該更喜歡在控制器中使用依賴項(xiàng)注入來管理依賴項(xiàng)。依賴注入是控制反轉(zhuǎn)(IoC)原則的一個子集。它用于通過允許從外部注入的依賴項(xiàng)刪除內(nèi)部依賴項(xiàng)。

通過利用依賴注入，你不必關(guān)心對象的實(shí)例化、初始化等。你可以有一個返回所需類型實(shí)例的工廠，然后可以使用構(gòu)造函數(shù)注入來使用該實(shí)例。下面的代碼片段說明了如何使用構(gòu)造函數(shù)將IAuthorService類型的實(shí)例注入到AuthorController。(假設(shè)IAuthorService是AuthorService類擴(kuò)展的接口。)

public class AuthorController : Controller{    private IAuthorService authorService = new AuthorService();    public AuthorController(IAuthorService authorService)    {       this.authorService = authorService;    }}

使用action過濾器來消除重復(fù)的代碼

可以在asp.net core中使用action過濾器在請求管道中的特定點(diǎn)執(zhí)行定制代碼。例如，你可以使用action過濾器在操作action方法執(zhí)行之前和之后執(zhí)行自定義代碼。你可以從控制器的action方法中刪除驗(yàn)證邏輯，并將其寫入action過濾器中，而不是在控制器中編寫驗(yàn)證邏輯。下面的代碼片段顯示了如何實(shí)現(xiàn)這一點(diǎn)。

[ValidateModelState][HttpPost]public ActionResult Create(AuthorRequest request){    AuthorService authorService = new AuthorService();    authorService.Save(request);    return RedirectToAction("Home");}

你將多個職責(zé)分配給了一個控制器，那么也會有多個原因?qū)е驴刂破鞲?。因此，這違反了單一責(zé)任原則，該原則規(guī)定類應(yīng)該有且只有一個變更的理由。

感謝各位的閱讀，以上就是“怎么在ASP.NET Core中編寫高效的控制器”的內(nèi)容了，經(jīng)過本文的學(xué)習(xí)后，相信大家對怎么在ASP.NET Core中編寫高效的控制器這一問題有了更深刻的體會，具體使用情況還需要大家實(shí)踐驗(yàn)證。這里是億速云，小編將為大家推送更多相關(guān)知識點(diǎn)的文章，歡迎關(guān)注！