在 ASP.NET Core 項目中使用 AutoMapper 進行實體映射

来源:https://www.cnblogs.com/danvic712/archive/2019/10/07/11628523.html

一、前言 在實際項目開發過程中,我們使用到的各種 ORM 組件都可以很便捷的將我們獲取到的數據綁定到對應的 List<T> 集合中,因為我們最終想要在頁面上展示的數據與資料庫實體類之間可能存在很大的差異,所以這裡更常見的方法是去創建一些對應於頁面數據展示的 `視圖模型` 類,通過對獲取到的數據進行二 ...


 一、前言

  在實際項目開發過程中,我們使用到的各種 ORM 組件都可以很便捷的將我們獲取到的數據綁定到對應的 List<T> 集合中,因為我們最終想要在頁面上展示的數據與資料庫實體類之間可能存在很大的差異,所以這裡更常見的方法是去創建一些對應於頁面數據展示的 `視圖模型` 類,通過對獲取到的數據進行二次加工,從而滿足實際頁面顯示的需要。

  因此,如何更便捷的去實現 資料庫持久化對象 與 視圖對象 間的實體映射,避免我們在代碼中去一次次的手工實現這一過程,就可以降低開發的工作量,而 AutoMapper 則是可以幫助我們便捷的實現實體轉換這一過程的利器。所以,本章我們就來學習如何在 ASP.NET Core 項目中通過使用 AutoMapper 去完成實體間的映射。

  當然,如果你習慣於從視圖展現到持久化到資料庫都採用資料庫實體,那麼本篇文章對你可能不會有任何的幫助。

  代碼倉儲:https://github.com/Lanesra712/grapefruit-common/tree/master/sample/aspnetcore/aspnetcore-automapper-tutorial

 二、Step by Step

  AutoMapper 是一個 OOM(Object-Object-Mapping) 組件,從名字上就可以看出來,這一系列的組件主要是為了幫助我們實現實體間的相互轉換,從而避免我們每次都採用手工編寫代碼的方式進行轉換。在沒有採用 OOM 組件之前,如果我們需要實現類似於一份數據在不同客戶端顯示不同的欄位,我們只能以手工的、逐個屬性賦值的方式實現數據在各個客戶端數據類型間的數據傳遞,而 OOM 組件則可以很方便的幫我們實現這一需求。

  1、幾個概念

  在上面我們有提到 資料庫持久化對象 和 視圖對象 這兩個概念,其實除了這兩個對象的概念之外,還存在一個 數據傳輸對象 的概念,這裡我們來簡單闡述下這三種對象的概念。

  資料庫持久化對象(Persistent Object):顧名思義,這個對象是用來將我們的數據持久化到資料庫,一般來說,持久化對象中的欄位會與資料庫中對應的 table 保持一致。

  這裡,如果你採用了 DDD 的思想去指導設計系統架構,其實最終落地到我們代碼中的其實是 領域對象(Domain Object),它與 資料庫持久化對象 最顯著的差異在於 領域對象 會包含當前業務領域的各種事件,而 資料庫持久化對象 僅是包含了資料庫中對應 table 的數據欄位信息。

  視圖對象(View Object):視圖對象 VO 是面向前端用戶頁面的,一般會包含呈現給用戶的某個頁面/組件中所包含的所有數據欄位信息。

  數據傳輸對象(Data Transfer Object):數據傳輸對象 DTO 一般用於前端展示層與後臺服務層之間的數據傳遞,以一種媒介的形式完成 資料庫持久化對象 與 視圖對象 之間的數據傳遞。

  這裡通過一個簡單的示意圖去解釋下這三種對象的具體使用場景,在這個示例的項目中,我省略了數據傳輸對象,將資料庫持久化對象直接轉換成頁面顯示的視圖對象。

  2、組件載入

  首先我們需要通過 Nuget 將 AutoMapper 載入到項目中,因為這個示例項目只包含一個 MVC 的項目,並沒有多餘的分層,所以這裡需要將兩個使用到的 dll 都添加到這個 MVC 項目中。

Install-Package AutoMapper
Install-Package AutoMapper.Extensions.Microsoft.DependencyInjection

  這裡我添加了 AutoMapper.Extensions.Microsoft.DependencyInjection 這個程式集,從這個程式集的名字就可以看出來,這個程式集主要是為了我們可以通過依賴註入的方式在項目中去使用 AutoMapper。

  在 .NET Fx 的時代,我們使用 AutoMapper 時,可能就像下麵的代碼一樣,更多的是通過 Mapper 的幾個靜態方法來實現實體間的映射,不過在 .NET Core 程式中,我們首選還是採用依賴註入的方式去完成實體間的映射。

// 構建實體映射規則
Mapper.Initialize(cfg => cfg.CreateMap<OrderModel, OrderDto>());

// 實體映射
var order = new OrderModel{};
OrderDto dto = Mapper.Map<OrderModel,OrderDto>(order);

  3、使用案例

  因為原本想要使用的示例項目是之前的 ingos-server 這個項目,由於目前自己有在學習 DDD 的知識,並且有在按照微軟的 eShopOnContainers 這個項目中基於 DDD 思想設計的框架,對自己的這個 ingos-server 項目進行 DDD 化的調整,嗯,其實就是照葫蘆畫瓢,所以目前整個項目被我改的亂七八糟的,不太適合作為示例項目了,所以這裡新創建了一個比較單純的 ASP.NET Core MVC 項目來作為這篇文章的演示項目。

  因為這個示例項目只是為了演示如何在 ASP.NET Core 項目中去使用 AutoMapper,所以這裡並沒有進行分層,整個示例頁面的運行流程就是,PostController 中的 List Action 調用 PostAppService 類中的 GetPostLists 方法去獲取所有的文章數據,同時在這個方法中會進行實體映射,將我們從 PostDomain 中獲取到的 PO 對象轉換成頁面展示的 VO 對象,項目中每個文件夾的作用見下圖所示。

  這裡的示例項目是演示當我們從資料庫獲取到需要的數據後,如何完成從 PO 到 VO 的實體映射,PostModel(PO)和 PostViewModel(VO)的類定義如下所示。

public class PostModel
{
    public Guid Id { get; set; }
    public long SerialNo { get; set; }
    public string Title { get; set; }
    public string Author { get; set; }
    public string Image { get; set; }
    public short CategoryCode { get; set; }
    public bool IsDraft { get; set; }
    public string Content { get; set; }
    public DateTime ReleaseDate { get; set; }
    public virtual IList<CommentModel> Comments { get; set; }
}

public class PostViewModel
{
    public Guid Id { get; set; }
    public long SerialNo { get; set; }
    public string Title { get; set; }
    public string Author { get; set; }
    public short CategoryCode { get; set; }
    public string Category => CategoryCode == 1001 ? ".NET" : "雜談";
    public string ReleaseDate { get; set; }
    public short CommentCounts { get; set; }
    public virtual int Count { get; set; }
}

  首先我們需要創建一個實體映射的配置類,需要繼承於 AutoMapper 的 Profile 類,在無參構造函數中,我們就可以通過 CreateMap 方法去創建兩個實體間的映射關係。

public class PostProfile : Profile
{
    /// <summary>
    /// ctor
    /// </summary>
    public PostProfile()
    {
        // 配置 mapping 規則
        //
        CreateMap<PostModel, PostViewModel>();
    }
}

  通過泛型的 CreateMap 方法就可以完成我們從 PostModel(PO) 到 PostViewModel(VO) 的實體映射。當然,因為 AutoMapper 預設是通過匹配欄位名稱和類型進行自動匹配,所以如果你進行轉換的兩個類的中的某些欄位名稱不一樣,這裡我們就需要進行手動的編寫轉換規則。

  就像在這個需要進行實體映射的示例代碼中,PostViewModel 中的 CommentCounts 欄位是根據 PostModel 中 CommentModel 集合的數據個數進行賦值的,所以這裡我們就需要對這個欄位的轉換規則進行修改。

  在 AutoMapper 中,我們可以通過 ForMember 方法對映射規則做進一步的加工。這裡我們需要指明 PostViewModel 的 CommentCounts 欄位的值是通過對 PostModel 中的 Comments 信息進行求和從而獲取到的,最終實現的轉換代碼如下所示。

public class PostProfile : Profile
{
    /// <summary>
    /// ctor
    /// </summary>
    public PostProfile()
    {
        // 配置 mapping 規則
        //
        CreateMap<PostModel, PostViewModel>()
            .ForMember(destination => destination.CommentCounts, source => source.MapFrom(i => i.Comments.Count()));
    }
}

  ForMember 方法不僅可以進行指定不同名稱的欄位進行轉換,也可以通過編寫規則實現欄位類型的轉換。例如這裡 PO 中的 ReleaseDate 欄位其實是 DateTime 類型的,我們需要通過編寫規則將該欄位對應到 VO 中 string 類型的 ReleaseDate 欄位上,最終的實現代碼如下所示。

public class PostProfile : Profile
{
    /// <summary>
    /// ctor
    /// </summary>
    public PostProfile()
    {
        // Config mapping rules
        //
        CreateMap<PostModel, PostViewModel>()
            .ForMember(destination => destination.CommentCounts, source => source.MapFrom(i => i.Comments.Count()))
            .ForMember(destination => destination.ReleaseDate, source => source.ConvertUsing(new DateTimeConverter()));
    }
}

public class DateTimeConverter : IValueConverter<DateTime, string>
{
    public string Convert(DateTime source, ResolutionContext context)
        => source.ToString("yyyy-MM-dd HH:mm:ss");
}

  這裡很多人可能習慣將所有的實體映射規則都放到同一個 Profile 文件裡面,因為這裡採用是單體架構的項目,所以整個項目中會存在不同的模塊,所以這裡我是按照每個模塊去創建對應的 Profile 文件。實際在 ingos-server 這個項目中的使用方式見下圖所示。

   當我們創建好對應的映射規則後,因為我們是採用依賴註入的方式進行使用,所以這裡我們就需要將我們的匹配規則註入到 IServiceCollection 中。從之前載入的程式集的 github readme 描述中可以看到,我們需要將配置好的 Profile 類通過 AddAutoMapper 這個擴展方法進行註入。

  因為我們在實際項目中可能存在多個自定義的 Profile 文件,而我們肯定是需要將這些自定義規則都註入到 IServiceCollection 中。所以我在 AddAutoMapper 這個方法的基礎上創建了一個 AddAutoMapperProfiles 方法去註入我們的實體映射規則。

  通過 AutoMapper 的說明我們可以看出來,所有的自定義的 Profile 類都是需要繼承於 AutoMapper 的 Profile 基類,所以這裡我是採用反射的方式,通過獲取到程式集中所有繼承於 Profile 類的類文件進行批量的註入到 IServiceCollection 中,具體的實現代碼如下所示。

/// <summary>
/// Automapper 映射規則配置擴展方法
/// </summary>
public static class AutoMapperExtension
{
    public static IServiceCollection AddAutoMapperProfiles(this IServiceCollection services)
    {
        // 從 appsettings.json 中獲取包含配置規則的程式集信息
        string assemblies = ConfigurationManager.GetConfig("Assembly:Mapper");

        if (!string.IsNullOrEmpty(assemblies))
        {
            var profiles = new List<Type>();

            // 獲取繼承的 Profile 類型信息
            var parentType = typeof(Profile);

            foreach (var item in assemblies.Split(new char[] { '|' }, StringSplitOptions.RemoveEmptyEntries))
            {
                // 獲取所有繼承於 Profile 的類
                //
                var types = Assembly.Load(item).GetTypes()
                    .Where(i => i.BaseType != null && i.BaseType.Name == parentType.Name);

                if (types.Count() != 0 || types.Any())
                    profiles.AddRange(types);
            }

            // 添加映射規則
            if (profiles.Count() != 0 || profiles.Any())
                services.AddAutoMapper(profiles.ToArray());
        }

        return services;
    }
}

  因為我是將需要載入的程式集信息放到配置文件中的,所以這裡我們只需要將包含 Profile 規則的程式集添加到對應的配置項下麵就可以了,此時如果包含多個程式集,則需要使用 `|` 進行分隔。

{
  "Assembly": {
    "Mapper": "aspnetcore-automapper-tutorial"
  }
}

  當我們將所有的實體映射規則註入到 IServiceCollection 中,就可以在代碼中使用這些實體映射規則。和其它通過依賴註入的介面使用方式相同,我們只需要在使用到的地方註入 IMapper 介面,然後通過 Map 方法就可以完成實體間的映射,使用的代碼如下。

public class PostAppService : IPostAppService
{
    #region Initialize

    /// <summary>
    ///
    /// </summary>
    private readonly IPostDomain _post;

    /// <summary>
    ///
    /// </summary>
    private readonly IMapper _mapper;

    /// <summary>
    /// ctor
    /// </summary>
    /// <param name="post"></param>
    /// <param name="mapper"></param>
    public PostAppService(IPostDomain post, IMapper mapper)
    {
        _post = post ?? throw new ArgumentNullException(nameof(post));
        _mapper = mapper ?? throw new ArgumentNullException(nameof(mapper));
    }

    #endregion Initialize

    /// <summary>
    /// 獲取所有的文章信息
    /// </summary>
    /// <returns></returns>
    public IList<PostViewModel> GetPostLists()
    {
        var datas = _post.GetPostLists();
        return _mapper.Map<IList<PostModel>, IList<PostViewModel>>(datas);
    }
}

  至此我們就實現了在 ASP.NET Core 項目中使用 AutoMapper,實現後的結果如下圖所示。

 三、總結

  本篇文章主要是演示下如何在 ASP.NET Core 項目中去使用 AutoMapper 來實現實體間的映射,因為之前只是在 .NET Fx 項目中有使用過這個組件,並沒有在 .NET Core 項目中使用,所以這次趁著國慶節假期就來嘗試如何在 .NET Core 項目中使用,整個組件使用起來其實是很簡單的,但是使用後卻可以給我們在實際的項目開發中省很多的事,所以就把自己的使用方法分享出來,如果對你有些許的幫助的話,不勝榮幸~~~


您的分享是我們最大的動力!

更多相關文章
  • 在GitHub上有個項目,本來是作為自己研究學習.net core的Demo,沒想到很多同學在看,還給了很多星,所以覺得應該升成3.0,整理一下,寫成博分享給學習.net core的同學們。 項目名稱:Asp.NetCoreExperiment 項目地址:https://github.c... ...
  • 本文轉自:https://www.cnblogs.com/shangwater/p/5449470.html 錯誤:程式集綁定日誌記錄被關閉。 解決方法: 將IIS中的應用程式服務池中"啟動32位應用程式"設置為true。 錯誤描述: 部署到IIS中的應用程式出現如下錯誤(Win7 x64位 .ne ...
  • 一、簡要說明 ABP vNext 當中的審計模塊早在 "依賴註入與攔截器" 一文中有所提及,但沒有詳細的對其進行分析。 審計模塊是 ABP vNext 框架的一個基本組件,它能夠提供一些實用日誌記錄。不過這裡的日誌不是說系統日誌,而是說介面每次調用之後的執行情況(執行時間、傳入參數、異常信息、請求 ...
  • 1.ServiceStack.Redis封裝 封裝的Redis操作類名為RedisHandle,如下代碼塊(只展示部分代碼),它的特點: 1)使用連接池管理連接,見代碼中的PooledClientManager屬性。如果不用連接池,而是代碼直接RedisClient client = new Red ...
  • public partial class App : System.Windows.Application { protected override void OnStartup(StartupEventArgs e) { base.OnStartup(e); SetupWindow... ...
一周排行
  • 一、背景 代碼實例:https://gitee.com/D_C_L/CurtainEtcAOP.git我們實際系統中有很多操作,是不管做多少次,都應該產生一樣的效果或返回一樣的結果。 例如: 1. 前端重覆提交選中的數據,應該後臺只產生對應這個數據的一個反應結果。 2. 我們發起一筆付款請求,應該只 ...
  • 關鍵字:流程未來節點處理人 工作流快速開發平臺 工作流流設計 業務流程管理 asp.net 開源工作流 業務背景:一個流程在啟動起來後,是可以對一些節點計算出來處理人是誰,流程的走向。對於另外一些節點處理人有可能需要相關的人員調整的。在一些審批的環境下,需要把能夠計算出來的節點處理人在發起時計算出來... ...
  • 簡述 我們做軟體工作的雖然每天都離不開網路,可網路協議細節卻不是每個人都會接觸和深入瞭解。我今天就來和大家一起學習下Socket,並寫一個簡單的聊天程式。 一些基礎類 首先我們每天打開瀏覽器訪問網頁信息都是使用的HTTP/HTTPS協議,而HTTP是通過的TCP建立的連接。TCP底層又是通過的Soc ...
  • 點這裡進入ABP進階教程目錄 在功能按鈕區增加一個自定義按鈕 - Add(創建課程) 添加按鈕 打開展示層(即JD.CRS.Web.Mvc)的\wwwroot\view-resources\Views\Course\Index.js //用以存放Course查詢相關腳本 自帶按鈕已有五個我們再添加一 ...
  • 點這裡進入ABP進階教程目錄 我們嘗試在新增/編輯界面增加一個下拉框用來代替輸入框編輯Status 添加實體 打開領域層(即JD.CRS.Core)的Entitys目錄 //用以存放實體對象添加一個類StatusCode.cs //狀態信息 更新模型 更新查詢視圖模型 打開展示層(即JD.CRS.W ...
  • 在項目視圖中,找到-》輸出 視窗,在視窗中選擇ASP.NET Core Web伺服器,調試項目即可看到執行的sql語句 ...
  • 前言: 通過Fiddler抓取瀏覽器請求數據,相信大家已經都會用了,我們知道Fiddler是通過在本機計算器添加一個預設的代理伺服器來實現的抓包數據的,埠號為:8888。 其實當我們打開Fiddler的設置也可以看到: 然後查看本地計算器的網路代理設置: 基於上面的原理,Fiddler就實現了經過 ...
  • 場景 Winform控制項-DevExpress18下載安裝註冊以及在VS中使用: https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/100061243 在上面已經實現DevExpress的安裝之後,拖拽一個TreeList,然後怎樣給 ...
  • 場景 Winform控制項-DevExpress18下載安裝註冊以及在VS中使用: https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/100061243 DevExpress的TreeList怎樣設置數據源,從實例入手: https:/ ...
  • 場景 在開發中,經常會有一些全局作用域的常量、欄位、屬性、方法等。 需要將這些設置為全局作用域保存且其實例唯一。 註: 博客主頁: https://blog.csdn.net/badao_liumang_qizhi 關註公眾號 霸道的程式猿 獲取編程相關電子書、教程推送與免費下載。 實現 首先新建一 ...
x