MapStruct-Java实体转换利器

MapStruct 概述

MapStruct 是一个用于生成映射器接口的代码生成库，主要用于简化 Java 对象之间的转换过程。在处理不同模型之间数据转换时，MapStruct 可以自动生成实现类减少手工转换逻辑的工作量。

使用场景：各种模型之间的转换。BO,DTO,VO,POJO…

使用步骤：

1. 引入mapstruct的pom依赖
2. 定义mapper接口（注意，这里不是MyBatis的Mapper哦），使用@Mapper注解标记，并在接口中声明映射方法。
3. 编写映射方法，（从xxxO转换为yyyO,模型之间的转换）
4. 在业务层中使用Mapper接口定义的方法，进行模型之间的转换。

MapStruct 使用例子

列举一种最简单的mapstruct的使用，dto->entity的转换

UserDTO

@Data // lombok
public class UserDTO {
    private String name;
    private int age;
}

UserEntity

@Data // lombok
public class UserEntity {
    private String username;
    private int userAge;
}

UserDTOConverter ( mapstruct 接口)

@Mapper
public interface UserModelConverter {

    UserModelConverter INSTANCE = Mappers.getMapper(UserModelConverter.class);

    /**
    * dto->entity 的转换
    */
    UserEntity convertDtoToEntity(UserDTO dto);

    /**
    * entity->dto 的转换
    */
    UserDTO convertEntityToDto(UserEntity entity);
}

UserModelConverterImpl （自动生成）

xxxConvertImpl会自动在mvn构建时生成在target目录下，这里写出来，只是为了让大家了解它的本质就是bean的转换

public class UserModelConverterImpl implements UserModelConverter {

    @Override
    public UserEntity convertDtoToEntity(UserDTO userDto) {
        if ( userDto == null ) {
            return null;
        }

        UserEntity useEntity = new UserEntity();

        useEntity.setUserName( userDto.getName() );
        useEntity.setUserAge( userDto.getAge() );

        return useEntity;
    }



    @Override
    public UserDTO convertEntityToDto(UserEntity userEntity) {
        if ( userEntity == null ) {
            return null;
        }

        UserDTO userDto = new UserDTO();

        userDto.setName( userEntity.getUserName() );
        userDto.setAge( userEntity.getUserAge() );

        return userDto;
    }
}

自动生成的impl类贴图：

Service 层使用

public class UserServiceImpl implements UserService {

    @Override
    public add(UserDTO userDto){
       UserEntity userEntity =  UserModelConverter.INSTANCE
        .convertDtoToEntity(userDto);
       // 插入到数据库中 .... 
    }

}

---

更详细的用法，可以参考 MapStruct 快速指南 | Baeldung中文网 (baeldung-cn.com)