1、完整的请求过程
- 上述是SpringMVC完整的请求过程,经过三次TCP/IP的握手之后来到请求。而请求参数的解析主要是在第5、6步完成的。
- 前面几个步骤的过程可以参考这里,下面主要介绍请求参数是如何解析获得的。
2、DispatcherServlet整体调度
public class DispatcherServlet extends FrameworkServlet {
@Override
protected void doService(HttpServletRequest request, HttpServletResponse response) throws Exception {
...
try {
doDispatch(request, response);
}
finally {
...
}
}
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
HttpServletRequest processedRequest = request;
HandlerExecutionChain mappedHandler = null;
boolean multipartRequestParsed = false; //判断是否是文件上传
try {
ModelAndView mv = null; //响应的视图
Exception dispatchException = null;
try {
// 1. 检查是否是文件上传
processedRequest = checkMultipart(request);
multipartRequestParsed = (processedRequest != request);
// 2. 找到映射器处理器MappingHandler
mappedHandler = getHandler(processedRequest);
if (mappedHandler == null) {
noHandlerFound(processedRequest, response);
return;
}
// 3. 找到处理器的适配器
HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
// 4. 拦截器的前置PreHandle方法执行
if (!mappedHandler.applyPreHandle(processedRequest, response)) {
return;
}
// 5. 获取参数、执行controller
mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
// 6. 使用默认的视图名进行封装(首页)
applyDefaultViewName(processedRequest, mv);
// 7. 执行拦截器的后置postHandle方法
mappedHandler.applyPostHandle(processedRequest, response, mv);
// 8. 对执行结果的参数、视图,内部执行拦截器的afterCompletion方法
processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
}
...
...
}
- 前面几个步骤没啥用,主要是第(2)步找到Controller.Method方法
- 然后开始为这个Method方法找到合适的适配器进行处理,SpringBoot一启动就自动配置了5个映射器,4个适配器。
- 最后参数解析、Controller.Method的执行都在第(5)步完成。
3、RequestMappingHandlerAdapter适配器先行一步
这里需要注意适配器是不唯一的,但是他们都是AbstractHandlerMethodAdapter抽象类的实现,这里以@RequestMapping标注的方法为事例。
public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter
implements BeanFactoryAware, InitializingBean {
protected ModelAndView handleInternal(HttpServletRequest request,
HttpServletResponse response, HandlerMethod handlerMethod) throws Exception {
ModelAndView mav;
checkRequest(request);
// Execute invokeHandlerMethod in synchronized block if required.
if (this.synchronizeOnSession) {
HttpSession session = request.getSession(false);
if (session != null) {
Object mutex = WebUtils.getSessionMutex(session);
synchronized (mutex) {
mav = invokeHandlerMethod(request, response, handlerMethod);
}
}
else {
// No HttpSession available -> no mutex necessary
mav = invokeHandlerMethod(request, response, handlerMethod);
}
}
else {
// No synchronization on session demanded at all...
mav = invokeHandlerMethod(request, response, handlerMethod);
}
....
return mav;
}
@Nullable
protected ModelAndView invokeHandlerMethod(HttpServletRequest request,
HttpServletResponse response, HandlerMethod handlerMethod) throws Exception {
ServletWebRequest webRequest = new ServletWebRequest(request, response);
try {
...
// 1. 创建一个请求 - 处理对象
ServletInvocableHandlerMethod invocableMethod = createInvocableHandlerMethod(handlerMethod);
// 2. 设置参数解析器(核心)
if (this.argumentResolvers != null) {
invocableMethod.setHandlerMethodArgumentResolvers(this.argumentResolvers);
}
// 3. 设置返回值处理器(Model、ModelAndView、@ResponseBody等等)
if (this.returnValueHandlers != null) {
invocableMethod.setHandlerMethodReturnValueHandlers(this.returnValueHandlers);
}
// 这里还有一系列的初始化东西,在这里省略。
...
// 4. 执行和处理。
invocableMethod.invokeAndHandle(webRequest, mavContainer);
if (asyncManager.isConcurrentHandlingStarted()) {
return null;
}
return getModelAndView(mavContainer, modelFactory, webRequest);
}
finally {
webRequest.requestCompleted();
}
}
}
- 可以看到核心方法invokeHandlerMethod就是这个,但是这里经过了一系列的针对Session有效的验证。
- 到这里还没有进行参数的解析,只是配置了默认情况下所有的参数解析器(27个左右)和 返回值处理器(15个左右)
- 中间还有一系列的东西需要配置、初始化等等,最后再交给invokeAndHandle(webRequest, mavContainer)方法去完成处理。
4、ServletInvocableHandlerMethod
public class ServletInvocableHandlerMethod extends InvocableHandlerMethod {
public void invokeAndHandle(ServletWebRequest webRequest, ModelAndViewContainer mavContainer,Object... providedArgs) throws Exception {
// 1. 获取返回值
Object returnValue = invokeForRequest(webRequest, mavContainer, providedArgs);
// 2. 设置响应状态
setResponseStatus(webRequest);
}
}
- 可以看到第(2)步已经开始进行响应状态的设置,所以可以猜到到这里请求已经结束了但是没有响应。
- 根据上面的推测,那么参数解析、执行都藏匿在invokeForRequest()方法中。
5、InvocableHandlerMethod
public class InvocableHandlerMethod extends HandlerMethod {
@Nullable
public Object invokeForRequest(NativeWebRequest request, @Nullable ModelAndViewContainer mavContainer,
Object... providedArgs) throws Exception {
Object[] args = getMethodArgumentValues(request, mavContainer, providedArgs);
if (logger.isTraceEnabled()) {
logger.trace("Arguments: " + Arrays.toString(args));
}
return doInvoke(args);
}
}
// 最终幕后
protected Object[] getMethodArgumentValues(NativeWebRequest request, @Nullable ModelAndViewContainer mavContainer,
Object... providedArgs) throws Exception {
// 1. 先获取到所有的参数
MethodParameter[] parameters = getMethodParameters();
if (ObjectUtils.isEmpty(parameters)) {
return EMPTY_ARGS;
}
Object[] args = new Object[parameters.length];
for (int i = 0; i < parameters.length; i++) {
MethodParameter parameter = parameters[i];
parameter.initParameterNameDiscovery(this.parameterNameDiscoverer);
args[i] = findProvidedArgument(parameter, providedArgs);
if (args[i] != null) {
continue;
}
if (!this.resolvers.supportsParameter(parameter)) {
throw new IllegalStateException(formatArgumentError(parameter, "No suitable resolver"));
}
try {
args[i] = this.resolvers.resolveArgument(parameter, mavContainer, request, this.dataBinderFactory);
}
catch (Exception ex) {
...
}
}
return args;
}
- 这里好像也没有看到什么实质性的东西,只有getMethodArgumentValues()方法。
- 而所有的东西最后都在这个方法里面可以看到。
5.1、请求样例
首先给出如下的请求样例,便于Debug参数是如何解析出来的。
<a href="/param?username=admin&password=123456">测试@RequestParam</a>
<br/><br/>
@RequestMapping("/param")
@ResponseBody
public Map<String, Object> RequestParamTest(@RequestParam("username") String name,
@RequestParam("password") String pwd,
@RequestParam Map<String,String> m){
Map<String,Object> map = new HashMap<>();
map.put("name", name);
map.put("pwd", pwd);
map.put("allParam", m);
return map;
}
5.2、获取形参名字
// 1. 先获取到所有的参数
MethodParameter[] parameters = getMethodParameters();
if (ObjectUtils.isEmpty(parameters)) {
return EMPTY_ARGS;
}
- 这里获取所有参数的名字,并且存放在一个数组里面,后面需要使用到。
- 如果是没有参数的请求,那么会直接返回空参数EMPTY_ARGS。
5.3、为参数分配空间并初始化
Object[] args = new Object[parameters.length];
for (int i = 0; i < parameters.length; i++) {
MethodParameter parameter = parameters[i];
parameter.initParameterNameDiscovery(this.parameterNameDiscoverer);
args[i] = findProvidedArgument(parameter, providedArgs);
if (args[i] != null) {
continue;
}
...
}
- 先为每个参数值分配一个Object对象,多个参数值就形成一个数组。
- 先初始化参数名字的发现器、找到供应参数之类的东西。
5.4、参数解析器的适配支持
if (!this.resolvers.supportsParameter(parameter)) {
throw new IllegalStateException(formatArgumentError(parameter, "No suitable resolver"));
}
这里主要检查第(3)步中提供的27个resolvers解析器是否有满足解析当前参数的。
- 如果没有将会抛出异常。直接结束请求。
- 如果存在会先将适配的参数解析器丢入第(3)步中提到的解析器缓存,这样便于下次使用的时候取,而不是每次都增强for循环每次都去适配一次。
public class HandlerMethodArgumentResolverComposite implements HandlerMethodArgumentResolver {
@Nullable
private HandlerMethodArgumentResolver getArgumentResolver(MethodParameter parameter) {
// 1. 如果缓存中有直接获取
HandlerMethodArgumentResolver result = this.argumentResolverCache.get(parameter);
// 2. 如果没有,增强for循环去适配。
if (result == null) {
for (HandlerMethodArgumentResolver resolver : this.argumentResolvers) {
if (resolver.supportsParameter(parameter)) {
result = resolver;
this.argumentResolverCache.put(parameter, result);
break;
}
}
}
return result;
}
}
判断是否是当前参数的解析器很简单:
- 前面几步已经说明注解开始生效了,那么判断的时候直接根据注解类型与当前参数解析器提供的注解是否一致,以及参数类型是否匹配的问题。
- 注:这里的参数类型匹配主要是区分Map和非Map参数,对于Map参数提供了单独的参数解析器。
5.5、开始解析
public class HandlerMethodArgumentResolverComposite implements HandlerMethodArgumentResolver {
@Override
@Nullable
public Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {
// 缓存里面直接获取
HandlerMethodArgumentResolver resolver = getArgumentResolver(parameter);
if (resolver == null) {
throw new IllegalArgumentException("Unsupported parameter type [" +
parameter.getParameterType().getName() + "]. supportsParameter should be called first.");
}
return resolver.resolveArgument(parameter, mavContainer, webRequest, binderFactory);
}
}
5.6、解析并赋值
public abstract class AbstractNamedValueMethodArgumentResolver implements HandlerMethodArgumentResolver {
@Override
@Nullable
public final Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception {
// 1. 参数名信息
NamedValueInfo namedValueInfo = getNamedValueInfo(parameter);
MethodParameter nestedParameter = parameter.nestedIfOptional();
Object resolvedName = resolveEmbeddedValuesAndExpressions(namedValueInfo.name);
if (resolvedName == null) {
throw new IllegalArgumentException(
"Specified name must not resolve to null: [" + namedValueInfo.name + "]");
}
// 2. 参数值
Object arg = resolveName(resolvedName.toString(), nestedParameter, webRequest);
if (arg == null) {
if (namedValueInfo.defaultValue != null) {
arg = resolveEmbeddedValuesAndExpressions(namedValueInfo.defaultValue);
}
else if (namedValueInfo.required && !nestedParameter.isOptional()) {
handleMissingValue(namedValueInfo.name, nestedParameter, webRequest);
}
arg = handleNullValue(namedValueInfo.name, arg, nestedParameter.getNestedParameterType());
}
else if ("".equals(arg) && namedValueInfo.defaultValue != null) {
arg = resolveEmbeddedValuesAndExpressions(namedValueInfo.defaultValue);
}
...
handleResolvedValue(arg, namedValueInfo.name, parameter, mavContainer, webRequest);
return arg;
}
}
- 先解析出请求URL中的名字,并且验证名字的合法性之类的。
- 解析参数的值,如果没有解析到根据注解是否有提供默认的值…
- 最后每个参数都这样解析出来,全部解析出来之后走到第(4)步,最后给出响应!
6、原生Servlet参数解析
原生的Servlet参数解析也是一样的,只不过解析器不同。所有的解析器大概分成以下几类:
- 注解参数还是Servlet API的解析器。
- 注解的参数解析器又分为map类型参数、非map类型参数。
- Servlet API的大部分都是由一个参数解析器ServletRequestMethodArgumentResolver类进行解析的。
public class ServletRequestMethodArgumentResolver implements HandlerMethodArgumentResolver {
@Override
public boolean supportsParameter(MethodParameter parameter) {
Class<?> paramType = parameter.getParameterType();
return (WebRequest.class.isAssignableFrom(paramType) ||
ServletRequest.class.isAssignableFrom(paramType) ||
MultipartRequest.class.isAssignableFrom(paramType) ||
HttpSession.class.isAssignableFrom(paramType) ||
(pushBuilder != null && pushBuilder.isAssignableFrom(paramType)) ||
(Principal.class.isAssignableFrom(paramType) && !parameter.hasParameterAnnotations()) ||
InputStream.class.isAssignableFrom(paramType) ||
Reader.class.isAssignableFrom(paramType) ||
HttpMethod.class == paramType ||
Locale.class == paramType ||
TimeZone.class == paramType ||
ZoneId.class == paramType);
}
}