ModelMapper:从对象到对象的映射库

1.ModelMapper入口类

ModelMapper这个工具的入口类就是ModelMapper,因此转换就需要从这个类入口.简单看下API

  1. addConverter() :顾名思义,添加转换器
  2. addMappings() :添加映射器
  3. createTypeMap() :创建A-B的转换器关系
  4. getConfiguration() :获取配置
  5. map() ;映射处理

2.简单Model-DTO转换

 

Paste_Image.png


    /**
     * 简单类-类转换
     */
    @Test
    public void testModelToDTO() {
        User user = new User();
        user.setId(1L);
        user.setNickname("张三");
        user.setEmail("101@qq.com");
        user.setHonor("测试荣誉");
        ModelMapper modelMapper = new ModelMapper();
        UserDTO userDTO = modelMapper.map(user, UserDTO.class);
        System.out.println(userDTO);
    }

这里转换替换是根据字段名匹配也就是当User和UserDTO中的字段名称一样就会自动转换.

3.自定义转换

自定义有很多转换,比如Provider,Converter,Condition,PropertyMap等,下面是个综合的例子.


 /**
     * 简单类到类自定义字段
     */
    @Test
    public void testModelToDTOByDe(){
        User user = new User();
        user.setId(1L);
        user.setNickname("张三");
        user.setEmail("101@qq.com");
        user.setHonor("测试荣誉");
        ModelMapper modelMapper = new ModelMapper();

        //转换内容提供者
        Provider<String> personProvider = new AbstractProvider<String>() {
            public String get() {
                return "自定义提供者";
            }
        };
        //创建自定义转换规则
        Converter<String, String> toUppercase = new AbstractConverter<String, String>() {
            protected String convert(String source) {
                System.out.println(source);
                return source == null ? null : source.toUpperCase();
            }
        };
        //创建自定义条件转换
        Condition<Long,?> gt2 = context -> {
            System.out.println(context.getSource());
            return context.getSource() > 2;
        };
        //创建自定义映射规则
        PropertyMap<User,UserDTO> propertyMap = new PropertyMap<User, UserDTO>() {
            @Override
            protected void configure() {
                using(toUppercase).map(source.getNickname(),destination.getHonor());//使用自定义转换规则
                with(personProvider).map(source.getHonor(),destination.getNickname());//使用自定义属性提供覆盖
                map(source.getAvatar()).setAvatar(null);//主动替换属性
                skip(destination.getEmail());
                when(gt2).map().setId(1L);//过滤属性
            }
        };
        //添加映射器
        modelMapper.addMappings(propertyMap);
        modelMapper.validate();
        //转换
        UserDTO userDTO = modelMapper.map(user,UserDTO.class);
        System.out.println(userDTO);
    }

对应的输出是:

UserDTO{id='null', email='null', avatar='null', nickname='自定义提供者', honor='张三'}

分析下:
Provider,Converter,Condition三个都算是转换前奏,所有的转换规则都是在PropertyMap里面配置.所以分析这个里面的配置即可.

1.using(toUppercase).map(source.getNickname(),destination.getHonor());//使用自定义转换规则
首先toUppercase是一个Converter,也就是sources的nickname会经过这个转换器,然后才设置到destination的honor中.
2.with(personProvider).map(source.getHonor(),destination.getNickname());//使用自定义属性提供覆盖
personProvider类似一个Bean工厂,当使用这个的时候,对于sources调用getHonor()的时候实际上是调用personProvider的get方法.所以结果nickname='自定义提供者'
3.map(source.getAvatar()).setAvatar(null);//主动替换属性
可以主动重设某些属性
4.skip(destination.getEmail());
过滤指定属性
5.when(gt2).map().setId(1L);//条件过滤属性
条件过滤属性,当满足gt2的时候才会调用setId方法.


4.对于集合的映射

对于集合的映射,因为泛型擦除的存在,所以需要告诉ModelMapper要转换的类型,所以就有了TypeToken这个类.


 @Test
    public void testListToListDto() {
        User user1 = new User();
        user1.setId(1L);
        user1.setNickname("张三");
        user1.setEmail("101@qq.com");
        user1.setHonor("测试荣誉");
        User user2 = new User();
        user2.setId(1L);
        user2.setNickname("李四");
        user2.setEmail("101@qq.com");
        user2.setHonor("测试荣誉");
        List<User> users = new ArrayList<>();
        users.add(user1);
        users.add(user2);

        ModelMapper modelMapper = new ModelMapper();
        List<UserDTO> userDTOS = modelMapper.map(users,new TypeToken<List<UserDTO>>() {}.getType());
        System.out.println(userDTOS);
    }

5.针对集合作为属性的映射

这个是最近做项目遇到的一个问题.
比如PageInfo里面包含了一些分页信息,和一个结果集,其中结果集是集合,我想把左边转换为右边.找了些资料,没发现特别好的办法,现在是额外定义转换器,专门对内部的List进行转换.

Paste_Image.png


ModelMapper modelMapper = new ModelMapper();
        modelMapper.getConfiguration().setMatchingStrategy(MatchingStrategies.STANDARD);
        //针对内部list的转换
        Converter<ArrayList<ArticlePC>,ArrayList<ArticleListDTO>> converter = new AbstractConverter<ArrayList<ArticlePC>, ArrayList<ArticleListDTO>>() {
            @Override
            protected ArrayList<ArticleListDTO> convert(ArrayList<ArticlePC> source) {
                return modelMapper.map(source,new TypeToken<ArrayList<ArticleListDTO>>(){}.getType());
            }
        };
        PropertyMap<PageInfo<ArticlePC>,PageInfo<ArticleListDTO>> propertyMap = new PropertyMap<PageInfo<ArticlePC>, PageInfo<ArticleListDTO>>() {
            @Override
            protected void configure() {
                using(converter).map(source.getList(),destination.getList());
            }
        };
        modelMapper.addMappings(propertyMap);
        modelMapper.createTypeMap(ArticlePC.class,ArticleListDTO.class);
        return modelMapper.map(articlePCS, new TypeToken<PageInfo<ArticleListDTO>>() {
        }.getType());



作者:此博废弃_更新在个人博客
链接:https://www.jianshu.com/p/454ab6abea3f
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

ModelMapper是一个从对象到对象(object-to-object)的框架,能将Java Bean(Pojo)对象从一种表现形式转化为另一种表现形式。它采用“通过约定来配置”的方式,自动匹配不同的对象映射,同时具备满足某些特殊需求的高级功能。这与.NETAutoMapper库很类似(但不是直接移植)。

ModelMapper能用更加紧凑的代码对Java对象进行映射,在更简单的情况下甚至可以实现零配置。它支持以下特性:

  • 基于名称的对象属性映射
  • 复制公开的、受保护的和私有的字段
  • 略过某些字段
  • 可用转换器来影响映射(如将字符串转换为小写)
  • 在不同类型的字段间进行映射(如将字符串转换为数字)
  • 采用不同的条件进行映射
  • 默认条件不充分时采用松散的映射策略
  • 对映射过程进行验证以确保所有字段都被处理
  • 对特殊情况下的映射过程进行完全可定制化的控制
  • GuiceSpring集成

在企业应用中,将对象从一种形式转换成另一种是非常普遍的模式。例如,某领域模型从数据库中加载,并需要在GUI上显示给用户。其原始数据库格式会包含大量用于生命周期的属性,而屏幕前的用户可能只关心其中的一两个字段。所以很多时候,用于数据库的Pojo(JPA实体)与用于GUI的Pojo是不同的。这正是ModelMapper试图解决的问题。一般来说,当信息在企业应用内的层之间发生改变时,就会发生对象转换。

其他会发生对象转换的场景包括:

  • 多个对象聚合成一个
  • 在已存在的对象中计算一些额外的元数据
  • 转换对象以便发送到外部系统中
  • 未定义的属性里赋予默认值

 

  • 通过某种方式来转换已有的属性(对象自映射)

原文 http://modelmapper.org/getting-started/

方便处理po 到 to的数据copy,因为是小项目,对性能没有影响,所以没有做测试

 

 
  1. public class OrganTo {

  2. /***

  3. * 机构名称

  4. */

  5. String organName;

  6. /***

  7. * 机构Code

  8. */

  9. String organCode;

  10. }

 
  1. public class Organization {

  2. String name;

  3. String code;

  4. }

 
  1. @Override

  2. public List<OrganTo> getOrganList() {

  3. List<Organization> list = organizationDao.getOrganList();

  4. List<OrganTo> organList = new ArrayList<OrganTo>();

  5. ModelMapper modelMapper = new ModelMapper();

  6. modelMapper.addMappings(organMap);

  7. for (Organization organ : list) {

  8. OrganTo to = modelMapper.map(organ, OrganTo.class);

  9. organList.add(to);

  10. }

  11. return organList;

  12. }

  13.  
  14. PropertyMap<Organization,OrganTo> organMap = new PropertyMap<Organization, OrganTo>() {

  15. protected void configure() {

  16. map().setOrganCode(source.getCode());

  17. map().setOrganName(source.getName());

  18. }

  19. };

  20.  
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值