如何将含100+键值对的JSON字段映射到Java类（替代Switch）

问题背景 #

触发Post请求的JSON结构如下：

{   
    "xyz":"tyu",
    "abc":"test1=1&test2=2&.....test100=100"
}

其中abc字段包含100多个URL格式的键值对，需要将这些键值对映射到一个拥有对应100+字段的Java类Employee中。

最初的实现思路是在Controller中手动解析字符串，通过switch分支逐个调用setter方法：

@PostMapping("/employee")
public Response someMethod(@RequestBody Employee emp) {
       
    String reqStream = emp.getAbc();
    String[] reqStreamArray = reqStream.split("&");

    for (String pair : reqStreamArray) {
        String[] reqStreamKeyValue = pair.split("=");
        String key = reqStreamKeyValue[0];
        String value = reqStreamKeyValue[1];
        switch (key) {
            case "test1":
                emp.setTest1(value);
                break;
            // 100+个case分支...
        }
    }
    // 后续逻辑
}

这种方式需要编写大量重复的switch分支，维护成本极高，需要更优的实现方案。

可行优化方案 #

方案1：利用Java反射自动绑定字段 #

通过反射机制，根据解析出的键名找到对应的setter方法，自动完成赋值，避免硬编码分支。

实现代码示例：

@PostMapping("/employee")
public Response someMethod(@RequestBody Employee emp) throws UnsupportedEncodingException, NoSuchMethodException, InvocationTargetException, IllegalAccessException {
    String reqStream = emp.getAbc();
    // 解码URL参数，处理可能的编码字符（如%20）
    String decodedStream = URLDecoder.decode(reqStream, StandardCharsets.UTF_8.name());
    String[] reqStreamArray = decodedStream.split("&");

    Class<?> empClass = emp.getClass();
    for (String pair : reqStreamArray) {
        String[] keyValue = pair.split("=");
        if (keyValue.length != 2) {
            continue; // 跳过格式错误的键值对
        }
        String key = keyValue[0].trim();
        String value = keyValue[1].trim();

        // 构造setter方法名，如test1 -> setTest1
        String setterName = "set" + key.substring(0, 1).toUpperCase() + key.substring(1);
        try {
            // 假设字段类型为String，若为其他类型需添加类型转换逻辑
            Method setter = empClass.getMethod(setterName, String.class);
            setter.invoke(emp, value);
        } catch (NoSuchMethodException e) {
            // 记录无对应字段的日志，根据业务需求调整
            System.out.println("无对应字段：" + key);
        }
    }
    // 后续逻辑
    return new Response();
}

方案2：结合Spring工具类解析+反射绑定 #

利用Spring自带的UriComponentsBuilder工具类快速解析URL参数为键值对Map，再结合反射完成赋值，代码更简洁：

@PostMapping("/employee")
public Response someMethod(@RequestBody Employee emp) throws Exception {
    String reqStream = emp.getAbc();
    // 解析URL参数为MultiValueMap
    MultiValueMap<String, String> paramMap = UriComponentsBuilder.fromUriString("?" + reqStream).build().getQueryParams();
    
    Class<?> empClass = emp.getClass();
    for (Map.Entry<String, List<String>> entry : paramMap.entrySet()) {
        String key = entry.getKey();
        // 取第一个值，URL参数允许多个同名值，可根据业务调整
        String value = entry.getValue().get(0);
        String setterName = "set" + key.substring(0, 1).toUpperCase() + key.substring(1);
        try {
            Method setter = empClass.getMethod(setterName, String.class);
            setter.invoke(emp, value);
        } catch (NoSuchMethodException e) {
            System.out.println("忽略不存在的字段：" + key);
        }
    }
    // 后续逻辑
    return new Response();
}

方案3：自定义Jackson反序列化器（推荐） #

在Employee类上自定义反序列化逻辑，让Jackson解析JSON时自动完成abc字段的解析和字段赋值，无需在Controller中额外处理：

1. 自定义反序列化器：

public class EmployeeDeserializer extends JsonDeserializer<Employee> {
    @Override
    public Employee deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        Employee emp = new Employee();
        // 处理xyz字段
        emp.setXyz(node.get("xyz").asText());
        // 解析abc字段
        String abcStr = node.get("abc").asText();
        MultiValueMap<String, String> paramMap = UriComponentsBuilder.fromUriString("?" + abcStr).build().getQueryParams();
        
        Class<?> empClass = emp.getClass();
        for (Map.Entry<String, List<String>> entry : paramMap.entrySet()) {
            String key = entry.getKey();
            String value = entry.getValue().get(0);
            String setterName = "set" + key.substring(0, 1).toUpperCase() + key.substring(1);
            try {
                Method setter = empClass.getMethod(setterName, String.class);
                setter.invoke(emp, value);
            } catch (Exception e) {
                System.err.println("字段赋值失败：" + key);
            }
        }
        return emp;
    }
}

2. 在Employee类上指定反序列化器：

@JsonDeserialize(using = EmployeeDeserializer.class)
public class Employee {
    private String xyz;
    private String abc; // 可根据需求保留或删除
    private String test1;
    private String test2;
    // 100+个字段的getter和setter方法
}

此时Controller只需直接接收Employee对象即可：

@PostMapping("/employee")
public Response someMethod(@RequestBody Employee emp) {
    // test1、test2等字段已自动完成赋值
    // 后续逻辑
    return new Response();
}

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