本章主要簡單介紹下在ASP.NET Core中如何使用AutoMapper進行物體映射,在正式進入主題之前我們來看下幾個概念:
1、資料庫持久化物件PO(Persistent Object):顧名思義,這個物件是用來將我們的資料持久化到資料庫,一般來說,持久化物件中的欄位會與資料庫中對應的 table 保持一致,
2、視圖物件VO(View Object):視圖物件 VO 是面向前端用戶頁面的,一般會包含呈現給用戶的某個頁面/組件中所包含的所有資料欄位資訊,
3、資料傳輸物件DTO(Data Transfer Object):資料傳輸物件 DTO 一般用于前端展示層與后臺服務層之間的資料傳遞,以一種媒介的形式完成 資料庫持久化物件 與 視圖物件 之間的資料傳遞,
4、AutoMapper 是一個 OOM(Object-Object-Mapping) 組件,從名字上就可以看出來,這一系列的組件主要是為了幫助我們實作物體間的相互轉換,從而避免我們每次都采用手工撰寫代碼的方式進行轉換,
接下來正式進入本章主題,我們直接通過一個使用案例來說明在ASP.NET Core中如何使用AutoMapper進行物體映射,
在之前的基礎上我們再添加一個web專案TianYa.DotNetShare.AutoMapperDemo用于演示AutoMapper的使用,首先來看一下我們的解決方案:

分別對上面的工程進行簡單的說明:
1、TianYa.DotNetShare.Model:為demo的物體層
2、TianYa.DotNetShare.Repository:為demo的倉儲層即資料訪問層
3、TianYa.DotNetShare.Service:為demo的服務層即業務邏輯層
4、TianYa.DotNetShare.SharpCore:為demo的Sharp核心類別庫
5、TianYa.DotNetShare.AutoMapperDemo:為demo的web層專案,MVC框架
約定:
1、公共的類別庫,我們選擇.NET Standard 2.0作為目標框架,可與Framework進行共享,
2、本demo的web專案為ASP.NET Core Web 應用程式(.NET Core 2.2) MVC框架,
除了上面提到的這些,別的在之前的文章中就已經詳細的介紹過了,本demo沒有用到就不做過多的闡述了,
一、物體層
為了演示接下來我們創建一些物體,如下圖所示:

1、學生類Student(資料庫持久化物件)(PO)
using System; using System.Collections.Generic; using System.Text; namespace TianYa.DotNetShare.Model { /// <summary> /// 學生類 /// </summary> public class Student { /// <summary> /// 唯一ID /// </summary> public string UUID { get; set; } = Guid.NewGuid().ToString().Replace("-", ""); /// <summary> /// 學號 /// </summary> public string StuNo { get; set; } /// <summary> /// 姓名 /// </summary> public string Name { get; set; } /// <summary> /// 年齡 /// </summary> public int Age { get; set; } /// <summary> /// 性別 /// </summary> public string Sex { get; set; } /// <summary> /// 出生日期 /// </summary> public DateTime Birthday { get; set; } /// <summary> /// 年級編號 /// </summary> public short GradeId { get; set; } /// <summary> /// 是否草稿 /// </summary> public bool IsDraft { get; set; } = false; /// <summary> /// 學生發布的成果 /// </summary> public virtual IList<TecModel> Tecs { get; set; } } }
2、學生視圖類V_Student(視圖物件)(VO)
using System; using System.Collections.Generic; using System.Text; namespace TianYa.DotNetShare.Model.ViewModel { /// <summary> /// 學生視圖物件 /// </summary> public class V_Student { /// <summary> /// 唯一ID /// </summary> public string UUID { get; set; } /// <summary> /// 學號 /// </summary> public string StuNo { get; set; } /// <summary> /// 姓名 /// </summary> public string Name { get; set; } /// <summary> /// 年齡 /// </summary> public int Age { get; set; } /// <summary> /// 性別 /// </summary> public string Sex { get; set; } /// <summary> /// 出生日期 /// </summary> public string Birthday { get; set; } /// <summary> /// 年級編號 /// </summary> public short GradeId { get; set; } /// <summary> /// 年級名稱 /// </summary> public string GradeName => GradeId == 1 ? "大一" : "未知"; /// <summary> /// 發布的成果數量 /// </summary> public short TecCounts { get; set; } /// <summary> /// 操作 /// </summary> public string Operate { get; set; } } }
3、用于配合演示的成果物體
using System; using System.Collections.Generic; using System.Text; namespace TianYa.DotNetShare.Model { /// <summary> /// 成果 /// </summary> public class TecModel { /// <summary> /// 唯一ID /// </summary> public string UUID { get; set; } = Guid.NewGuid().ToString().Replace("-", ""); /// <summary> /// 成果名稱 /// </summary> public string TecName { get; set; } } }
二、服務層

本demo的服務層需要參考以下幾個程式集:
1、我們的物體層TianYa.DotNetShare.Model
2、我們的倉儲層TianYa.DotNetShare.Repository
3、需要從NuGet上添加AutoMapper

約定:
1、服務層介面都以“I”開頭,以“Service”結尾,服務層實作都以“Service”結尾,
為了演示,我們新建一個Student的服務層介面IStudentService.cs
using System; using System.Collections.Generic; using System.Text; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; namespace TianYa.DotNetShare.Service { /// <summary> /// 學生類服務層介面 /// </summary> public interface IStudentService { /// <summary> /// 根據學號獲取學生資訊 /// </summary> /// <param name="stuNo">學號</param> /// <returns>學生資訊</returns> Student GetStuInfo(string stuNo); /// <summary> /// 獲取學生視圖物件 /// </summary> /// <param name="stu">學生資料庫持久化物件</param> /// <returns>學生視圖物件</returns> V_Student GetVStuInfo(Student stu); } }
接著我們同樣在Impl中新建一個Student的服務層實作StudentService.cs,該類實作了IStudentService介面
using System; using System.Collections.Generic; using System.Text; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; using TianYa.DotNetShare.Repository; using AutoMapper; namespace TianYa.DotNetShare.Service.Impl { /// <summary> /// 學生類服務層 /// </summary> public class StudentService : IStudentService { /// <summary> /// 定義倉儲層學生抽象類物件 /// </summary> protected IStudentRepository StuRepository; /// <summary> /// 物體自動映射 /// </summary> protected readonly IMapper _mapper; /// <summary> /// 空建構式 /// </summary> public StudentService() { } /// <summary> /// 建構式 /// </summary> /// <param name="stuRepository">倉儲層學生抽象類物件</param> /// <param name="mapper">物體自動映射</param> public StudentService(IStudentRepository stuRepository, IMapper mapper) { this.StuRepository = stuRepository; _mapper = mapper; } /// <summary> /// 根據學號獲取學生資訊 /// </summary> /// <param name="stuNo">學號</param> /// <returns>學生資訊</returns> public Student GetStuInfo(string stuNo) { var stu = StuRepository.GetStuInfo(stuNo); return stu; } /// <summary> /// 獲取學生視圖物件 /// </summary> /// <param name="stu">學生資料庫持久化物件</param> /// <returns>學生視圖物件</returns> public V_Student GetVStuInfo(Student stu) { return _mapper.Map<Student, V_Student>(stu); } } }
最后添加一個物體映射配置類MyProfile,該類繼承于AutoMapper的Profile類,在配置類MyProfile的無參建構式中通過泛型的 CreateMap 方法寫映射規則,
using System; using System.Collections.Generic; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; namespace TianYa.DotNetShare.Service.AutoMapperConfig { /// <summary> /// 物體映射配置類 /// </summary> public class MyProfile : AutoMapper.Profile { /// <summary> /// 建構式 /// </summary> public MyProfile() { // 配置 mapping 規則 CreateMap<Student, V_Student>(); } } }
服務層就這樣了,接下來就是重頭戲了,如果有多個物體映射配置類,那么要如何實作一次性依賴注入呢,這個我們在Sharp核心類別庫中去統一處理,
三、Sharp核心類別庫

在之前專案的基礎上,我們還需要從NuGet上參考以下2個程式集用于實作物體自動映射:
//AutoMapper基礎組件 AutoMapper //AutoMapper依賴注入輔助組件 AutoMapper.Extensions.Microsoft.DependencyInjection

1、首先我們添加一個反射幫助類ReflectionHelper
using System; using System.Collections.Generic; using System.Reflection; using System.Linq; using System.Runtime.Loader; using Microsoft.Extensions.DependencyModel; namespace TianYa.DotNetShare.SharpCore { /// <summary> /// 反射幫助類 /// </summary> public static class ReflectionHelper { /// <summary> /// 獲取類以及類實作的介面鍵值對 /// </summary> /// <param name="assemblyName">程式集名稱</param> /// <returns>類以及類實作的介面鍵值對</returns> public static Dictionary<Type, List<Type>> GetClassInterfacePairs(this string assemblyName) { //存盤 實作類 以及 對應介面 Dictionary<Type, List<Type>> dic = new Dictionary<Type, List<Type>>(); Assembly assembly = GetAssembly(assemblyName); if (assembly != null) { Type[] types = assembly.GetTypes(); foreach (var item in types.AsEnumerable().Where(x => !x.IsAbstract && !x.IsInterface && !x.IsGenericType)) { dic.Add(item, item.GetInterfaces().Where(x => !x.IsGenericType).ToList()); } } return dic; } /// <summary> /// 獲取指定的程式集 /// </summary> /// <param name="assemblyName">程式集名稱</param> /// <returns>程式集</returns> public static Assembly GetAssembly(this string assemblyName) { return GetAllAssemblies().FirstOrDefault(assembly => assembly.FullName.Contains(assemblyName)); } /// <summary> /// 獲取所有的程式集 /// </summary> /// <returns>程式集集合</returns> private static List<Assembly> GetAllAssemblies() { var list = new List<Assembly>(); var deps = DependencyContext.Default; var libs = deps.CompileLibraries.Where(lib => !lib.Serviceable && lib.Type != "package");//排除所有的系統程式集、Nuget下載包 foreach (var lib in libs) { try { var assembly = AssemblyLoadContext.Default.LoadFromAssemblyName(new AssemblyName(lib.Name)); list.Add(assembly); } catch (Exception) { // ignored } } return list; } } }
2、接著我們添加一個AutoMapper擴展類
using Microsoft.Extensions.DependencyInjection; using System; using System.Collections.Generic; using System.Linq; using AutoMapper; namespace TianYa.DotNetShare.SharpCore.Extensions { /// <summary> /// AutoMapper擴展類 /// </summary> public static class AutoMapperExtensions { /// <summary> /// 通過反射批量注入AutoMapper映射規則 /// </summary> /// <param name="services">服務</param> /// <param name="assemblyNames">程式集陣列 如:["TianYa.DotNetShare.Repository","TianYa.DotNetShare.Service"],無需寫dll</param> public static void RegisterAutoMapperProfiles(this IServiceCollection services, params string[] assemblyNames) { foreach (string assemblyName in assemblyNames) { var listProfile = new List<Type>(); var parentType = typeof(Profile); //所有繼承于Profile的類 var types = assemblyName.GetAssembly().GetTypes() .Where(item => item.BaseType != null && item.BaseType.Name == parentType.Name); if (types != null && types.Count() > 0) { listProfile.AddRange(types); } if (listProfile.Count() > 0) { //映射規則注入 services.AddAutoMapper(listProfile.ToArray()); } } } /// <summary> /// 通過反射批量注入AutoMapper映射規則 /// </summary> /// <param name="services">服務</param> /// <param name="profileTypes">Profile的子類</param> public static void RegisterAutoMapperProfiles(this IServiceCollection services, params Type[] profileTypes) { var listProfile = new List<Type>(); var parentType = typeof(Profile); foreach (var item in profileTypes) { if (item.BaseType != null && item.BaseType.Name == parentType.Name) { listProfile.Add(item); } } if (listProfile.Count() > 0) { //映射規則注入 services.AddAutoMapper(listProfile.ToArray()); } } } }
不難看出,該類實作AutoMapper一次性注入的核心思想是:通過反射獲取程式集中繼承了AutoMapper.Profile類的所有子類,然后利用AutoMapper依賴注入輔助組件進行批量依賴注入,
四、Web層

本demo的web專案需要參考以下幾個程式集:
1、TianYa.DotNetShare.Model 我們的物體層
2、TianYa.DotNetShare.Service 我們的服務層
3、TianYa.DotNetShare.SharpCore 我們的Sharp核心類別庫
到了這里我們所有的作業都已經準備好了,接下來就是開始做注入作業了,
打開我們的Startup.cs檔案進行注入作業:
using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using TianYa.DotNetShare.SharpCore.Extensions; using TianYa.DotNetShare.Service.AutoMapperConfig; namespace TianYa.DotNetShare.AutoMapperDemo { public class Startup { public Startup(IConfiguration configuration) { Configuration = configuration; } public IConfiguration Configuration { get; } // This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) { services.Configure<CookiePolicyOptions>(options => { // This lambda determines whether user consent for non-essential cookies is needed for a given request. options.CheckConsentNeeded = context => true; options.MinimumSameSitePolicy = SameSiteMode.None; }); services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); //DI依賴注入,批量注入指定的程式集 services.RegisterTianYaSharpService(new string[] { "TianYa.DotNetShare.Repository", "TianYa.DotNetShare.Service" }); //注入AutoMapper映射規則 //services.RegisterAutoMapperProfiles(typeof(MyProfile)); //如果MyProfile寫在Web專案中可通過該方式注入AutoMapper映射規則 services.RegisterAutoMapperProfiles(new string[] { "TianYa.DotNetShare.Service" }); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IHostingEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler("/Home/Error"); } app.UseStaticFiles(); app.UseCookiePolicy(); app.UseMvc(routes => { routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); }); } } }
其中用來實作批量依賴注入的只要簡單的幾句話就搞定了,如下所示:
//DI依賴注入,批量注入指定的程式集 services.RegisterTianYaSharpService(new string[] { "TianYa.DotNetShare.Repository", "TianYa.DotNetShare.Service" }); //注入AutoMapper映射規則 //services.RegisterAutoMapperProfiles(typeof(MyProfile)); //如果MyProfile寫在Web專案中可通過該方式注入AutoMapper映射規則 services.RegisterAutoMapperProfiles(new string[] { "TianYa.DotNetShare.Service" });
Sharp核心類別庫在底層實作了批量注入的邏輯,程式集的注入必須按照先后順序進行,先進行倉儲層注入然后再進行服務層注入,
接下來我們來看看控制器里面怎么弄:
using System; using System.Collections.Generic; using System.Diagnostics; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Mvc; using AutoMapper; using TianYa.DotNetShare.AutoMapperDemo.Models; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; using TianYa.DotNetShare.Service; namespace TianYa.DotNetShare.AutoMapperDemo.Controllers { public class HomeController : Controller { /// <summary> /// 自動映射 /// </summary> private readonly IMapper _mapper; /// <summary> /// 定義服務層學生抽象類物件 /// </summary> protected IStudentService StuService; /// <summary> /// 建構式注入 /// </summary> public HomeController(IMapper mapper, IStudentService stuService) { _mapper = mapper; StuService = stuService; } public IActionResult Index() { var model = new Student { StuNo = "100001", Name = "張三", Age = 18, Sex = "男", Birthday = DateTime.Now.AddYears(-18), GradeId = 1, Tecs = new List<TecModel> { new TecModel { TecName = "成果名稱" } } }; var v_model = _mapper.Map<Student, V_Student>(model); var v_model_s = StuService.GetVStuInfo(model); return View(); } public IActionResult Privacy() { return View(); } [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)] public IActionResult Error() { return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier }); } } }
到這里我們基礎的自動物體映射就算是處理好了,最后我們除錯起來看下結果:

小結:
1、在該例子中我們實作了從Student(PO) 到 V_Student(VO)的物體映射,
2、可以發現在服務層中也注入成功了,說明AutoMapper依賴注入輔助組件的注入是全域的,
3、AutoMapper 默認是通過匹配欄位名稱和型別進行自動匹配,所以如果你進行轉換的兩個類中的某些欄位名稱不一樣,這時我們就需要進行手動的撰寫轉換規則,
4、在AutoMapper中,我們可以通過 ForMember 方法對映射規則做進一步的加工,
5、當我們將所有的物體映射規則注入到 IServiceCollection 中后,就可以在代碼中使用這些物體映射規則,和其它通過依賴注入的介面使用方式相同,我們只需要在使用到的地方注入 IMapper 介面,然后通過 Map 方法就可以完成物體間的映射,
接下來我們針對小結的第4點舉些例子來說明一下:
1、在映射時忽略某些不需要的欄位,不對其進行映射,
修改映射規則如下:
/// <summary> /// 物體映射配置類 /// </summary> public class MyProfile : AutoMapper.Profile { /// <summary> /// 建構式 /// </summary> public MyProfile() { // 配置 mapping 規則 //<源物件,目標物件> 實作從 源物件 到 目標物件 的物體映射 CreateMap<Student, V_Student>() .ForMember(destination => destination.UUID, opt => opt.Ignore()); //不對UUID進行映射 } }
來看下除錯結果:

此時可以發現映射得到的物件v_model_s中的UUID為null了,
2、可以指明V_Student中的屬性TecCounts值是來自Student中的Tecs的集合元素個數,
修改映射規則如下:
/// <summary> /// 物體映射配置類 /// </summary> public class MyProfile : AutoMapper.Profile { /// <summary> /// 建構式 /// </summary> public MyProfile() { // 配置 mapping 規則 //<源物件,目標物件> 實作從 源物件 到 目標物件 的物體映射 CreateMap<Student, V_Student>() .ForMember(destination => destination.UUID, opt => opt.Ignore()) //不對UUID進行映射 .ForMember(destination => destination.TecCounts, opt => opt.MapFrom(source => source.Tecs.Count)); //指明來源 } }
來看下除錯結果:

可以發現映射得到的物件v_model_s中的TecCounts值從0變成1了,
3、ForMember方法不僅可以進行指定不同名稱的欄位進行轉換,也可以通過撰寫規則來實作欄位型別的轉換,
例如,我們Student(PO)類中的Birthday是DateTime型別的,我們需要通過撰寫規則將該欄位對應到V_Student (VO)類中string型別的Birthday欄位上,
修改映射規則如下:
using System; using System.Collections.Generic; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; using AutoMapper; namespace TianYa.DotNetShare.Service.AutoMapperConfig { /// <summary> /// 物體映射配置類 /// </summary> public class MyProfile : AutoMapper.Profile { /// <summary> /// 建構式 /// </summary> public MyProfile() { // 配置 mapping 規則 //<源物件,目標物件> 實作從 源物件 到 目標物件 的物體映射 CreateMap<Student, V_Student>() .ForMember(destination => destination.UUID, opt => opt.Ignore()) //不對UUID進行映射 .ForMember(destination => destination.TecCounts, opt => opt.MapFrom(source => source.Tecs.Count)) //指明來源 .ForMember(destination => destination.Birthday, opt => opt.ConvertUsing(new DateTimeConverter())); //型別轉換 } } /// <summary> /// 將DateTime型別轉成string型別 /// </summary> public class DateTimeConverter : IValueConverter<DateTime, string> { //實作介面 public string Convert(DateTime source, ResolutionContext context) => source.ToString("yyyy年MM月dd日"); } }
來看下除錯結果:

從除錯結果可以發現映射成功了,當然我們的ForMember還有很多用法,此處就不再進行描述了,有興趣的可以自己去進一步了解,
下面我們針對AutoMapper依賴注入再補充一種用法,如下所示:
using System; using System.Collections.Generic; using System.Linq; using Microsoft.Extensions.DependencyInjection; using AutoMapper; using TianYa.DotNetShare.Model; using TianYa.DotNetShare.Model.ViewModel; namespace TianYa.DotNetShare.AutoMapperDemo.Models { /// <summary> /// AutoMapper配置 /// </summary> public static class AutoMapperConfig { /// <summary> /// AutoMapper依賴注入 /// </summary> /// <param name="service">服務</param> public static void AddAutoMapperService(this IServiceCollection service) { //注入AutoMapper service.AddSingleton<IMapper>(new Mapper(new MapperConfiguration(cfg => { // 配置 mapping 規則 //<源物件,目標物件> 實作從 源物件 到 目標物件 的物體映射 cfg.CreateMap<Student, V_Student>() .ForMember(destination => destination.UUID, opt => opt.Ignore()) //不對UUID進行映射 .ForMember(destination => destination.TecCounts, opt => opt.MapFrom(source => source.Tecs.Count)) //指明來源 .ForMember(destination => destination.Birthday, opt => opt.ConvertUsing(new DateTimeConverter())); //型別轉換 }))); } } /// <summary> /// 將DateTime型別轉成string型別 /// </summary> public class DateTimeConverter : IValueConverter<DateTime, string> { //實作介面 public string Convert(DateTime source, ResolutionContext context) => source.ToString("yyyy年MM月dd日"); } }
然后打開我們的Startup.cs檔案進行注入作業,如下所示:
public void ConfigureServices(IServiceCollection services) { services.Configure<CookiePolicyOptions>(options => { // This lambda determines whether user consent for non-essential cookies is needed for a given request. options.CheckConsentNeeded = context => true; options.MinimumSameSitePolicy = SameSiteMode.None; }); services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2); //DI依賴注入,批量注入指定的程式集 services.RegisterTianYaSharpService(new string[] { "TianYa.DotNetShare.Repository", "TianYa.DotNetShare.Service" }); //注入AutoMapper映射規則 //services.RegisterAutoMapperProfiles(typeof(MyProfile)); //如果MyProfile寫在Web專案中可通過該方式注入AutoMapper映射規則 //services.RegisterAutoMapperProfiles(new string[] { "TianYa.DotNetShare.Service" }); services.AddAutoMapperService(); }
以上的這種AutoMapper依賴注入方式也是可以的,
至此,本章就介紹完了,如果你覺得這篇文章對你有所幫助請記得點贊哦,謝謝!!!
demo原始碼:
鏈接:https://pan.baidu.com/s/1axJhWD5alrTAawSwEWJTVA 提取碼:00z5
參考博文:https://www.cnblogs.com/danvic712/p/11628523.html
著作權宣告:如有雷同純屬巧合,如有侵權請及時聯系本人修改,謝謝!!!
轉載請註明出處,本文鏈接:https://www.uj5u.com/net/87862.html
標籤:.NET Core
