demo地址：ABP.WindowsService

该文章是系列文章基于.NetCore和ABP框架如何让Windows服务执行Quartz定时作业的其中一篇。

AutoMapper简介

AutoMapper是一个简单的小型的对象映射库，是为了解决一个繁杂的问题 - 将一个对象映射到另一个对象的到处乱飞的胶水代码。这类胶水代码非常沉闷，让人怀疑自己的工作的价值性。AutoMapper就是你摆脱此类代码的福音。

官网地址：https://automapper.org/

GitHub地址：https://github.com/AutoMapper/AutoMapper

AutoMapper的简单使用

这里拿官网的例子做一个简单说明，主要是为了引出在Abp中是如何使用的，来进行对比。使用AutoMapper将遇到的最经典的两个场景。

最多遇到的场景，应该是接口返回的DTO和数据库Entity，出于敏感信息保护或者减少接口返回数据等等的原因，DTO返回的属性或者字段有所删减，也就是说需要映射的属性或者字段属性名称一致。
DTO和Entity名称不一致，甚至类型不同，相互转换时甚至需要对数据有处理。

下面的例子就是字段属性基本一致。

public class Order

{

		public string OrderName { get;set; }

		public string PhoneNumber { get;set; }

}

public class OrderDto

{

		public string OrderName { get;set; }

}

var config = new MapperConfiguration(cfg => cfg.CreateMap<Order, OrderDto>());

var mapper = config.CreateMapper();

OrderDto dto = mapper.Map<OrderDto>(order);

或者

var config = new MapperConfiguration(cfg => cfg.CreateMap<Order, OrderDto>());

var mapper = new Mapper(config);

OrderDto dto = mapper.Map<OrderDto>(order);

Abp.AutoMapper的简单使用

Abp.AutoMapper的官网文档：https://aspnetboilerplate.com/Pages/Documents/Object-To-Object-Mapping

Abp.AutoMapper的Nuget地址：https://www.nuget.org/packages/Abp.AutoMapper

添加nuget包

Install-Package Abp.AutoMapper

添加AbpAutoMapperModule模块

[DependsOn(typeof(AbpAutoMapperModule))]

public class MyJobCoreModule : AbpModule

{

}

指定映射关系

自动映射

你可以通过属性AutoMap, AutoMapFrom, AutoMapTo指定映射关系

改造上面的之前的例子

[AutoMapFrom(typeof(Order))]

public class OrderDto

{

		public string OrderName { get;set; }

}

或者

[AutoMapTo(typeof(OrderDto))]

public class Order

{

		public string OrderName { get;set; }

		public string PhoneNumber { get;set; }

}

但是属性的使用场景比较窄，稍微复杂一点的场景就无法满足，比如，指定忽略一些字段，或者字段名称不同需要显示指定。

自定义映射

[DependsOn(typeof(AbpAutoMapperModule))]

public class MyJobCoreModule : AbpModule

{

    public override void PreInitialize()

    {

        Configuration.Modules.AbpAutoMapper().Configurators.Add(config =>

        {

            config.CreateMap<Order, OrderDto>();

        });

    }

}

忽略字段

config.CreateMap<Order, OrderDto>()

		  .ForMember(u => u.PhoneNumber, options => options.Ignore());

字段名不一致

OrderDto增加手机号字段Tel，映射Order字段PhoneNumber

    public class OrderDto

    {

        public string OrderName { get; set; }

        public string Tel { get; set; }

    }

config.CreateMap<Order, OrderDto>()

		  .ForMember(u => u.Tel, options => options.MapFrom(input => input.PhoneNumber));

需要对字段进行处理后返回

比如，隐藏11位手机号的中间4位

private static string HideTel(string input)

{

    if (string.IsNullOrEmpty(input))

    {

        return string.Empty;

    }

    var outReplace = Regex.Replace(input, "(\\d{3})\\d{4}(\\d{4})", "$1****$2");

    return outReplace;

}

config.CreateMap<Order, OrderDto>()

		  .ForMember(u => u.Tel, options => options.MapFrom(input => HideTel(input.PhoneNumber)));

拼接映射

又比如OrderDto新增邮寄地址和收货地址

namespace Demo.MyJob.Entity.Dto

{

    public class OrderDto

    {

        public string OrderName { get; set; }

        public string Tel { get; set; }

        public string PostalAddress { get; set; }

        public string DeliveryAddress { get; set; }

    }

}

Order的相关表OrderAddress类型定义

namespace Demo.MyJob.Entity

{

    public class OrderAddress

    {

        public string OrderId { get; set; }

        public string PostalAddress { get; set; }

        public string DeliveryAddress { get; set; }

    }

}

这时就需要OrderAddress和Order的数据相结合映射OrderDto，怎么实现呢？借助元组Tuple。

config.CreateMap<(Order, OrderAddress), OrderDto>()

		  .ForMember(u => u.Tel, options => options.MapFrom(input => HideTel(input.Item1.PhoneNumber)))

		  .ForMember(u => u.OrderName, options => options.MapFrom(input => input.Item1.OrderName))

		  .ForMember(u => u.PostalAddress, options => options.MapFrom(input => input.Item2.PostalAddress))

		  .ForMember(u => u.DeliveryAddress, options => options.MapFrom(input => input.Item2.DeliveryAddress))

		  ;

精简配置

需要自定义的映射关系过多时，会使得PreInitialize变大，不便于管理和查看。

public override void PreInitialize()

{

    Configuration.Modules.AbpAutoMapper().Configurators.Add(config =>

    {

        config.CreateMap<(Order, OrderAddress), OrderDto>()

		  .ForMember(u => u.Tel, options => options.MapFrom(input => HideTel(input.Item1.PhoneNumber)))

		  .ForMember(u => u.OrderName, options => options.MapFrom(input => input.Item1.OrderName))

		  .ForMember(u => u.PostalAddress, options => options.MapFrom(input => input.Item2.PostalAddress))

		  .ForMember(u => u.DeliveryAddress, options => options.MapFrom(input => input.Item2.DeliveryAddress))

		  ;

    });

}

如何精简？新增类型MyMapperProfile，继承AutoMapper.Profile

using System.Text.RegularExpressions;

using AutoMapper;

using Demo.MyJob.Entity;

using Demo.MyJob.Entity.Dto;

namespace Demo.MyJob.MapperProfiles

{

    class MyMapperProfile : Profile

    {

        private static string HideTel(string input)

        {

            if (string.IsNullOrEmpty(input))

            {

                return string.Empty;

            }

            var outReplace = Regex.Replace(input, "(\\d{3})\\d{4}(\\d{4})", "$1****$2");

            return outReplace;

        }

        public MyMapperProfile()

        {

            CreateMap<Order, OrderDto>()

                .ForMember(u => u.Tel, options => options.MapFrom(input => HideTel(input.PhoneNumber)));

            CreateMap<(Order, OrderAddress), OrderDto>()

                .ForMember(u => u.Tel, options => options.MapFrom(input => HideTel(input.Item1.PhoneNumber)))

                .ForMember(u => u.OrderName, options => options.MapFrom(input => input.Item1.OrderName))

                .ForMember(u => u.PostalAddress, options => options.MapFrom(input => input.Item2.PostalAddress))

                .ForMember(u => u.DeliveryAddress, options => options.MapFrom(input => input.Item2.DeliveryAddress))

                ;

        }

    }

}

修改PreInitialize

[DependsOn(typeof(AbpAutoMapperModule))]

public class MyJobCoreModule : AbpModule

{

    public override void PreInitialize()

    {

        Configuration.Modules.AbpAutoMapper().Configurators.Add(config =>

        {

            config.AddMaps(typeof(MyJobCoreModule));

        });

    }

}

Abp.AutoMapper版本低于4.8.0的可以修改为

config.AddProfiles(typeof(MyJobCoreModule));

以上就是如何在Abp框架下灵活使用AutoMapper的全部内容，谢谢阅读。

巴特西

在ABP中灵活使用AutoMapper