在SpringMvc中,想要一个Http接口返回Json格式的数据,只需要在Controller类中做如下定义:
@GetMapping("/{id}")
public @ResponseBody Book findById(@PathVariable long id) {
return bookService.findById(id);
}
客户端在http请求头"Accept"设置成application/json:
curl --header "Accept: application/json" http://localhost:8080/spring-boot-rest/books/1
Book class:
public class Book {
private long id;
private String name;
}
接口返回值如下:
{
"id": 1,
"name": "Thinking in Ja",
}
在http请求头中简单的设置一个Accept header,我们就可以从服务端获取想要的json格式,这是如何做到的,没错,是HttpMessageConverter实现的。
在Spring中,HttpMessageConverter是一个怎样的接口:
/**
* Strategy interface that specifies a converter that can convert from and to HTTP requests and responses.
*
* @author Arjen Poutsma
* @author Juergen Hoeller
* @since 3.0
*/
public interface HttpMessageConverter<T> {
可以看出,它是工作在http request和response两者之间的一种策略,它关注的核心是:
如何从http请求中读http消息--读并且转
如何往http response中回写http消息--转并且写
作为整个功能模块核心的接口,它暴露的可用操作很明确
截止到Spring4.3.9版本,已经内置了很多常用的消息格式转换器,如feed,atom,xml,json,protobuf,下面都是HttpMessageConverter的具体实现:
事实上,我们上边例子中转Json最终用到的是MappingJackson2HttpMessageConverter,来看下这个类的继承图
那么在http请求时,有了具体的转换工具,那么是谁来操作HttpMessageConverter来完成转换逻辑呢
在上面的例子中,我们使用了@ResponseBody, 那么在SpringMvc中,就要用到RequestResponseBodyMethodProcessor这个类来处理了,也就是完成从JavaBean转成Json再回写到http response中。
事实上这个RequestResponseBodyMethodProcessor类所能做的远不止此,它同样也可以处理@RequestBody的具体读取逻辑。
从它的继续图可以看到两个SpringMvc中两个核心接口:
HandlerMethodReturnValueHandler
HandlerMethodArgumentResolver
前者总体负责处理Handler的返回值处理逻辑-对应http reponse的写
后者负责处理Handler参数的解析逻辑-对应http request的读
在SpringMvc中 一揽子Handler和ArguementResover通过组合模式被封装成一个整体,放到RequestMappingHandlerAdapter中,供SpringMvc直接用来处理http请求的读和写。
public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter
implements BeanFactoryAware, InitializingBean {
private List<HandlerMethodArgumentResolver> customArgumentResolvers;
private HandlerMethodArgumentResolverComposite argumentResolvers;
private HandlerMethodArgumentResolverComposite initBinderArgumentResolvers;
private List<HandlerMethodReturnValueHandler> customReturnValueHandlers;
private HandlerMethodReturnValueHandlerComposite returnValueHandlers;
对http请求参数的具体处理,交给了InvocableHandlerMethod.getMethodArgumentValues方法:
if (this.argumentResolvers.supportsParameter(parameter)) {
try {
args[i] = this.argumentResolvers.resolveArgument(
parameter, mavContainer, request, this.dataBinderFactory);
continue;
}
而对http返回值的处理,则是交给org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod#invokeAndHandle
try {
this.returnValueHandlers.handleReturnValue(
returnValue, getReturnValueType(returnValue), mavContainer, webRequest);
}
上述逻辑一起完成http请求的入口和出口的处理工作。
SpringAutowired
一个有用的公众号
长按,识别二维码,加关注