Spring MVC 自定义返回值处理器HandlerMethodReturnValueHandler

HandlerMethodReturnValueHandler 接口定义了控制器返回值的处理规则，可将返回值转换为响应内容。

接口定义

public interface HandlerMethodReturnValueHandler {
    boolean supportsReturnType(MethodParameter returnType);
    void handleReturnValue(Object returnValue,
                           MethodParameter returnType,
                           ModelAndViewContainer mavContainer,
                           NativeWebRequest webRequest) throws Exception;
}

核心方法

自定义返回值处理器

public class XmlReturnValueHandler implements HandlerMethodReturnValueHandler {

    @Override
    public boolean supportsReturnType(MethodParameter returnType) {
        return returnType.hasMethodAnnotation(XmlResponse.class);
    }

    @Override
    public void handleReturnValue(Object returnValue,
                                   MethodParameter returnType,
                                   ModelAndViewContainer mavContainer,
                                   NativeWebRequest webRequest) throws Exception {
        HttpServletResponse response = webRequest.getNativeResponse(HttpServletResponse.class);
        response.setContentType("application/xml;charset=UTF-8");

        // 使用 JAXB 或其他库序列化为 XML
        String xml = convertToXml(returnValue);
        response.getWriter().write(xml);

        mavContainer.setRequestHandled(true);
    }

    private String convertToXml(Object obj) {
        // XML 序列化逻辑
        return "<result>" + obj.toString() + "</result>";
    }
}

自定义注解标记

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface XmlResponse {
}

控制器使用

@RestController
@RequestMapping("/api")
public class DataController {

    @GetMapping("/data")
    @XmlResponse
    public Data getData() {
        return new Data("test", 100);
    }
}

注册返回值处理器

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) {
        handlers.add(new XmlReturnValueHandler());
    }
}

内置处理器

调用 mavContainer.setRequestHandled(true) 表示已处理请求，不再进行视图渲染。

要点总结

• supportsReturnType 匹配返回类型或方法注解
• handleReturnValue 负责写入响应内容
• 必须设置 requestHandled 阻止后续处理
• 通过 addReturnValueHandlers 注册自定义处理器