快速开始

// 源模型
class Order {
  Customer customer;
  Address billingAddress;
}

class Customer {
  Name name;
}

class Name {
  String firstName;
  String lastName;
}

class Address {
  String street;
  String city;
}

// 目标模型
class OrderDTO {
  String customerFirstName;
  String customerLastName;
  String billingStreet;
  String billingCity;
}

我们可以使用 ModelMapper 隐式地将一个订单实例映射到一个新的 OrderDTO。

ModelMapper modelMapper = new ModelMapper();
OrderDTO orderDTO = modelMapper.map(order, OrderDTO.class);

assertEquals(order.getCustomer().getName().getFirstName(), orderDTO.getCustomerFirstName());
assertEquals(order.getCustomer().getName().getLastName(), orderDTO.getCustomerLastName());
assertEquals(order.getBillingAddress().getStreet(), orderDTO.getBillingStreet());
assertEquals(order.getBillingAddress().getCity(), orderDTO.getBillingCity());

自定义转换

自定义有很多转换,比如 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);
}

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

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

最近更新于 0001-01-01