如何无需创建请求类处理含数组的动态API请求体？

你之前用HashMap<String, String>接收请求体的方式，只能处理字符串类型的字段，现在要加入数组类型的empAwardsReceived，需要调整接收方式，以下是几种可行方案：

方案1：将Map的Value类型改为Object #

直接把HashMap<String, String>换成HashMap<String, Object>，这样可以兼容字符串、数组等不同类型的字段值，获取时按需强转即可：

@PostMapping
public ResponseEntity<EmployeeResponse> getEmployees(@RequestBody HashMap<String, Object> queryParams){
    // 获取字符串类型的动态字段
    String employeeId = (String) queryParams.get("employeeId");
    String empName = (String) queryParams.get("empName");
    
    // 获取数组类型字段，强转为List<String>
    List<String> empAwardsReceived = (List<String>) queryParams.get("empAwardsReceived");
    
    // 后续业务逻辑处理...
    return ResponseEntity.ok(new EmployeeResponse());
}

优缺点：实现最简单，但需要手动强转，存在类型转换异常风险，适合快速迭代的简单场景。

方案2：使用Jackson的JsonNode接收 #

利用Jackson提供的JsonNode类来接收请求体，它可以灵活解析任意JSON结构，无需提前定义字段：

import com.fasterxml.jackson.databind.JsonNode;
import java.util.ArrayList;
import java.util.List;

@PostMapping
public ResponseEntity<EmployeeResponse> getEmployees(@RequestBody JsonNode queryParams){
    // 获取字符串字段，asText()自动处理null场景
    String employeeId = queryParams.get("employeeId").asText();
    String empName = queryParams.get("empName").asText();
    
    // 解析数组字段
    List<String> empAwardsReceived = new ArrayList<>();
    JsonNode awardsNode = queryParams.get("empAwardsReceived");
    if (awardsNode != null && awardsNode.isArray()) {
        for (JsonNode awardNode : awardsNode) {
            empAwardsReceived.add(awardNode.asText());
        }
    }
    
    // 后续业务逻辑处理...
    return ResponseEntity.ok(new EmployeeResponse());
}

优缺点：Jackson原生支持，解析灵活安全，无需强转，适合复杂的动态JSON结构，但需要手动遍历数组。

方案3：自定义请求类结合动态字段注解 #

如果希望兼顾固定字段的类型安全和动态字段的灵活性，可以创建一个包含固定数组字段+动态字段的请求类，使用Jackson的@JsonAnyGetter和@JsonAnySetter注解处理动态字段：

自定义请求类 #

import com.fasterxml.jackson.annotation.JsonAnyGetter;
import com.fasterxml.jackson.annotation.JsonAnySetter;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class EmployeeRequest {
    // 固定数组字段，类型安全
    private List<String> empAwardsReceived;
    // 存储所有动态字段
    private Map<String, Object> dynamicFields = new HashMap<>();

    // 固定字段的getter/setter
    public List<String> getEmpAwardsReceived() {
        return empAwardsReceived;
    }

    public void setEmpAwardsReceived(List<String> empAwardsReceived) {
        this.empAwardsReceived = empAwardsReceived;
    }

    // 动态字段的处理注解
    @JsonAnyGetter
    public Map<String, Object> getDynamicFields() {
        return dynamicFields;
    }

    @JsonAnySetter
    public void setDynamicField(String key, Object value) {
        dynamicFields.put(key, value);
    }
}

控制器接收 #

@PostMapping
public ResponseEntity<EmployeeResponse> getEmployees(@RequestBody EmployeeRequest request){
    // 直接获取类型安全的数组字段
    List<String> empAwardsReceived = request.getEmpAwardsReceived();
    // 从动态字段中获取其他字段
    String employeeId = (String) request.getDynamicFields().get("employeeId");
    String empName = (String) request.getDynamicFields().get("empName");
    
    // 后续业务逻辑处理...
    return ResponseEntity.ok(new EmployeeResponse());
}

优缺点：兼顾类型安全和动态性，代码可读性和可维护性更高，适合需要长期维护的项目，唯一缺点是需要额外定义请求类。

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