HttpMessageConverter

1.@RestController和@Controller，@RestController = @Controller + @ResponseBody

2.@RequestMapping(mehtod="",value="")用于指定类和方法路径映射

RequestMapping注解有六个属性，下面咱们把她分红三类进行说明。

一、 value， method；

value： 指定请求的实际地址，指定的地址能够是URI Template 模式（后面将会说明）；

method： 指定请求的method类型， GET、POST、PUT、DELETE等；

二、 consumes，produces；

consumes： 指定处理请求的提交内容类型（Content-Type），例如application/json, text/html;

produces: 指定返回的内容类型，仅当request请求头中的(Accept)类型中包含该指定类型才返回；

三、 params，headers；

params： 指定request中必须包含某些参数值是，才让该方法处理。

headers： 指定request中必须包含某些指定的header值，才能让该方法处理请求

3.@ResponseBody

做用：
该注解用于将Controller的方法返回的对象，经过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区,即写入HttpEntity的body中。

在SpringMVC中，可使用@RequestBody和@ResponseBody两个注解，分别完成请求报文到对象和对象到响应报文的转换，底层这种灵活的消息转换机制，就是Spring3.x中新引入的HttpMessageConverter即消息转换器机制。

#Http请求的抽象 仍是回到请求-响应，也就是解析请求体，而后返回响应报文这个最基本的Http请求过程当中来。咱们知道，在servlet标准中，能够用javax.servlet.ServletRequest接口中的如下方法：

public ServletInputStream getInputStream() throws IOException; 
复制代码

来获得一个ServletInputStream。这个ServletInputStream中，能够读取到一个原始请求报文的全部内容。一样的，在javax.servlet.ServletResponse接口中，能够用如下方法：

public ServletOutputStream getOutputStream() throws IOException;
复制代码

来获得一个ServletOutputStream，这个ServletOutputSteam，继承自java中的OutputStream，可让你输出Http的响应报文内容。

让咱们尝试着像SpringMVC的设计者同样来思考一下。咱们知道，Http请求和响应报文本质上都是一串字符串，当请求报文来到java世界，它会被封装成为一个ServletInputStream的输入流，供咱们读取报文。响应报文则是经过一个ServletOutputStream的输出流，来输出响应报文。

咱们从流中，只能读取到原始的字符串报文，一样，咱们往输出流中，也只能写原始的字符。而在java世界中，处理业务逻辑，都是以一个个有业务意义的对象为处理维度的，那么在报文到达SpringMVC和从SpringMVC出去，都存在一个字符串到java对象的阻抗问题。这一过程，不可能由开发者手工转换。咱们知道，在Struts2中，采用了OGNL来应对这个问题，而在SpringMVC中，它是HttpMessageConverter机制。咱们先来看两个接口。

#HttpInputMessage 这个类是SpringMVC内部对一次Http请求报文的抽象，在HttpMessageConverter的read()方法中，有一个HttpInputMessage的形参，它正是SpringMVC的消息转换器所做用的受体“请求消息”的内部抽象，消息转换器从“请求消息”中按照规则提取消息，转换为方法形参中声明的对象。

package org.springframework.http;

import java.io.IOException;
import java.io.InputStream;

public interface HttpInputMessage extends HttpMessage {

	InputStream getBody() throws IOException;

}
复制代码

#HttpOutputMessage 这个类是SpringMVC内部对一次Http响应报文的抽象，在HttpMessageConverter的write()方法中，有一个HttpOutputMessage的形参，它正是SpringMVC的消息转换器所做用的受体“响应消息”的内部抽象，消息转换器将“响应消息”按照必定的规则写到响应报文中。

package org.springframework.http;

import java.io.IOException;
import java.io.OutputStream;

public interface HttpOutputMessage extends HttpMessage {

	OutputStream getBody() throws IOException;

}
复制代码

#HttpMessageConverter 对消息转换器最高层次的接口抽象，描述了一个消息转换器的通常特征，咱们能够从这个接口中定义的方法，来领悟Spring3.x的设计者对这一机制的思考过程。

package org.springframework.http.converter;

import java.io.IOException;
import java.util.List;

import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;

public interface HttpMessageConverter<T> {

	boolean canRead(Class<?> clazz, MediaType mediaType);

	boolean canWrite(Class<?> clazz, MediaType mediaType);

	List<MediaType> getSupportedMediaTypes();

	T read(Class<? extends T> clazz, HttpInputMessage inputMessage)
			throws IOException, HttpMessageNotReadableException;

	void write(T t, MediaType contentType, HttpOutputMessage outputMessage)
			throws IOException, HttpMessageNotWritableException;

}
复制代码

HttpMessageConverter接口的定义出现了成对的canRead()，read()和canWrite()，write()方法，MediaType是对请求的Media Type属性的封装。举个例子，当咱们声明了下面这个处理方法。

@RequestMapping(value="/string", method=RequestMethod.POST)
public @ResponseBody String readString(@RequestBody String string) {
    return "Read string '" + string + "'";
}
复制代码

在SpringMVC进入readString方法前，会根据@RequestBody注解选择适当的HttpMessageConverter实现类来将请求参数解析到string变量中，具体来讲是使用了StringHttpMessageConverter类，它的canRead()方法返回true，而后它的read()方法会从请求中读出请求参数，绑定到readString()方法的string变量中。

当SpringMVC执行readString方法后，因为返回值标识了@ResponseBody，SpringMVC将使用StringHttpMessageConverter的write()方法，将结果做为String值写入响应报文，固然，此时canWrite()方法返回true。

咱们能够用下面的图，简单描述一下这个过程。

#RequestResponseBodyMethodProcessor 将上述过程集中描述的一个类是org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyMethodProcessor，这个类同时实现了HandlerMethodArgumentResolver和HandlerMethodReturnValueHandler两个接口。前者是将请求报文绑定处处理方法形参的策略接口，后者则是对处理方法返回值进行处理的策略接口。两个接口的源码以下：

package org.springframework.web.method.support;

import org.springframework.core.MethodParameter;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.support.WebDataBinderFactory;
import org.springframework.web.context.request.NativeWebRequest;

public interface HandlerMethodArgumentResolver {

	boolean supportsParameter(MethodParameter parameter);

	Object resolveArgument(MethodParameter parameter,
						   ModelAndViewContainer mavContainer,
						   NativeWebRequest webRequest,
						   WebDataBinderFactory binderFactory) throws Exception;

}

package org.springframework.web.method.support;

import org.springframework.core.MethodParameter;
import org.springframework.web.context.request.NativeWebRequest;

public interface HandlerMethodReturnValueHandler {

	boolean supportsReturnType(MethodParameter returnType);

	void handleReturnValue(Object returnValue,
						   MethodParameter returnType,
						   ModelAndViewContainer mavContainer,
						   NativeWebRequest webRequest) throws Exception;

}
复制代码

RequestResponseBodyMethodProcessor这个类，同时充当了方法参数解析和返回值处理两种角色。咱们从它的源码中，能够找到上面两个接口的方法实现。

对HandlerMethodArgumentResolver接口的实现：

public boolean supportsParameter(MethodParameter parameter) {
	return parameter.hasParameterAnnotation(RequestBody.class);
}

public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
		NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {

	Object argument = readWithMessageConverters(webRequest, parameter, parameter.getGenericParameterType());

	String name = Conventions.getVariableNameForParameter(parameter);
	WebDataBinder binder = binderFactory.createBinder(webRequest, argument, name);

	if (argument != null) {
		validate(binder, parameter);
	}

	mavContainer.addAttribute(BindingResult.MODEL_KEY_PREFIX + name, binder.getBindingResult());

	return argument;
}
复制代码

对HandlerMethodReturnValueHandler接口的实现

public boolean supportsReturnType(MethodParameter returnType) {
	return returnType.getMethodAnnotation(ResponseBody.class) != null;
}

	public void handleReturnValue(Object returnValue, MethodParameter returnType,
		ModelAndViewContainer mavContainer, NativeWebRequest webRequest)
		throws IOException, HttpMediaTypeNotAcceptableException {

	mavContainer.setRequestHandled(true);
	if (returnValue != null) {
		writeWithMessageConverters(returnValue, returnType, webRequest);
	}
}
复制代码

看完上面的代码，整个HttpMessageConverter消息转换的脉络已经很是清晰。由于两个接口的实现，分别是以是否有@RequestBody和@ResponseBody为条件，而后分别调用HttpMessageConverter来进行消息的读写。

若是你想问，怎么样跟踪到RequestResponseBodyMethodProcessor中，请你按照前面几篇博文的思路，而后到这里spring-mvc-showcase下载源码回来，对其中HttpMessageConverter相关的例子进行debug，只要你肯下功夫，相信你必定会有属于本身的收获的。

#思考 张小龙在谈微信的本质时候说：“微信只是个平台，消息在其中流转”。在咱们对SpringMVC源码分析的过程当中，咱们能够从HttpMessageConverter机制中领悟到相似的道理。在SpringMVC的设计者眼中，一次请求报文和一次响应报文，分别被抽象为一个请求消息HttpInputMessage和一个响应消息HttpOutputMessage。

处理请求时，由合适的消息转换器将请求报文绑定为方法中的形参对象，在这里，同一个对象就有可能出现多种不一样的消息形式，好比json和xml。一样，当响应请求时，方法的返回值也一样可能被返回为不一样的消息形式，好比json和xml。

在SpringMVC中，针对不一样的消息形式，咱们有不一样的HttpMessageConverter实现类来处理各类消息形式。可是，只要这些消息所蕴含的“有效信息”是一致的，那么各类不一样的消息转换器，都会生成一样的转换结果。至于各类消息间解析细节的不一样，就被屏蔽在不一样的HttpMessageConverter实现类中了

一、HttpMessageConverter信息

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

　　　　

二、HttpMessageConverter 运行原理

（1）HttpInputMessage 将请求的信息先转为 InputStream 对象，InputStream 再由 HttpMessageConverter 转换为 SpringMVC 须要的java对象；

（2）SpringMVC 返回一个 java 对象， 并经过 HttpMessageConverter 转为响应信息，接着 HttpOutputMessage 将响应的信息转换为 OutputStream，接着给出响应。

三、 HttpMessageConveter 的实现类

四、 SpringMVC 默认加载的 HttpMessageConverter 实现类

（1）DispatcherServlet 默认加载 HttpMessageConveter 的6个实现类，以下所示：

（2）加入 jackson jar包后，启动的时候加载 7个 HttpMessageConverter 的实现类，以下所示:

五、使用 HttpMessageConverter

（1） @ResponseBody 和 @RequestBody 示例：

（2） HttpEntity 和 ResponseEntity 示例

实现自定义的消息转换器要实现AbstractHttpMessageConverter