WebDataBinder与HttpMessageConverter

HttpMessageConverter

HttpMessageConverter<T> 是 Spring3.0 新添加的一个接口，负责将请求信息转换为一个对象（类型为 T），将对象（类型为 T）输出为响应信息

// 指定转换器可以读取的对象类型，即转换器是否可将请求信息转换为 clazz 类型的对象，同时指定支持 MIME 类型(text/html,applaiction/json等)
Boolean canRead(Class<?> clazz,MediaType mediaType);
// 指定转换器是否可将 clazz 类型的对象写到响应流中，响应流支持的媒体类型在MediaType 中定义。
Boolean canWrite(Class<?> clazz,MediaType mediaType);
// 该转换器支持的媒体类型。
List<MediaType> getSupportMediaTypes();
// 将请求信息流转换为 T 类型的对象。
T read(Class<? extends T> clazz,HttpInputMessage inputMessage);
//将T类型的对象写到响应流中，同时指定相应的媒体类型为 contentType。
void write(T t,MediaType contnetType,HttpOutputMessgae outputMessage);

在这里插入图片描述

HttpInputMessage

/**
 * Represents an HTTP input message, consisting of {@linkplain     #getHeaders() headers}
 * and a readable {@linkplain #getBody() body}.
 */
public interface HttpInputMessage extends HttpMessage {

	/**
	 * Return the body of the message as an input stream.
	 * @return the input stream body (never {@code null})
	 * @throws IOException in case of I/O errors
	 */
	InputStream getBody() throws IOException;
}

根据注释我们能知道，其内部包含请求体和请求头的内容，这就意味着，HttpMessageConverter能解析请求头和请求行的内容，当然这还得看具体的HttpMessageConverter的实现了，大部分的HttpMessageConverter并没有从请求头中获取内容，都只是获取请求体的内容，比如FastJsonHttpMessageConverter

WebDataBinder

webDataBinder是继承自DataBinder的，DataBinder是Spring提供的，WebDataBinder是springmvc提供的。
它的作用就是从web request里把web请求的parameters绑定到JavaBean上

Controller方法的参数类型可以是基本类型，也可以是封装后的普通Java类型。若这个普通Java类型没有声明任何注解，则意味着它的每一个属性都需要到Request中去查找对应的请求参数，这种情况的参数解析是交给ModelAttributeMethodProcessor这个参数解析器来做的

/**
 * 从方法中可以看出，这个参数解析器是支持被@ModelAttribute注解标识的参数，或者是复杂类型对象，也就是普通的Java类型的对象
 */
@Override
public boolean supportsParameter(MethodParameter parameter) {
	return (parameter.hasParameterAnnotation(ModelAttribute.class) ||
			(this.annotationNotRequired && !BeanUtils.isSimpleProperty(parameter.getParameterType())));
}

DataBinder不仅完成数据的绑定，还会和数据校验，WebDataBinder是继承自DataBinder的，当然也就具有这些能力

WebDataBinder对父类进行了增强，提供的增强能力如下：

支持对属性名以_打头的默认值处理（自动挡，能够自动处理所有的Bool、Collection、Map等）
支持对属性名以!打头的默认值处理（手动档，需要手动给某个属性赋默认值，自己控制的灵活性很高）
提供方法，支持把MultipartFile绑定到JavaBean的属性上

具体的WebDataBinder和DataBinder，可以查看下面两个文章！
WebDataBinder
DataBinder

WebDataBinder和HttpMessageConverter

根据上面的叙述我们可能能看出来，WebDataBinder提供数据的绑定功能，可以将传递进来的属性值绑定到对象上，同时还可以进行一些类型转换。HttpMessageConverter也是提供了数据绑定功能，也具有类型转换的能力。那么springmvc在使用的时候，在什么时候，用哪一个呢？
首先HttpMessageConverter的能力其实是比WebDataBinder的能力更加强大的，因为其能自己去从HttpInputMessage中解析出对象需要的参数值进行绑定，但是WebDataBinder不行，其进行绑定的时候需要将对应的值传递给他。但是WebDataBinder又能进行数据效验。

SpringMVC在什么时候使用HttpMessageConverter什么时候使用WebDataBinder呢？
既然是根绑定有关的，那么他们俩一定在springmvc的参数解析器中有所使用。
springmvc的HandlerMethodArgumentResolver这个接口，是负责handler方法的参数解析的核心，其内部有这样一个方法。

// 这里面包含了一个参数WebDataBinderFactory
Object resolveArgument(MethodParameter parameter, @Nullable ModelAndViewContainer mavContainer,
		NativeWebRequest webRequest, @Nullable WebDataBinderFactory binderFactory) throws Exception;

从上面的WebDataBinderFactory类型的参数就能看出来，只要是参数解析的类，都会使用到WebDataBinder
那么HttpMessageConverter呢？
AbstractMessageConverterMethodArgumentResolver这个类，从名字就能看出其与HttpMessageConverter密不可分，这个类中有这样一个方法

/**
 * 这个类的一个官方描述
 * A base class for resolving method argument values by reading from the body of
 * a request with {@link HttpMessageConverter HttpMessageConverters}.
 */

// 该类的一个属性
protected final List<HttpMessageConverter<?>> messageConverters;

@Nullable
protected <T> Object readWithMessageConverters(NativeWebRequest webRequest, MethodParameter parameter,
		Type paramType) throws IOException, HttpMediaTypeNotSupportedException, HttpMessageNotReadableException {

	HttpInputMessage inputMessage = createInputMessage(webRequest);
	return readWithMessageConverters(inputMessage, parameter, paramType);
}

根据他的名字我们就能看出，其肯定是使用了HttpMessageConverter的。AbstractMessageConverterMethodArgumentResolver这个类抽象类也是HandlerMethodArgumentResolver的直接实现类。
在这里插入图片描述
这就能看出来哪些类使用了HttpMessageConverter了
其中的RequestResponseBodyMethodProcessor是一个常用的类，查看其supportsParameter方法

// 其负责解析被@RequestBody注解标识的参数
@Override
public boolean supportsParameter(MethodParameter parameter) {
	return parameter.hasParameterAnnotation(RequestBody.class);
}

json格式的数据就是由RequestResponseBodyMethodProcessor这个参数解析器交给HttpMessageConverter解析出来的，然后叫给了WebDataBInder进行数据效验。

由上述我们就能知道，WebDataBinder基本是所有的参数解析器都会使用，而HttpMessageConverter只是在几个特殊的类中使用

P19777

发布了180 篇原创文章 · 获赞 49 · 访问量 1万+

私信关注