Spring HandlerMethodReturnValueHandler源码解析

Spring 4.3.2

Spring的Controller调用业务逻辑返回的Object会经过HandlerMethodReturnValueHandler的转换，接口HandlerMethodReturnValueHandler定义了两个方法

package org.springframework.web.method.support;

import org.springframework.core.MethodParameter;
import org.springframework.web.context.request.NativeWebRequest;

public interface HandlerMethodReturnValueHandler {

    boolean supportsReturnType(MethodParameter returnType);

    void handleReturnValue(Object returnValue, MethodParameter returnType,
            ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception;

}

当supportsReturnType返回true时会调用handleReturnValue转换

源代码如下org.springframework.web.method.support.HandlerMethodReturnValueHandlerComposite

private HandlerMethodReturnValueHandler getReturnValueHandler(MethodParameter returnType) {
        for (HandlerMethodReturnValueHandler handler : this.returnValueHandlers) {
            if (handler.supportsReturnType(returnType)) {
                return handler;
            }
        }
        return null;
    }

默认有15个实现HandlerMethodReturnValueHandler的类，在org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter中添加

源代码如下

注释是HandlerMethodReturnValueHandler处理的返回值类型

private List<HandlerMethodReturnValueHandler> getDefaultReturnValueHandlers() {
        List<HandlerMethodReturnValueHandler> handlers = new ArrayList<HandlerMethodReturnValueHandler>();

        // Single-purpose return value types
        handlers.add(new ModelAndViewMethodReturnValueHandler()); // 处理返回类型ModelAndView
        handlers.add(new ModelMethodProcessor()); // 处理返回类型Model
        handlers.add(new ViewMethodReturnValueHandler()); // 处理返回类型View
        handlers.add(new ResponseBodyEmitterReturnValueHandler(getMessageConverters())); // 处理返回类型 ？
        handlers.add(new StreamingResponseBodyReturnValueHandler()); // 处理返回类型StreamingResponseBody
        handlers.add(new HttpEntityMethodProcessor(getMessageConverters(), // 处理返回类型HttpEntity|RequestEntity
                this.contentNegotiationManager, this.requestResponseBodyAdvice));
        handlers.add(new HttpHeadersReturnValueHandler()); // 处理返回类型HttpHeaders
        handlers.add(new CallableMethodReturnValueHandler()); // 处理返回类型Callable
        handlers.add(new DeferredResultMethodReturnValueHandler()); // 处理返回类型DeferredRequest | ListenableFuture
        handlers.add(new AsyncTaskMethodReturnValueHandler(this.beanFactory)); // 处理返回类型WebAsyncTask

        // Annotation-based return value types
        handlers.add(new ModelAttributeMethodProcessor(false)); //处理@ModelAttribute
        handlers.add(new RequestResponseBodyMethodProcessor(getMessageConverters(), // 处理@ResponseBody
                this.contentNegotiationManager, this.requestResponseBodyAdvice));

        // Multi-purpose return value types
        handlers.add(new ViewNameMethodReturnValueHandler()); // 处理返回类型Void.class | CharSequense.class
        handlers.add(new MapMethodProcessor()); // 处理返回类型Map

        // Custom return value types
        if (getCustomReturnValueHandlers() != null) {
            handlers.addAll(getCustomReturnValueHandlers()); // 自定义
        }

        // Catch-all
        if (!CollectionUtils.isEmpty(getModelAndViewResolvers())) {
            handlers.add(new ModelAndViewResolverMethodReturnValueHandler(getModelAndViewResolvers()));
        }
        else {
            handlers.add(new ModelAttributeMethodProcessor(true)); // 处理返回类型ModelAttribute | 普通类型
        }

        return handlers;
    }