一个事实是:对于大多数技术,了解只需要一天,简单搞起来只需要一周。入门可能只需要一个月
前言通过 前面两篇文章 的介绍,相信你对HandlerMethodArgumentResolver了解已经很深刻了。但是你或许和我一样还有一种感觉,似乎还缺点什么:
我们使用非常频繁的@RequestBody是怎么封装请求体的呢???这块使用非常广泛的地方却还木有讲解到,因为它的处理方式和前面的不太一样,因此单摘出来到本文进行详细描述。
利用HttpMessageConverter将输入流转换成对应的参数
这类参数解析器的基类是AbstractMessageConverterMethodArgumentResolver:
// @since 3.1 public abstract class AbstractMessageConverterMethodArgumentResolver implements HandlerMethodArgumentResolver { // 默认支持的方法(没有Deleted方法) // httpMethod为null 或者方法不属于这集中 或者没有contendType且没有body 那就返回null // 也就是说如果是Deleted请求,即使body里有值也是返回null的。(因为它不是SUPPORTED_METHODS ) private static final Set<HttpMethod> SUPPORTED_METHODS = EnumSet.of(HttpMethod.POST, HttpMethod.PUT, HttpMethod.PATCH); private static final Object NO_VALUE = new Object(); protected final List<HttpMessageConverter<?>> messageConverters; protected final List<MediaType> allSupportedMediaTypes; // 和RequestBodyAdvice和ResponseBodyAdvice有关的 private final RequestResponseBodyAdviceChain advice; // 构造函数里指定HttpMessageConverter // 此一个参数的构造函数木人调用 public AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters) { this(converters, null); } // @since 4.2 public AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters, @Nullable List<Object> requestResponseBodyAdvice) { Assert.notEmpty(converters, "'messageConverters' must not be empty"); this.messageConverters = converters; // 它会把所有的消息转换器里支持的MediaType都全部拿出来汇聚起来~ this.allSupportedMediaTypes = getAllSupportedMediaTypes(converters); this.advice = new RequestResponseBodyAdviceChain(requestResponseBodyAdvice); } // 提供一个defualt方法访问 RequestResponseBodyAdviceChain getAdvice() { return this.advice; } // 子类RequestResponseBodyMethodProcessor有复写此方法 @Nullable protected <T> Object readWithMessageConverters(NativeWebRequest webRequest, MethodParameter parameter, Type paramType) throws IOException, HttpMediaTypeNotSupportedException, HttpMessageNotReadableException { HttpInputMessage inputMessage = createInputMessage(webRequest); return readWithMessageConverters(inputMessage, parameter, paramType); } ... }说明:此抽象类并没有实现resolveArgument()这个接口方法,而只是提供了一些protected方法,作为工具方法给子类调用,比如最为重要的这个方法:readWithMessageConverters()就是利用消息转换器解析HttpInputMessage的核心。
关于此抽象类的描述,可以看 这里,HttpMessageConverter匹配规则
它的继承树如下:
它用于解析参数被@RequestPart修饰,或者参数类型是MultipartFile | Servlet 3.0提供的javax.servlet.http.Part类型(并且没有被@RequestParam修饰),数据通过 HttpServletRequest获取
当属性被标注为@RequestPart的话,那就会经过HttpMessageConverter结合Content-Type来解析,这个效果特别像@RequestBody的处理方式~
// @since 3.1 @Target(ElementType.PARAMETER) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface RequestPart { @AliasFor("name") String value() default ""; @AliasFor("value") String name() default ""; boolean required() default true; } // @since 3.1 public class RequestPartMethodArgumentResolver extends AbstractMessageConverterMethodArgumentResolver { // 标注了@RequestPart注解的 // 没有标注@RequestPart并且也没有标注@RequestParam,但是是Multipart类型的也会处理 @Override public boolean supportsParameter(MethodParameter parameter) { if (parameter.hasParameterAnnotation(RequestPart.class)) { return true; } else { if (parameter.hasParameterAnnotation(RequestParam.class)) { return false; } return MultipartResolutionDelegate.isMultipartArgument(parameter.nestedIfOptional()); } } @Override @Nullable public Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer, NativeWebRequest request, @Nullable WebDataBinderFactory binderFactory) throws Exception { HttpServletRequest servletRequest = request.getNativeRequest(HttpServletRequest.class); Assert.state(servletRequest != null, "No HttpServletRequest"); RequestPart requestPart = parameter.getParameterAnnotation(RequestPart.class); boolean isRequired = ((requestPart == null || requestPart.required()) && !parameter.isOptional()); // 如果注解没有指定,就取形参名 String name = getPartName(parameter, requestPart); parameter = parameter.nestedIfOptional(); Object arg = null; // resolveMultipartArgument这个方法只处理: // MultipartFile类型以及对应的数组/集合类型 // Part类型以及对应的数组集合类型 // 若形参类型不是以上类型,返回UNRESOLVABLE(空对象) // 最终返回StandardMultipartHttpServletRequest/request.getParts()[0]等~ Object mpArg = MultipartResolutionDelegate.resolveMultipartArgument(name, parameter, servletRequest); if (mpArg != MultipartResolutionDelegate.UNRESOLVABLE) { arg = mpArg; // 是part类型,那就直接赋值吧 } else { // 其它类型 ... } ... } }