1. 概述
本文接 《精尽 Spring MVC 源码解析 —— HandlerAdapter 组件（一）之 HandlerAdapter》 一文，我们“再次”来分享 ServletInvocableHandlerMethod 组件。虽然 😈 WebDataBinderFactory、ModelFactory 等等类，还处于 TODO 状态，但是，我们还是非常有必要，对 ServletInvocableHandlerMethod 再来一波分析。
艿艿：HandlerAdapter 真的是 Spring MVC 九大组件里，最最最复杂的，没有之一。
2. 类图
ServletInvocableHandlerMethod 的整体类图如下：
HandlerAdapter 类图
我们来逐个解析。
3. HandlerMethod
org.springframework.web.method.HandlerMethod ，处理器的方法的封装对象。
在 《精尽 Spring MVC 源码解析 —— HandlerMapping 组件（三）之 AbstractHandlerMethodMapping》 的 「3.3.1 HandlerMethod」 中，我们已经做过详细解析。
4. InvocableHandlerMethod
org.springframework.web.method.support.InvocableHandlerMethod ，继承 HandlerMethod 类，可 invoke 调用的 HandlerMethod 实现类。
😈 也就是说，HandlerMethod 只提供了处理器的方法的基本信息，不提供调用逻辑。
4.1 构造方法
// InvocableHandlerMethod.java |
dataBinderFactory、argumentResolvers、parameterNameDiscoverer参数，是通过 setting 方法，进行设置。
4.2 invokeForRequest
#invokeForRequest(NativeWebRequest request, ModelAndViewContainer mavContainer, Object... providedArgs) 方法，执行请求。代码如下：
// InvocableHandlerMethod.java |
<1>处，调用#getMethodArgumentValues(NativeWebRequest request, ModelAndViewContainer mavContainer, Object... providedArgs)方法，解析方法的参数们。代码如下：// InvocableHandlerMethod.java
private Object[] getMethodArgumentValues(NativeWebRequest request, ModelAndViewContainer mavContainer,
Object... providedArgs) throws Exception {
// 方法的参数信息的数组
MethodParameter[] parameters = getMethodParameters();
// 解析后的参数结果数组
Object[] args = new Object[parameters.length];
// 遍历，开始解析
for (int i = 0; i < parameters.length; i++) {
// 获得当前遍历的 MethodParameter 对象，并设置 parameterNameDiscoverer 到其中
MethodParameter parameter = parameters[i];
parameter.initParameterNameDiscovery(this.parameterNameDiscoverer);
// <1> 先从 providedArgs 中获得参数。如果获得到，则进入下一个参数的解析
args[i] = resolveProvidedArgument(parameter, providedArgs);
if (args[i] != null) {
continue;
}
// <2> 判断 argumentResolvers 是否支持当前的参数解析
if (this.argumentResolvers.supportsParameter(parameter)) {
try {
// 执行解析。解析成功后，则进入下一个参数的解析
args[i] = this.argumentResolvers.resolveArgument(
parameter, mavContainer, request, this.dataBinderFactory);
continue;
} catch (Exception ex) {
// 解析失败，打印日志，并抛出异常
// Leave stack trace for later, e.g. AbstractHandlerExceptionResolver
if (logger.isDebugEnabled()) {
String message = ex.getMessage();
if (message != null && !message.contains(parameter.getExecutable().toGenericString())) {
logger.debug(formatArgumentError(parameter, message));
}
}
throw ex;
}
}
// 解析失败，抛出 IllegalStateException 异常
if (args[i] == null) {
throw new IllegalStateException(formatArgumentError(parameter, "No suitable resolver"));
}
}
// 返回结果
return args;
}- 总体的逻辑，比较简单，胖友跟着注释过一遍，就不啰嗦啦。
<1>处，先从providedArgs中获得参数。如果获得到，则进入下一个参数的解析。默认情况下，providedArgs参数不会传递，所以可以暂时先忽略。保证核心逻辑的理解。<2>处，判断argumentResolvers是否支持当前的参数解析。如果支持，则进行解析。关于 HandlerMethodArgumentResolverComposite 的详细解析，见 《精尽 Spring MVC 源码解析 —— HandlerAdapter 组件（三）之 HandlerMethodArgumentResolver》 。
<2>方法，调用#doInvoke(Object... args)方法，执行调用。代码如下：// InvocableHandlerMethod.java
protected Object doInvoke(Object... args) throws Exception {
// 设置方法为可访问
ReflectionUtils.makeAccessible(getBridgedMethod());
try {
// 执行调用
return getBridgedMethod().invoke(getBean(), args);
} catch (IllegalArgumentException ex) {
assertTargetBean(getBridgedMethod(), getBean(), args);
String text = (ex.getMessage() != null ? ex.getMessage() : "Illegal argument");
throw new IllegalStateException(formatInvokeError(text, args), ex);
} catch (InvocationTargetException ex) {
// Unwrap for HandlerExceptionResolvers ...
Throwable targetException = ex.getTargetException();
if (targetException instanceof RuntimeException) {
throw (RuntimeException) targetException;
} else if (targetException instanceof Error) {
throw (Error) targetException;
} else if (targetException instanceof Exception) {
throw (Exception) targetException;
} else {
throw new IllegalStateException(formatInvokeError("Invocation failure", args), targetException);
}
}
}- 通过反射方法，调用对应的方法。那么，为什么是 Bridged Method 呢？感兴趣的胖友，可以看看 《Bridge Method (桥接方法)》 文章。有趣~
5. ServletInvocableHandlerMethod
org.springframework.web.servlet.mvc.method.annotation。ServletInvocableHandlerMethod ，继承 InvocableHandlerMethod 类，考虑 Servlet 的 InvocableHandlerMethod 实现类。😈 貌似这样翻译也很奇怪，直接开始看代码吧。
// ServletInvocableHandlerMethod.java |
5.1 构造方法
// ServletInvocableHandlerMethod.java |
returnValueHandlers属性的设置，通过 setting 方法。
5.2 invokeAndHandle
#invokeAndHandle(ServletWebRequest webRequest, ModelAndViewContainer mavContainer, Object... providedArgs) 方法，请求调用，并处理返回结果。代码如下：
// ServletInvocableHandlerMethod.java |
<1>处，调用父 InvocableHandlerMethod 类的#invokeForRequest(NativeWebRequest request, ModelAndViewContainer mavContainer, Object... providedArgs)方法，执行调用。在 「4.2 invokeForRequest」 中，已经详细解析。<2>处，调用#setResponseStatus(ServletWebRequest webRequest)设置响应的状态码。代码如下：// ServletInvocableHandlerMethod.java
/**
* Set the response status according to the {@link ResponseStatus} annotation.
*/
private void setResponseStatus(ServletWebRequest webRequest) throws IOException {
// 获得状态码。
// 此处，想要非空，需要通过 @ResponseStatus 注解方法
HttpStatus status = getResponseStatus();
if (status == null) { // 若为空，则返回
return;
}
// 设置响应的状态码
HttpServletResponse response = webRequest.getResponse();
if (response != null) {
String reason = getResponseStatusReason();
if (StringUtils.hasText(reason)) { // 有 reason ，则设置 status + reason
response.sendError(status.value(), reason);
} else { // 无 reason ，则仅设置 status
response.setStatus(status.value());
}
}
// To be picked up by RedirectView
// 为了 RedirectView ，所以进行设置
webRequest.getRequest().setAttribute(View.RESPONSE_STATUS_ATTRIBUTE, status);
}- 代码比较简单，胖友自己瞅瞅。主要和
@ResponseStatus注解有关。😈 估计，用过的胖友不太多，哈哈哈哈。艿艿也基本没用过。
- 代码比较简单，胖友自己瞅瞅。主要和
<3>处，设置 ModelAndViewContainer 为请求已处理，返回。具体的逻辑，胖友可以简单看看即可。因为，实际情况下，我们很少使用@ResponseStatus注解。<4>处，设置 ModelAndViewContainer 为请求未处理。<5>处，调用HandlerMethodReturnValueHandlerComposite#handleReturnValue(Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest)方法，处理返回值。详细解析，见 《精尽 Spring MVC 源码解析 —— HandlerAdapter 组件（四）之 HandlerMethodArgumentResolver》 。
6. ConcurrentResultHandlerMethod
TODO 1003 ASYNC 相关
666. 彩蛋
仔细一琢磨，还是先暂时本文。酱紫，就显得艿艿写了好多篇，胖友看完了好多篇。是不是很棒，哈哈哈哈。
参考和推荐如下文章：