3.13 @RequestBody注解

org.springframework.web.bind.annotation.RequestBody注解常用来处理ContentType不是application/x-ww-form-urlencoded编码的内容,例如application/json,application/等。@RequestBody注解通过使用HandlerAdapter配置的HttpMessageConverters来解析JSON或xml数据,然后绑定到相应的Bean上。

3.13.1 HttpMessageConverter接口

HttpMessageConverter<T>是Spring3.0之后新增的一个重要接口,它负责将请求信息转换为一个对象(类型为T),并将对象(类型为T)绑定到请求方法的参数上或输出为响应信息。
DispatcherServlet默认已经装配了RequestMappingHandlerAdapter作为HandlerAdapter组件的实现类,即HttpMessageConverter由RequestMappingHandlerAdapter使用,将请求信息转换为对象,或将对象转换为响应信息。

HttpMessageConverter接口方法

HttpMessageConverter<T>接口中定义了以下几个方法

方法	描述
`boolean canRead(Class<?>clazz,MediaType mediaType)`	该方法指定转换器可以读取的对象类型,即转换器可将请求信息转换为`clazz`类型的对象,同时指定支持的`MIME`类型(`text/html`、`application/json`等)。`MIME`媒体类型在`RFC2616`中定义,具体请参考`http://tools.ietf.org/html/rfc2616`＃`section-3.7`上的说明。
`boolean canWrite(Class<?>clazz,MediaType mediaType)`	该方法指定转换器可以将`clazz`类型的对象写到响应流当中,响应流支持的媒体类型在`mediaType`中定义。
`List<MediaType> getSupportedMediaTypes()`	该方法返回当前转换器支持的媒体类型。
`T read(Class<?extendsT> clazz,HttpInputMessage inputMessage)`	该方法将请求信息流转换为T类型的对象
`void write(T t,MediaType contentType,HttpOutputMessage outputMessage)`	该方法将T类型的对象写到响应流当中,同时指定响应的媒体类型为`contentType`。

Spring提供的HttpMessageConverter接口实现类

Spring为HttpMessageConverter<T>提供了多个实现类,这些实现类组成了一个功能强大、用途广泛的信息转换家族。详细说明如下:

实现类	描述
`StringHttpMessageConverter`	将请求信息转换为字符串,泛型T为`String`类型,可以读取所有媒体类型（/）的请求信息，可通过设置`supportedMediaTypes`属性指定媒体类型。响应信息的媒体类型为`text/plain`（即`Content-Type`的值）。
`FormHttpMessageConverter`	将表单数据读取到`MultiValueMap`中,泛型T为`org.springframework.util.MultiValueMap<String,?>`类型,支持读取`application/x-www-form-urlencoded`类型的信息,但不支持读取`multipart/form-data`类型的信息。可以写`application/x-www-form-urlencoded`及`multipart/form-data`类型的响应信息。
`SourceHttpMessageConverter`	如果部分表单属性是`XML`数据，则可用该转换器进行转换。
`ResourceHttpMessageConverter`	读写`org.springframework.core.io.Resource`对象,泛型T为`org.springframework.core.io.Resource`对象,可以读取所有媒体类型（/）的请求信息。如果类路径下提供了`JAF`（`JavaActivationFramework`）,则根据`Resource`的类型指定响应的类型，否则响应的类型为`application/octet-stream`。
`BufferedImageHttpMessageConverter`	读写`BufferedImage`对象,泛型T为`BufferedImage`对象,可以读取所有类型（/）的请求信息，返回`BufferedImage`相应的类型，也可以通过`contentType`显式指定。
`ByteArrayHttpMessageConverter`	读写二进制数据,泛型T为`byte`[]类型,可以读取所有类型（/）的请求信息，可以通过设置`supportMediaTypes`属性指定类型，响应信息的媒体类型为`application/octet-stream`。
`SourceHttpMessageConverter`	读写`javax.xml.transform.Source`类型的数据,泛型T为`javax.xml.transform.Source`类型及其扩展类型包括`javax.xml.transform.dom.DOMSource`、`javax.xml.transform.sax.SAXSource`及`javax.xml.transform.stream.StreamSource`;可以读取`text/xml`和`application/xml`类型请求，响应信息的类型为`text/xml`和`application/xml`。
`MarshallingHttpMessageConverter`	通过`Spring`的`org.springframework.oxm.Marshalling`（将`Java`对象转换成`XML`）和`Unmarshaller`（将`XML`解析为`Java`对象）读写`XML`消息。泛型T为`Object`类型;可以读取`text/xml`和`application/xml`类型请求，响应信息的类型为`text/xml`和`application/xml`。
`Jaxb2RootElementHttpMessageConverter`	通过`JAXB2`读写`XML`消息，将请求消息转换到注解`@XmlRootElement`和`XmlType`作用的类中。泛型T为`Object`类型;可以读取`text/xml`和`application/xml`类型请求，响应信息的类型为`text/xml`和`application/xml`。
`MappingJackson2HttpMessageConverter`	利用`Jackson`开源类包读写`JSON`数据。泛型T为`Object`类型;可以读取`application/json`类型的数据，响应信息的类型为`application/json`。
`RssChannelHttpMessageConverter`	能够读写`RSS`种子消息;泛型T为`com.sun.syndication.feed.rss.Channel`类型;可以读取`application/rss+xml`类型的数据，响应信息的类型为`application/rss+xml`。
`AtomFeedHttpMessageConverter`	能够读写`RSS`种子消息。泛型T为`com.sun.syndication.feed.atom.Feed`类型;可以读取`application/atom+xml`类型的数据，响应信息的类型为`application/atom+xml`。

默认装配的HandlerAdapter实现类

DispatcherServlet默认已经装配了RequestMappingHandlerAdapter作为HandlerAdapter组件的实现类;RequestMappingHandlerAdapter默认已经装配了以下的HttpMessageConverter:

StringHttpMessageConverter
ByteArrayHttpMessageConverter
SourceHttpMessageConverter

自定义RequestMappingHandlerAdapter

如果需要装配其他类型的HttpMessageConverter,则可以在Spring的Web容器的上下文中自定义一个RequestMappingHandlerAdapter,如下所示:

1	这里有代码,我懒得抄,有空再贴上吧

提示如果在Spring Web容器中显式定义了一个RequestMappingHandlerAdapter,则Spring MVC的RequestMappingHandlerAdapter默认装配的HttpMessageConverter将不再起作用。

原文链接: 3.13 @RequestBody注解 3.13.1 HttpMessageConverter接口