Java记录类与MapStruct映射集成实践

在Java开发中，数据传输对象（DTO）与实体类之间的转换是家常便饭。传统的转换方式往往冗长且易出错，而记录类（Record）的引入和MapStruct的兴起，为这一过程带来了革命性的简化。本文将探讨如何将Java记录类与MapStruct无缝集成，提升代码质量和开发效率。

记录类：简洁与强类型

Java 14引入的记录类（Record），旨在简化数据载体的定义。它通过自动生成的构造器、getter方法和equals、hashCode、toString方法，大大减少了样板代码。

public record UserRecord(int id, String name, String email) {}

仅需一行代码，即可定义一个包含三个属性的User记录类，其简洁性和强类型特性使其成为DTO的理想选择。

MapStruct：声明式映射

MapStruct是一个编译时代码生成器，它通过简单的接口定义，自动生成高效的映射代码。其声明式风格使得映射逻辑清晰易懂。

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    @Mapping(target = "id", source = "userId")
    UserRecord userToUserRecord(User user);

    @Mapping(target = "userId", source = "id")
    User userRecordToUser(UserRecord userRecord);
}

通过定义UserMapper接口，并使用@Mapping注解指定属性映射关系，MapStruct将在编译时生成实现代码。

集成实践：记录类与MapStruct的结合

将记录类与MapStruct结合使用，可以充分发挥两者的优势。以下是一个完整的示例，展示如何从实体类到记录类，以及反向的映射。

实体类定义

public class User {
    private int userId;
    private String name;
    private String email;

    // 构造器、getter和setter省略
}

记录类定义

public record UserRecord(int id, String name, String email) {}

MapStruct映射接口

@Mapper
public interface UserMapper {
    UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);

    @Mapping(target = "id", source = "userId")
    UserRecord userToUserRecord(User user);

    @Mapping(target = "userId", source = "id")
    User userRecordToUser(UserRecord userRecord);
}

使用映射

public class Main {
    public static void main(String[] args) {
        User user = new User();
        user.setUserId(1);
        user.setName("Alice");
        user.setEmail("alice@example.com");

        UserRecord userRecord = UserMapper.INSTANCE.userToUserRecord(user);
        System.out.println(userRecord);

        User mappedUser = UserMapper.INSTANCE.userRecordToUser(userRecord);
        System.out.println(mappedUser.getName());
    }
}