• 浅入 ABP 系列(7):对象映射



    写博客的过程中,发现很多基础理论太薄弱,因此很多专业词汇可能会解释错误或者不准确,建议读者多参考官方文档或者其它书籍。

    本篇主要讲解 ABP 中如何配置、使用对象映射,其中大部分跟 AutoMapper 这个框架有关,建议读者预先学习这个框架,可参考笔者的另一篇博客:浅入 AutoMapper

    基础

    DTO和实体

    实体

    实体是领域驱动设计(Domain Driven Design)中的概念,实体通常一一映射某些对象的固有属性,最常使用的是关系型数据库中的表。

    在 ABP 中,实体位于领域层中,实体类需要实现 IEntity<TKey> 接口或继承 Entity<TKey> 基类,示例如下:

    public class Book : Entity<Guid>
    {
        public string Name { get; set; }
    
        public float Price { get; set; }
    }
    

    DTO

    数据传输对象(Data Transfer Object),作为数据传输过程中的数据模型,用于在应用层和表示层之间传输数据。

    在 ABP 中,DTO 位于应用服务层,即本系列文章示例源码中的 AbpBase.Application 项目。

    通常表示层或其它类型的客户端调用应用服务时,将 DTO 作为参数传递,它使用领域对象(实体)执行某些特定的业务逻辑,并将 DTO (跟传入的 DTO 不是同一个)返回到表示层中,因此表示层与领域层完全隔离。

    DTO 类 可能会跟 实体类的字段/属性高度相似,为每个服务的每个方法创建 DTO 类可能会很枯燥且费时间。

    ABP 的 DTO 类示例如下:

        public class ProductDto : EntityDto<Guid>
        {
            public string Name { get; set; }
            //...
        }
    

    麻烦的映射

    前面提到,领域层和应用服务层是要隔离的,例如以下伪代码:

    class HomeController
    {
        AddService _service;
        
        [HttpPost]
        public int AddEquip(EquipDto dto)
        {
            return _service.Add(dto).Id;
        }
    }
    
    class AddService
    {
        DataContext _context;  
        EquipDto Add(EquipDto dto)
        {
            Equip equip = new Equip()
            {
              Name = dto.Name;  
            };
            _context.Equip.Add(equip);
            _context.SaveChange();
            dto.Id = equip.Id;
            return dto;
        }
    }
    
    class EquipDto
    {
        int Id;
        string Name;
    }
    
    ----------
    
    class Equip
    {
        int Id;
        string Name;
    }
    

    这样每次都需要手动为 DTO 类和 实体类手动对字段赋值映射,当一个实体有数十个字段时,写出的代码会很冗长,而且容易忽略了某些字段,最终导致了 Bug。

    大家都知道, AutoMapper 正好可以解决这个问题。

    AutoMapper 集成

    ABP 的 Volo.Abp.AutoMapper 模块封装或集成了 AutoMapper,所以我们正好使用模块,为 ABP 应用定义对象映射。

    关于 AutoMapper 的使用,如何配置 Profile 等,笔者已经单独写到 浅入 AutoMapper,请点击链接另外学习 AutoMapper 的使用。

    我们可以在 AbpBase.Application 项目中,新建 一个 AbpBaseApplicationAutoMapperProfile.cs 文件,这个文件用于实现 Profile 以及定义映射。将服务领域的映射集中到这个文件中;或者新建一个 Profiles 文件夹,在其中存放一些 Profile 类。

    其内容如下:

        public class AbpBaseApplicationAutoMapperProfile:Profile
        {
            public AbpBaseApplicationAutoMapperProfile()
            {
                //base.CreateMap<MyEntity,MyDto>();
            }
        }
    

    定义完毕后,需要配置 AutoMapper 依赖注入,可在 AbpBaseApplicationModuleConfigureServices 方法中,增加以下代码:

                Configure<AbpAutoMapperOptions>(options =>
                {
                    // 以模块为单位注册映射
                    options.AddMaps<AbpBaseApplicationModule>();
                    //// 以单个 Profiel 为单位注册映射
                    //options.AddProfile<AbpBaseApplicationAutoMapperProfile>();
                });
    

    在 Debug 阶段,我们担心项目改动代码时,新增的字段忘记了加入到映射配置中,或者其它情况,在 AutoMapper 中,我们可以使用 configuration.AssertConfigurationIsValid(); 来检查映射;在 ABP 中则可使用 validate: true 参数来开启检查。

                Configure<AbpAutoMapperOptions>(options =>
                {
                    // 以模块为单位注册映射
                    options.AddMaps<AbpBaseApplicationModule>(validate: true);
                    //// 以单个 Profiel 为单位注册映射
                    //options.AddProfile<AbpBaseApplicationAutoMapperProfile>(validate: true);
                });
    

    IObjectMapper/ObjectMapper

    AbpBase.Application 项目中,添加 Nuget 包,搜索 Volo.Abp.ObjectMapping 并下载相应的稳定版本。

    IObjectMapper 有两个,一个是 AutoMapper 的接口,一个是 Volo.Abp.ObjectMapping 的 泛型接口。

    AutoMapper 的 IObjectMapper 不好用,所以别用;用 Volo.Abp.ObjectMappingIObjectMapper <接口>

    ObjectMapper 是 AutoMapper 中的,我们可以直接在控制器等位置,使用 ObjectMapper 注入,然后通过 ObjectMapper 实例映射对象。

    ObjectMapper 只有 .Map() 这个方法用得顺手。

            private readonly ObjectMapper<T1,T2> _mapper;
            public TestController(ObjectMapper<T1,T2> mapper)
            {
                _mapper = mapper;
    
                // ... 使用示例
                _ = mapper.Map<T1> ();
            }
    

    也可以通过依赖注入使用 IObjectMapper 接口。

    但是因为 ObjectMapper 是泛型类,每种类型的 DTO 都要注入一次的话,会很麻烦,因此这种方案也可以抛弃。

    而 泛型的 IObjectMapper<TModule> 是一个抽象,我们使用 IObjectMapper<TModule> 做依赖注入的话,后续如果替换为别的对象映射框架,则不需要修改原有代码即可完成替代。而且 IObjectMapper<TModule> 比较舒服。

    使用示例:

            private readonly IObjectMapper<AbpBaseApplicationModule> _mapper;
            public TestController(IObjectMapper<AbpBaseApplicationModule> mapper)
            {
                _mapper = mapper;
    
                // ... 使用示例
                _ = mapper.Map<...>();
            }
    

    对象拓展

    ABP框架提供了 实体扩展系统 允许你 添加额外属性 到已存在的对象 无需修改相关类。这句话是抄 ABP 官方文档的。

    要支持对象拓展映射,则需要开启配置:

    public class MyProfile : Profile
    {
        public MyProfile()
        {
            CreateMap<User, UserDto>()
                .MapExtraProperties();
        }
    }
    
    

    时间有限,笔者这里只把官方文档的内容讲清楚,读者看完后,需要继续查阅官方文档,完整了解对象拓展。

    ObjectExtensionManager 是一个拓展对象映射类,可以显式为类拓展一些额外的属性,这个类型在 Volo.Abp.ObjectMapping 中定义。

    ObjectExtensionManager 是一个类型,但是我们不能直接 new 它,或者使用依赖注入,只能通过 ObjectExtensionManager.Instance 这个属性获取新的类型。我们无需关心它是用了啥设计模式,还是因为缓存之类的原因这样设计。

    ObjectExtensionManager 有两种属性,其说明如下:

    • AddOrUpdate :是定义对象额外属性或更新对象额外属性的主要方法;
    • AddOrUpdateProperty:快捷地定义单个拓展属性的方法;

    AddOrUpdateProperty 用于定义单个属性,AddOrUpdate 是一个容器,可以包含多个 AddOrUpdateProperty

    AddOrUpdateProperty 示例代码如下:

    ObjectExtensionManager.Instance
        .AddOrUpdateProperty<TestA, string>("Name");
    // 为 TestA 类添加了一个 G 属性
    

    AddOrUpdate 的示例代码如下:

    ObjectExtensionManager.Instance
        .AddOrUpdate<TestA>(options =>
            {
                options.AddOrUpdateProperty<string>("Name");
                options.AddOrUpdateProperty<bool>("Nice");
            }
        );
    

    当然,我们还可以同时为多个类型同时定义一个额外的属性:

    ObjectExtensionManager.Instance
        .AddOrUpdateProperty<string>(
            new[]
            {
                typeof(TestA),
                typeof(TestB),
                typeof(TestC)
            },
            "Name"
        );
    

    如果需要定义多个属性,则可以使用 AddOrUpdate

                ObjectExtensionManager.Instance
                    .AddOrUpdate(options =>
                    {
                        options.AddOrUpdateProperty<string>("Name");
                    }, new[]{
                        typeof(TestA),
                        typeof(TestB)
                        });
    

    另外它还可以设置默认值、增加验证规则等,这些笔者就不再赘述,读者感兴趣可以点击链接进入官方文档查看。

    https://docs.abp.io/zh-Hans/abp/latest/Object-Extensions#validation

  • 相关阅读:
    使用excel2003中的solver解决最优化问题
    图的邻接表存储方式的建立
    LINUX下使用VI
    LINUX下基本命令
    应用程序各对象创建的顺序
    zookeeper常遇错误详解
    MapReduce_partition
    MapReduce_TopK
    MapReduce_MaxValue
    Hbase用java基础操作
  • 原文地址:https://www.cnblogs.com/whuanle/p/14181515.html
Copyright © 2020-2023  润新知