Mapstruct来进行PO与VO之间的映射

文档：http://mapstruct.org/documentation/stable/reference/html/

使用Mapstruct来进行PO与VO之间的映射
   区别与mvc模型的 mvvm模型,将模型对象与视图对象view model分离开，来做到与底层model分离开来。大大解耦底层model与界面vo的关系，至此就需要一个工具来做到po与vo分离开来。
   最初的想法是使用apache-beanutils 但是其对一些深层次对象拷贝做不到，虽然可以通过改写其内部源码实现对嵌套对象属性拷贝，但是出现特殊业务转换，如 属性名字不匹配，beanutils对于mapstruct就相形见绌了。
   话不多说：

maven引入

<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct</artifactId>
<version>1.1.0.Final</version>
</dependency>

 

创建mapstuct 接口

@Mapper
public interface Persion2PersonVoMapper {

Persion2PersonVoMapper MAPPER = Mappers.getMapper(Persion2PersonVoMapper.class);

@Mappings({
@Mapping(source = "birthdate", target = "birth"),//属性名不一致映射
@Mapping(target = "birthformat", expression = "java(org.apache.commons.lang3.time.DateFormatUtils.format(person.getBirthdate(),\"yyyy-MM-dd HH:mm:ss\"))"),//自定义属性通过java代码映射

})
public PersonVo PersonToPersonVo(Person person);

public List<PersonVo> PersonToPersonVos(List<Person> list);
}

PersonVo personVo = Persion2PersonVoMapper.MAPPER.PersonToPersonVo(person);
1
源属性 birthdate 已经转换到 目标属性 birth，同时我们目标类的自定义属性也接收到源对象的格式化 birthdate 属性值为“2017-05-28 13:22:21”

  单个对象并没有体现便捷,我们来看集合对象的转换。
2. 集合对象映射测试
listTest()测试方法
查看debug信息
这是源对象集合信息

映射后的目标集合对象信息

可以看到集合转集合也只使用一行代码

List<PersonVo> personVos = Persion2PersonVoMapper.MAPPER.PersonToPersonVos(list);
1
帮我们省去很多集合遍历添加操作。

ok 我们来看看底层原理。
我们所写的 Persion2PersonVoMapper 接口在编译时生成一个Persion2PersonVoMapperImpl 实现类。

public class Persion2PersonVoMapperImpl implements Persion2PersonVoMapper {
@Override
public PersonVo PersonToPersonVo(Person person) {
if ( person == null ) {
return null;
}
PersonVo personVo = new PersonVo();
personVo.setBirth( person.getBirthdate() );
personVo.setName( person.getName() );
personVo.setAge( person.getAge() );
personVo.setWallet( person.getWallet() );
personVo.setBirthformat( org.apache.commons.lang3.time.DateFormatUtils.format(person.getBirthdate(),"yyyy-MM-dd HH:mm:ss") );
return personVo;
}
@Override
public List<PersonVo> PersonToPersonVos(List<Person> list) {
if ( list == null ) {
return null;
}
List<PersonVo> list_ = new ArrayList<PersonVo>();
for ( Person person : list ) {
list_.add( PersonToPersonVo( person ) );
}
return list_;
 
原来 并没有很高级的操作，只是mapstruct 帮我们生成的 手动get set操作，然后for add操作。

 

总结一下
关于mapper接口

它可以自动封装一些同级，属性名相同的属性名如上name age 属性，可以无需手动写 @Mapping
对于非同级或属性名 需要写相关的 @mapping 属性名不同可以查考 birth 属性配置。如果不同级@Mapping(source = “XXX.birthdate”, target = “XX.birth”) 如此就行了。
关于实现类，老版本的eclipse可能无法自动编译出来，如果使用maven，install就可以有生产类，以防可能会出现 class not found 异常。
@mapping 还有很多属性
public @interface Mapping {
String target();
String source() default "";
String dateFormat() default "";
String numberFormat() default "";
String constant() default "";
String expression() default "";
boolean ignore() default false;
Class<? extends Annotation>[] qualifiedBy() default {};
String[] qualifiedByName() default {};
Class<?> resultType() default void.class;
String[] dependsOn() default {};
String defaultValue() default "";
}

target，source，expression 在此不再复述,
dateFormat 可以代替事例中expression ，如此：

@Mapping(target = "birthformat", source = "birthdate",dateFormat = "yyyy-MM-dd HH:mm:ss"),
//生产类
if ( person.getBirthdate() != null ) {
personVo.setBirthformat( new SimpleDateFormat( "yyyy-MM-dd HH:mm:ss" ).format( person.getBirthdate() ) );
}