Java中实用的实体类映射工具MapStruct

1 vo、po、dto、bo、pojo、entity、mode的区别

在介绍MapStruct先说一下java中vo、po、dto、bo、pojo、entity、mode的区别是什么。

1）vo（value object）值对象

​ 作用：负责向前台返回数据

​ 主要体现在视图的对象，对于一个WEB页面将整个页面的属性封装成一个对象。然后用一个VO对象在控制层与视图层进行传输交换。

2）po（persistant object）持久层对象

​ 作用：只负责从数据库中获取数据,一个P0对应一个表

​ 是ORM(Objevt Relational Mapping)框架中Entity，PO属性和数据库中表的字段形成一一对应关系

​ 最形象的理解就是一个PO就是数据库中的一条记录。

3）dto（data transfer object）数据传输对象

​ 作用：负责接收前台传过来的数据并传递后端；把数据转化成VO

4）bo（business object）业务对象

​ 作用：把业务逻辑封转为一个对象， 这个对象可以包括一个或多个其它的对象。

5）pojo（plian ordinary java object）简单Java对象

​ 不包含业务逻辑或持久逻辑等，但不是JavaBean、EntityBean等，不具有任何特殊角色和不继承或不实现任何其它Java框架的类或接口。

6）dao（data access object）数据访问对象

​ 主要用来封装对数据库的访问。

2 实体类映射工具MapStruct、

说明

现在的分布式系统中，应用细分模块之后，这个时候应用与应用之间、模块与模块之间的数据模型一般都不会通用，每一层都有自己的数据类型，不同领域层用不同的javaBean对象传输数据，就需要有一个专门用来解决转换问题的工具。

MapStruct 就是这样的一个对象属性映射工具，只需要定义一个 Mapper 接口，MapStruct 就会自动实现这个映射接口，避免了复杂繁琐的映射实现。

MapStruct官网地址： http://mapstruct.org/

使用

导入依赖

<dependency>
  <groupId>org.mapstruct</groupId>
  <artifactId>mapstruct</artifactId>
  <version>1.3.1.Final</version>
</dependency>
<dependency>
  <groupId>org.mapstruct</groupId>
  <artifactId>mapstruct-processor</artifactId>
  <version>1.3.1.Final</version>
</dependency>

以PO和DTO之间的转换为例：

先写一个基础转换接口：

里面先声明好转换方法

public interface BaseConverter<D,P> {
    /**
     * DTO转PO
     * @param dto
     * @return
     */
    P toPo(D dto);

    /**
     * PO转DTO
     */
    D toDto(P po);

    /**
     * DTO集合转PO集合
     * @param dtoList
     * @return
     */
    List<P> toPo(List<D> dtoList);

    /**
     * PO集合转DTO集合
     * @param poList
     * @return
     */
    List<D> toDto(List<P> poList);

}

如果要实现在UserDto（DTO）和User（DTO）两个实体类之间进行转换，那么直接写一个UserConverter接口去继承上面写好的接口类并明好两个转化类型，同时还要加上@Mapper注解。

@Mapper(componentModel = "spring",uses= {RoleSmallConverter.class},unmappedTargetPolicy = ReportingPolicy.IGNORE)
public interface UserConverter extends BaseConverter<UserDto, User> {
}

参数说明：

• unmappedTargetPolicy=xxx

  IGNORE：未映射的target属性将被忽略

  ERROR：任何未映射的target属性都将导致映射代码生成失败

  WARN：任何未映射的target属性都会在构建时发出警告。

• componentModel =“xxx”

  default: 默认的情况，mapstruct不使用任何组件类型, 可以通过Mappers.getMapper(Class)方式获取自动生成的实例对象。

  cdi: the generated mapper is an application-scoped CDI bean and can be retrieved via @Inject

  spring（经常使用）: 生成的实现类上面会自动添加一个@Component注解，可以通过Spring的 @Autowired方式进行注入

  jsr330: 生成的实现类上会添加@javax.inject.Named 和@Singleton注解，可以通过 @Inject注解获取。

• uses={xxx.class})：引入其他转换类

这样直接调用userConverter.toDto就可直接实现User对象转换为UserDto对象了。

UserDto userDto = userConverter.toDto(user)