ASP.NET CORE 第七篇 DTOs 对象映射使用，项目部署Windows+Linux完整版

原文作者：老张的哲学

零、今天完成右下角的深蓝色部分

image.png

一、在项目中使用添加一个案例使用AutoMapper

1、普通的模型映射
在接口 IBlogArticleServices.cs和 类BlogArticleServices.cs中，添加GetBlogDetails()方法，返回类型是BlogViewModels

请看这两个类

/// 

    /// 博客文章实体类
    /// 
    public class BlogArticle
    {
        /// 

        /// 
        /// 
        public int bID { get; set; }
        /// 

        /// 创建人
        /// 
        public string bsubmitter { get; set; }

        /// 

        /// 博客标题
        /// 
        public string btitle { get; set; }

        /// 

        /// 类别
        /// 
        public string bcategory { get; set; }

        /// 

        /// 内容
        /// 
        public string bcontent { get; set; }

        /// 

        /// 访问量
        /// 
        public int btraffic { get; set; }

        /// 

        /// 评论数量
        /// 
        public int bcommentNum { get; set; }

        /// 
 
        /// 修改时间
        /// 
        public DateTime bUpdateTime { get; set; }

        /// 

        /// 创建时间
        /// 
        public System.DateTime bCreateTime { get; set; }
        /// 

        /// 备注
        /// 
        public string bRemark { get; set; }
    }
-------------------------------------------------
　　 /// 

    /// 博客信息展示类
    /// 
    public class BlogViewModels
    {
        /// 

        /// 
        /// 
        public int bID { get; set; }
        /// 
/// 创建人
        /// 
        public string bsubmitter { get; set; }

        /// 
/// 博客标题
        /// 
        public string btitle { get; set; }

        /// 
/// 摘要
        /// 
        public string digest { get; set; }

        /// 

        /// 上一篇
        /// 
        public string previous { get; set; }

        /// 

        /// 上一篇id
        /// 
        public int previousID { get; set; }

        /// 

        /// 下一篇
        /// 
        public string next { get; set; }

        /// 

        /// 下一篇id
        /// 
        public int nextID { get; set; }

        /// 
/// 类别
        /// 
        public string bcategory { get; set; }

        /// 
/// 内容
        /// 
        public string bcontent { get; set; }

        /// 

        /// 访问量
        /// 
        public int btraffic { get; set; }

        /// 

        /// 评论数量
        /// 
        public int bcommentNum { get; set; }

        /// 
/// 修改时间
        /// 
        public DateTime bUpdateTime { get; set; }

        /// 

        /// 创建时间
        /// 
        public System.DateTime bCreateTime { get; set; }
        /// 
/// 备注
        /// 
        public string bRemark { get; set; }
    }

两个实体类字段还基本可以，不是很多，但是我曾经开发一个旅游网站的系统，有一个表字段都高达30多个，当然还有更多的，额，如果我们一个个赋值是这样的

BlogViewModels models = new BlogViewModels()
            {
                bsubmitter=blogArticle.bsubmitter,
                btitle = blogArticle.btitle,
                bcategory = blogArticle.bcategory,
                bcontent = blogArticle.bcontent,
                btraffic = blogArticle.btraffic,
                bcommentNum = blogArticle.bcommentNum,
                bUpdateTime = blogArticle.bUpdateTime,
                bCreateTime = blogArticle.bCreateTime,
                bRemark = blogArticle.bRemark,
            };    

所以这个方法的全部代码是：
接口层也要添加：

using Blog.Core.IServices.Base;
using Blog.Core.Model;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace Blog.Core.IServices
{
    public interface IArticleServices : IBaseServices

    {
        Task> getBlogs();
        Task getBlogDetails(int id);
    }
}

using Blog.Core.Common.Attribue;
using Blog.Core.IRepository;
using Blog.Core.IServices;
using Blog.Core.Model;
using Blog.Core.Services.Base;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Blog.Core.Services
{
    public class ArticleServices : BaseServices
, IArticleServices
    {
        readonly IArticleRepository dal;

        public ArticleServices(IArticleRepository dal)
        {
            this.dal = dal;
            base.baseDal = dal;
        }

        /// 

        /// 获取视图博客详情信息(一般版本)
        /// 
        /// 
        /// 
        public async Task getBlogDetails(int id)
        {
            var blogList = await dal.Query(a => a.bID > 0, a => a.bID);
            var blogArticle = (await dal.Query(a => a.bID == id)).FirstOrDefault();
            ViewModels models = null;
            if(blogArticle != null)
            {
                Article prevBlog;
                Article nextBlog;
                int blogIndex = blogList.FindIndex(item => item.bID == id);
                if(blogIndex >= 0)
                {
                    try
                    {
                        // 上一篇
                        prevBlog = blogIndex > 0 ? blogList[blogIndex - 1] : null;
                        // 下一篇
                        nextBlog = blogIndex + 1 < blogList.Count() ? blogList[blogIndex - 1] : null;

                        models = new ViewModels()
                        {
                            bsubmitter = blogArticle.bsubmitter,
                            btitle = blogArticle.btitle,
                            bcategory = blogArticle.bcategory,
                            bcontent = blogArticle.bcontent,
                            btraffic = blogArticle.btraffic,
                            bcommentNum = blogArticle.bcommentNum,
                            bUpdateTime = blogArticle.bUpdateTime,
                            bCreateTime = blogArticle.bCreateTime,
                            bRemark = blogArticle.bRemark,
                        };
                        if(nextBlog != null)
                        {
                            models.next = nextBlog.btitle;
                            models.nextID = nextBlog.bID;
                        }
                        if(prevBlog != null)
                        {
                            models.previous = prevBlog.btitle;
                            models.previousID = prevBlog.bID;
                        }
                    }catch (Exception){}
                }
                blogArticle.btraffic += 1;
                await dal.Update(blogArticle, new List { "btraffic" });
            }
            return models;
        }

        /// 

        /// 获取博客列表
        /// 
        /// 
        [Caching(AbsoluteExpiration = 20)] // 添加特性
        public async Task> getBlogs()
        {
            var blogList = await dal.Query(x => x.bID < 5);
            return blogList;
        }
    }
}

想了想这才是一个方法，一般的系统都会有少则几十，多则上百个这样的方法，这还不算，大家肯定遇到过一个情况，如果有一天要在页面多显示一个字段，噗！不是吧，首先要存在数据库，然后在该实体类就应该多一个，然后再在每一个赋值的地方增加一个，而且也没有更好的办法不是，一不小心就少了一个，然后被产品测试说咱们不细心，心塞哟，别慌！神器来了，一招搞定。

2、先来引入DTO讲解，以及它的原理

在学习EF的时候我们知道了ORM（Object Relational Mapping）映射，是一种对象关系的映射，对象-关系映射(ORM)系统一般以中间件的形式存在，主要实现程序对象到关系数据库数据的映射。

而Automapper是一种实体转换关系的模型，AutoMapper是一个.NET的对象映射工具。主要作用是进行领域对象与模型（DTO）之间的转换、数据库查询结果映射至实体对象。

下边的是基本原理，大家喵一眼就行：

Ø 什么是DTO?
　　数据传输对象（DTO)(DataTransfer Object)，是一种设计模式之间传输数据的软件应用系统。数据传输目标往往是数据访问对象从而从数据库中检索数据。数据传输对象与数据交互对象或数据访问对象之间的差异是一个以不具有任何行为除了存储和检索的数据（访问和存取器）。

Ø 为什么用？
　　它的目的只是为了对领域对象进行数据封装，实现层与层之间的数据传递。为何不能直接将领域对象用于数据传递？因为领域对象更注重领域，而DTO更注重数据。不仅如此，由于“富领域模型”的特点，这样做会直接将领域对象的行为暴露给表现层。
　　需要了解的是，数据传输对象DTO本身并不是业务对象。数据传输对象是根据UI的需求进行设计的，而不是根据领域对象进行设计的。比如，Customer领域对象可能会包含一些诸如FirstName, LastName, Email, Address等信息。但如果UI上不打算显示Address的信息，那么CustomerDTO中也无需包含这个 Address的数据”。

Ø 什么是领域对象？
　　领域模型就是面向对象的，面向对象的一个很重要的点就是：“把事情交给最适合的类去做”，即：“你得在一个个领域类之间跳转，才能找出他们如何交互”。在我们的系统中Model（EF中的实体）就是领域模型对象。领域对象主要是面对业务的，我们是通过业务来定义Model的。

以上的这些大家简单看看原理即可，意思大家肯定都懂，下边开始讲解如何使用

3、引入 AutoMapper 的相关包

在Blog.Core.Services项目中引用Nuget包，AutoMapper 和 AutoMapper.Extensions.Microsoft.DependencyInjection

AutoMapper.Extensions.Microsoft.DependencyInjection，这个是用来配合依赖注入的，看名字也能看的出来吧，大家回忆下，整个项目中，都是使用的依赖注入，所以尽量不要用new 来实例化，导致层耦合。

4、添加映射文件 CustomProfile.cs

基于上边原理，在接口层Blog.Core 中，添加文件夹AutoMapper，然后添加映射配置文件 CustomProfile.cs，用来匹配所有的映射对象关系

using AutoMapper;
using Blog.Core.Model;

namespace Blog.Core.API.AutoMapper
{
    /// 

    /// 配置构造函数，用来创建关系映射
    /// 
    public class CustomProfile : Profile
    {
        public CustomProfile()
        {
            CreateMap();
        }
    }
}

大家看下F12这个CreateMap方法：

public IMappingExpression CreateMap()；

第一个参数是原对象，第二个是目的对象，所以，要想好，是哪个方向转哪个，当然可以都写上，比如

CreateMap();
CreateMap(); 

//如果不想一个一个的配置，可以用接口的形式，批量导入
//这是一个思路，我没有具体去写，留个坑吧
//public interface IMapperTo{}
//然后同样来个Profile集中处理这些interface

/// 

/// 根据IMapperTo<>接口 自动初始化AutoMapper
/// 
public class AutoMapperProfile : Profile
{
    public override string ProfileName
    {
        get
        {
            return "AutoForIMapperTo";
        }
    }

    protected override void Configure()
    {
        base.Configure();

        typeof(SaveBuyerDemandRequest).Assembly.GetTypes()//SaveBuyerDemandRequest是TSource同属的Assembly底下的任意类，要包含多个Aeembly的话自己扩展咯
            .Where(i => i.GetInterfaces().Any(t => t.IsGenericType && t.GetGenericTypeDefinition() == typeof(IMapperTo<>)))
            .ToList().ForEach(item =>
            {
                item.GetInterfaces()
                    .Where(t => t.IsGenericType && t.GetGenericTypeDefinition() == typeof(IMapperTo<>))
                    .ToList()//这里可以支持多个IMapperTo
                    .ForEach(i => {
                        var t2 = i.GetGenericArguments()[0];
                        Mapper.CreateMap(item, t2);
                        Mapper.CreateMap(t2, item);
                    });
            });
    }
}

//Class For Example
public class SaveBuyerDemandRequest : IMapperTo
{

}

5、使用AutoMapper实现模型映射，并注入

老规矩，还是在Startup中，注入服务

services.AddAutoMapper(typeof(Startup));//这是AutoMapper的2.0新特性

修改上边服务层BlogArticleServices.cs 中getBlogDetails 方法中的赋值，改用AutoMapper，并用构造函数注入
最终的代码是：

// 依赖注入 
 IBlogArticleRepository dal;
 IMapper IMapper;
 public BlogArticleServices(IBlogArticleRepository dal, IMapper IMapper)
 {
     this.dal = dal;
     base.baseDal = dal;
     this.IMapper = IMapper;
 }
 /// 

 /// 获取视图博客详情信息
 /// 
 /// 
 /// 
 public async Task getBlogDetails(int id)
        {
            var bloglist = await dal.Query(a => a.bID > 0, a => a.bID);
            var blogArticle = (await dal.Query(a => a.bID == id)).FirstOrDefault();
            BlogViewModels models = null;

            if (blogArticle != null)
            {
                BlogArticle prevblog;
                BlogArticle nextblog;
                int blogIndex = bloglist.FindIndex(item => item.bID == id);
                if (blogIndex >= 0)
                {
                    try
                    {
                        // 上一篇
                        prevblog = blogIndex > 0 ? (((BlogArticle)(bloglist[blogIndex - 1]))) : null;
                        // 下一篇
                        nextblog = blogIndex + 1 < bloglist.Count() ? (BlogArticle)(bloglist[blogIndex + 1]) : null;

                        // 注意就是这里,mapper
                        models = IMapper.Map(blogArticle);

                        if (nextblog != null)
                        {
                            models.next = nextblog.btitle;
                            models.nextID = nextblog.bID;
                        }
                        if (prevblog != null)
                        {
                            models.previous = prevblog.btitle;
                            models.previousID = prevblog.bID;
                        }
                    }
                    catch (Exception) { }
                }
                blogArticle.btraffic += 1;
                await dal.Update(blogArticle, new List { "btraffic" });
            }

            return models;

        }

修改BlogController.cs中的 Get(int id)方法，运行项目，断点调试，发现已经成功了，是不是很方便，你也可以反过来试一试

        [HttpGet("{id}", Name = "Get")]
        public async Task