.Net Core 3.1瀏覽器后端服務（二） Web API專案分層

一、前言

分層開發的思想在計算機領域中至關重要，從作業系統到軟體設計，分層思想無處不在，

在搭建專案的分層結構前，先簡單了解下分層的優缺點，如下圖，分為（呈現層、業務層、服務層、資料層）

分層的優點：

1、層次分明，各司其職：每層都有各自的責任，各層級相互獨立，上層不需要知道下層的內部實作，上層的改動不會影響下一層，

2、易于開發，便于除錯：分層結構使得開發人員可以專注于謀一層進行開發，進行除錯時，可以針對每一層進行單獨除錯，

3、促進標準，移植復用：可替換任意一層，如當前資料層讀資料庫，可替換為讀檔案資料，取網路資料，亦可移植到其他專案，

4、，，，，，，

分層的缺點：

1、降低性能：一個簡單的資料呈現，需逐層回傳且中間的資料轉換等都耗費時間，

2、級聯修改：在呈現層中增加一個功能，為保證其設計符合分層式結構，可能需要在相應的業務邏輯層和資料訪問層中都增加相應的代碼， 

3、，，，，，，

二、WebAPI專案分層

簡單了解了分層優缺點后，創建專案的分層結構

此處注意，這里為了規范專案名稱，重新建了個Web API專案命名為MWebAPI(上篇文章專案名稱為mweb-api)

各專案職責如下：

Action：用來分發來自客戶端（PC、移動設備、瀏覽器）的請求；

Services：進行具體的業務處理；

IServices：Services的抽象；

Repository：先假想為資料訪問層（實際上和資料訪問層區別較大）；

IRepository：Repository的抽象；

Entity：資料物體映射，通常從資料庫映射而來；

Dto：資料傳輸物件，一般和前端頁面相對應；

Utility：通用工具層，提供公用幫助類；

明確了各層的職責，下面創建一個簡單的業務來貫穿各層，以獲取用戶資訊為例

三、獲取用戶資訊流程

四、用戶資訊各層實作

1、創建UserInfo物體類

在MEntity專案中新建 UserInfo物體類

public class UserInfo
{
    public string UserName { get; set; }
    public int Age { get; set; }
    public string Address { get; set; }
}

2、創建UserInfoDto傳輸物件

在MDto專案中新建 UserInfoDto

public class UserInfoDto
{
    public string UserName { get; set; }
    public int Age { get; set; }
    public string Address { get; set; }
}

問題：Dto有什么意義？

初略理解：在專案的初期，資料表字段與Controller回傳的欄位往往是一致的，如同上面的獲取用戶資訊業務，此情形下，Dto無意義，

但當資料表中還有Password，TelPhone等資訊但前端并不需要時，此時Dto只回傳所需，避免傳輸整張表，一定程度上提高了專案的安全性，

3、創建倉儲介面與倉儲實作類

在MIRepository專案中新建IUserInfoRepository

public interface IUserInfoRepository
{
    UserInfo GetUserInfo();
}

在MRepository專案中新建UserInfoRepository，目前專案并未連接資料庫，故直接回傳個物體類物件

public class UserInfoRepository : IUserInfoRepository
{
    public UserInfo GetUserInfo()
    {
        return new UserInfo()
        {
            UserName = "王二麻子",
            Age = 20,
            Address = "那美克星",
        };
    }
}

4、創建服務介面與服務實作類

在MIServices專案中新建IUserInfoServices

public interface IUserInfoServices
{
    UserInfoDto GetUserInfo();
}

在MIServices專案中新建UserInfoServices

public class UserInfoServices : IUserInfoServices
{
    readonly IUserInfoRepository _rep = new UserInfoRepository();
    public UserInfoDto GetUserInfo()
    {
        var entity = _rep.GetUserInfo();
        UserInfoDto dto = new UserInfoDto { UserName = entity.UserName, Age = entity.Age, Address = entity.Address };
        return dto;
    }
}

5、創建Controller

在MWebAPI專案中新建UserInfoController

[ApiController]
[Route("[controller]/[action]")]
public class UserInfoController : Controller
{
    private readonly IUserInfoServices _services = new UserInfoServices();
    [HttpGet]
    public UserInfoDto GetUserInfo()
    {
        return _services.GetUserInfo();
    }
}

啟動專案，瀏覽器輸入：http://localhost:5000/UserInfo/GetUserInfo，資料回傳成功，

五、服務注入

此時專案中UserInfoController的 _services 是new出來的，UserInfoServices 的_rep也是如此，目前比較流行的是使用依賴注入的方式去注入服務，下面我們改寫Services及Controller，如下：

public class UserInfoServices : IUserInfoServices
{
    private readonly IUserInfoRepository _rep;
    public UserInfoServices(IUserInfoRepository rep)
    {
        _rep = rep;
    }
    public UserInfoDto GetUserInfo()
    {
        var entity = _rep.GetUserInfo();
        UserInfoDto dto = new UserInfoDto { UserName = entity.UserName, Age = entity.Age, Address = entity.Address };
        return dto;
    }
}

public class UserInfoController : Controller
{
    private readonly IUserInfoServices _services;
    public UserInfoController(IUserInfoServices services)
    {
        _services = services;
    }

    [HttpGet]
    public UserInfoDto GetUserInfo()
    {
        return _services.GetUserInfo();
    }
}

啟動專案，瀏覽器輸入：http://localhost:5000/UserInfo/GetUserInfo，

 此時是因為未注入服務，在Startup類ConfigureServices方法中注入服務

public void ConfigureServices(IServiceCollection services)
{
　　services.AddControllers();
　　services.AddScoped<IUserInfoRepository, UserInfoRepository>();
　　services.AddScoped<IUserInfoServices, UserInfoServices>();
}

再次運行

六、結語

本篇文章中涉及了兩個概念倉儲模式與依賴注入，目前并未深入的研究，將在后續的文章中挖掘，

Services和Repository均定義了相應的介面，一個好處是便于服務注入，這樣做還有哪些好處？歡迎各位道友一起討論！！！

標籤：.NET Core

上一篇：Web API實作微信公眾平臺開發-接收資料Post

下一篇：在.NET中體驗GraphQL