如何让Spring自动将RequestParam Map转换为自定义RequestMap包装类

要让Spring直接把所有请求参数自动转换为你自定义的RequestMap包装类，有两种简洁的实现方式，以下分别说明：

方法一：使用Spring Converter（推荐） #

通过实现Spring的Converter接口，定义从Map<String, String>到RequestMap的转换规则，Spring会自动复用原有请求参数转Map的逻辑，再完成类型转换。

1. 实现Converter类 #

创建一个转换器类，实现Converter<Map<String, String>, RequestMap>，并注入Spring容器：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;

@Component
public class RequestMapConverter implements Converter<Map<String, String>, RequestMap> {
    @Override
    public RequestMap convert(Map<String, String> source) {
        return new RequestMap(source);
    }
}

2. 配置与使用 #

• 如果你使用Spring Boot，@Component注解会让Spring自动发现并注册这个转换器，无需额外配置。
• 如果你使用传统Spring MVC，需要在Web配置类中手动注册转换器：

import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new RequestMapConverter());
    }
}

现在就可以直接在Controller方法中使用RequestMap作为参数，Spring会自动完成转换：

@PostMapping()
public Model showPage(@RequestParam RequestMap request) {
    // 直接使用request的便捷方法
    return new Model();
}

注意：这里需要加上@RequestParam注解，告诉Spring要将所有请求参数封装后转换为RequestMap。

方法二：自定义HandlerMethodArgumentResolver #

如果需要更灵活的参数解析逻辑（比如自定义参数获取规则），可以实现HandlerMethodArgumentResolver接口，直接从请求中提取参数构建RequestMap。

1. 实现ArgumentResolver类 #

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.Map;

public class RequestMapArgumentResolver implements HandlerMethodArgumentResolver {
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        // 只处理RequestMap类型的参数
        return RequestMap.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，处理多值参数取第一个值
        Map<String, String> paramMap = request.getParameterMap().entrySet().stream()
                .collect(java.util.stream.Collectors.toMap(
                        Map.Entry::getKey,
                        entry -> entry.getValue()[0]
                ));
        return new RequestMap(paramMap);
    }
}

2. 注册ArgumentResolver #

在Web配置类中注册这个解析器：

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 RequestMapArgumentResolver());
    }
}

3. 使用方式 #

此时Controller方法中无需添加@RequestParam注解，直接使用RequestMap参数即可：

@PostMapping()
public Model showPage(RequestMap request) {
    // 直接使用request的便捷方法
    return new Model();
}

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