Spring Boot 2 REST API如何自定义映射复杂抽象实体请求参数

要实现全局自动将请求参数映射到MyWeirdRequest对象，无需在每个接口重复处理，可通过自定义HandlerMethodArgumentResolver完成。它能拦截方法参数为MyWeirdRequest的请求，自动解析所有请求参数并分配到对应的Map中。

步骤1：实现HandlerMethodArgumentResolver #

创建类实现HandlerMethodArgumentResolver接口，完成参数类型判断和解析逻辑：

import org.springframework.core.MethodParameter;
import org.springframework.web.bind.support.WebDataBinderFactory;
import org.springframework.web.context.request.NativeWebRequest;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.ModelAndViewContainer;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.Map;

public class MyWeirdRequestArgumentResolver implements HandlerMethodArgumentResolver {

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return MyWeirdRequest.class.equals(parameter.getParameterType());
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        HttpServletRequest request = webRequest.getNativeRequest(HttpServletRequest.class);
        Map<String, String[]> parameterMap = request.getParameterMap();
        
        MyWeirdRequest myWeirdRequest = new MyWeirdRequest();
        Map<String, String> startWithOne = new HashMap<>();
        Map<String, String> anythingElse = new HashMap<>();
        
        for (Map.Entry<String, String[]> entry : parameterMap.entrySet()) {
            String paramKey = entry.getKey();
            // GET请求参数默认取第一个值，多值场景可按需调整
            String paramValue = entry.getValue()[0];
            
            if (paramValue != null && paramValue.startsWith("1")) {
                startWithOne.put(paramKey, paramValue);
            } else {
                anythingElse.put(paramKey, paramValue);
            }
        }
        
        myWeirdRequest.setStartWithOne(startWithOne);
        myWeirdRequest.setAnythingElse(anythingElse);
        return myWeirdRequest;
    }
}

步骤2：注册自定义Resolver到Spring容器 #

创建配置类实现WebMvcConfigurer，将自定义Resolver添加到全局参数解析器列表：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new MyWeirdRequestArgumentResolver());
    }
}

步骤3：直接使用验证 #

你的端点代码无需任何修改，请求参数会自动解析到MyWeirdRequest对象中：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController("TestEndpoint")
@RequestMapping(path = "/", produces = org.springframework.http.MediaType.APPLICATION_JSON_VALUE)
public class TestEndpoint {

    @GetMapping("/test")
    String getTest(MyWeirdRequest myRequest) {
        return myRequest.toString();
    }
}

针对示例请求http://localhost:8088/test?first=aaa&second=1bbb&third=1ccc&fourth=2ddd，解析结果为：

• startWithOne包含second:1bbb、third:1ccc
• anythingElse包含first:aaa、fourth:2ddd

为什么不用PropertyEditor？ #

PropertyEditor仅适用于将单个字符串转换为对象，无法处理多个请求参数组合成一个对象的场景。而HandlerMethodArgumentResolver可以直接获取整个请求的参数Map，更适配此类需求，且全局生效，无需重复编码。

可选优化 #

如果存在多值参数（如param=val1&param=val2），可修改resolveArgument中的逻辑，比如将多值拼接为字符串或存入List，适配实际业务需求。

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