Java实体映射工具MapStruct使用详解 Java实体映射工具MapStruct使用详

1.序通常在后端开发中经常不直接返回实体Entity类，经过处理转换返回前端，前端提交过来的对象也需要经过转换Entity实体才做存储；通常使用的BeanUtils.copyProperties方法也比较粗暴，不仅效率低下（使用反射）而且仅映射相同名的属性，多数情况下还需要手动编写对应的转换方法实现。
插件MapStruct以接口方法结合注解优雅实现对象转换，MapStruct生成器生成代码以更贴近原生的Setter、Getter方法处理属性映射更为高效。
https://github.com/mapstruct/mapstruct/
https://github.com/mapstruct/mapstruct-examples
2.简单用例实体对象User

@Data @AllArgsConstructor public class User { private int id; private String name; private int age; private String address; }

转换对象UserVO

@Data public class UserVO { private String name; private int age; }

转换接口

@Mapper public interface UserConvert { UserConvert INSTANCE = Mappers.getMapper(UserConvert.class); @Mapping(source = "name", target = "userName") UserVO toVO(User entity); }

使用示例

@Test public void contextLoads() { User user = new User(0, "Tester", 1, "上海市徐汇区"); UserVO userVO = UserConvert.INSTANCE.toVO(user); }

3.使用详解 1)关于接口注解@Mapper几种属性用法详解
uses 使用其他手动编写的或者其他Mapper接口覆写相关的转换方法，不能循环引用

@Mapper(uses=DateMapper.class)

imports 引用相关类，允许通过mapping.expression()、mapping.defaultExpression()直接使用这些类型

@Mapper(imports = DateUtil.class) public interface UserConvert { UserConvert INSTANCE = Mappers.getMapper(UserConvert.class); @Mappings({ @Mapping(source = "name", target = "userName"), // 以指定方法转换属性，这里如果不使用imports，则需要写全引用类包路径 @Mapping(target = "birthday", expression = "java(DateUtil.formatDate(entity.getBirthday()))") }) UserVO toVO(User entity); }

unmappedSourcePolicy、unmappedTargetPolicy 针对源类型/目标类型中未映射属性的反馈策略，主要有三种：IGNORE，默认值，忽略未映射的字段。WARN，警告。ERROR，报错
typeConversionPolicy 针对有损转换的反馈策略，例如Long转Integer

@Mapper(unmappedSourcePolicy = ReportingPolicy.ERROR)

componentModel 指定生成映射器实例的模式，主要有四种：default，不主动生成实例，通常以Mappers.getMapper(Class)实例化。cdi，以CDI标准实例化映射器，使用@Inject注入相关实例，spring，Spring Bean方式实例化，jsr330，jsr330标准实例化

@Mapper(componentModel = "spring") public interface UserConvert { @Mapping(source = "name", target = "userName") UserVO toVO(User entity); }

@Autowired private UserConvert userConvert;

implementationName 指定实现类名称，映射生成器接口会自动生成实现类Impl，使用此属性可避免类冲突
implementationPackage 指定实现类包路径
config 指定配置类，由指定的@MapperConfig配置类，config导入相关配置
配置类

@MapperConfig( uses = DateUtil.class, unmappedSourcePolicy = ReportingPolicy.WARN ) public interface UserConfig { }

导入配置类

@Mapper(componentModel = "spring", config = UserConfig.class)

collectionMappingStrategy 集合映射策略，这里注意集合映射时，如果集合中的类型已有对应转换方法，集合转换时会优先使用

@Mappings({ @Mapping(source = "name", target = "userName"), @Mapping(target = "birthday", expression = "java(DateUtil.formatDate(entity.getBirthday()))") }) UserVO toVO(User entity); List collectionCvt(List entities);

GENERATED CODE 生成器生成代码

public List collectionCvt(List entities) { if (entities == null) { return null; } else { List list = new ArrayList(entities.size()); Iterator var3 = entities.iterator(); while(var3.hasNext()) { User user = (User)var3.next(); // 集合转换时优先使用了已定义的toVO方法 list.add(this.toVO(user)); }return list; } }

nullValueMappingStrategy null作为源值映射策略；RETURN_NULL默认返回null, RETURN_DEFAULT返回默认值，对于对象会通过构造器自动构造对象返回，集合会返回空集合
当值为RETURN_DEFAULT时，如果映射规则中包含Mapping.expression、Mapping.constant必须手动判空处理，否则NPE

@MapperConfig(nullValueMappingStrategy = NullValueMappingStrategy.RETURN_DEFAULT)

NullValuePropertyMappingStrategy null作为源属性映射策略；SET_TO_NULL默认返回null，SET_TO_DEFAULT返回默认值，IGNORE 忽略该值，以目标对象已存在的值为准
MappingInheritanceStrategy 继承方法级映射配置策略：EXPLICIT 显示使用InheritConfiguration生效。AUTO_INHERIT_FROM_CONFIG 自动继承正向转换的配置。AUTO_INHERIT_REVERSE_FROM_CONFIG 自动继承反向转换的配置。AUTO_INHERIT_ALL_FROM_CONFIG 都继承