Java：如何通过POJO匹配字段批量更新对象属性？

场景说明 #

你作为Java新手，希望优化现有代码写法：现有Updatable类通过update(Parameters params)方法更新属性，当前需要逐个调用Parameters的getter方法赋值。按约定（非契约），Parameters的字段与Updatable的字段始终一一对应，想知道能否避免逐个调用getter，直接完成字段映射。

原代码 #

Updatable类（使用Lombok @Data）

@Data // 使用Lombok
class Updatable {
    public int x = 0;
    public String a = "hello";
   
    // 一些构造方法/其他方法

    public void update(final Parameters params) {
        x = params.getX();
        a = params.getA();
    }
}

Parameters类（使用Lombok @Value）

@Value
class Parameters {
    int x;
    String a;
}

可行优化方案 #

1. 基于Lombok @Builder的半自动化赋值 #

如果允许修改Updatable的定义，可以给它添加@Builder(toBuilder = true)注解，利用Lombok生成的构建器简化赋值逻辑：

修改后的Updatable类：

@Data
@Builder(toBuilder = true) // 开启实例转构建器的支持
class Updatable {
    public int x = 0;
    public String a = "hello";
   
    // 构造方法/其他方法
}

更新后的update方法：

public void update(final Parameters params) {
    // 基于当前实例生成构建器，批量设置参数字段
    Updatable updated = this.toBuilder()
        .x(params.getX())
        .a(params.getA())
        .build();
    // 将新实例的字段值同步回当前实例
    this.x = updated.getX();
    this.a = updated.getA();
}

这种方式依然需要显式指定字段，但比直接赋值更具可读性，且Lombok会帮你维护构建器代码，新增字段时只需在构建器中添加对应行即可。

2. 反射实现完全自动映射 #

利用Java反射API可以遍历类的字段，自动匹配同名字段完成赋值，适合字段数量较多的场景：

public void update(final Parameters params) throws IllegalAccessException {
    // 获取两个类的公共字段（若字段为私有，需调用field.setAccessible(true)）
    java.lang.reflect.Field[] updatableFields = this.getClass().getFields();
    java.lang.reflect.Field[] paramsFields = params.getClass().getFields();

    // 遍历参数类字段，匹配Updatable中同名字段并赋值
    for (java.lang.reflect.Field paramField : paramsFields) {
        for (java.lang.reflect.Field updatableField : updatableFields) {
            if (updatableField.getName().equals(paramField.getName())) {
                updatableField.set(this, paramField.get(params));
                break;
            }
        }
    }
}

注意：反射会带来一定的性能开销，且需要处理IllegalAccessException等异常；如果字段是私有访问权限，需要额外调用field.setAccessible(true)来突破访问限制。

3. MapStruct编译时生成映射代码（推荐） #

MapStruct是一款编译时生成映射代码的工具，性能与手写代码一致，且能自动处理字段匹配、类型转换等逻辑，适合中大型项目：

步骤1：定义映射接口

import org.mapstruct.Mapper;
import org.mapstruct.MappingTarget;

@Mapper(componentModel = "default") // 可根据项目环境选择spring/cdi等
public interface UpdatableMapper {
    // 定义从Parameters到Updatable的更新方法，@MappingTarget指定要更新的目标实例
    void updateUpdatableFromParameters(Parameters params, @MappingTarget Updatable updatable);
}

步骤2：在update方法中调用映射

public void update(final Parameters params) {
    UpdatableMapper mapper = org.mapstruct.factory.Mappers.getMapper(UpdatableMapper.class);
    mapper.updateUpdatableFromParameters(params, this);
}

编译时MapStruct会自动生成接口的实现类，完成字段的赋值逻辑，无需手写任何getter/setter调用，新增字段时也无需修改映射代码（只要字段名一致）。

4. 自定义工具类实现通用映射 #

如果不想引入第三方库，可以自己封装一个简单的字段复制工具类：

public class PojoFieldCopier {
    public static void copyMatchingFields(Object source, Object target) throws IllegalAccessException {
        java.lang.reflect.Field[] sourceFields = source.getClass().getFields();
        java.lang.reflect.Field[] targetFields = target.getClass().getFields();

        for (java.lang.reflect.Field sourceField : sourceFields) {
            for (java.lang.reflect.Field targetField : targetFields) {
                // 匹配字段名和类型后赋值
                if (targetField.getName().equals(sourceField.getName()) 
                    && targetField.getType().equals(sourceField.getType())) {
                    targetField.set(target, sourceField.get(source));
                    break;
                }
            }
        }
    }
}

然后在update方法中调用：

public void update(final Parameters params) throws IllegalAccessException {
    PojoFieldCopier.copyMatchingFields(params, this);
}

内容的提问来源于stack exchange，提问作者pstatix