Spring中HttpMessageConverter的工作原理

Spring中HttpMessageConverter的工作原理_第1张图片

在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 {

可以看出,它是工作在http request和response两者之间的一种策略,它关注的核心是:

如何从http请求中读http消息--读并且转

如何往http response中回写http消息--转并且写

Spring中HttpMessageConverter的工作原理_第2张图片

作为整个功能模块核心的接口,它暴露的可用操作很明确

截止到Spring4.3.9版本,已经内置了很多常用的消息格式转换器,如feed,atom,xml,json,protobuf,下面都是HttpMessageConverter的具体实现:Spring中HttpMessageConverter的工作原理_第3张图片

事实上,我们上边例子中转Json最终用到的是MappingJackson2HttpMessageConverter,来看下这个类的继承图

Spring中HttpMessageConverter的工作原理_第4张图片

那么在http请求时,有了具体的转换工具,那么是谁来操作HttpMessageConverter来完成转换逻辑呢

在上面的例子中,我们使用了@ResponseBody, 那么在SpringMvc中,就要用到RequestResponseBodyMethodProcessor这个类来处理了,也就是完成从JavaBean转成Json再回写到http response中。

事实上这个RequestResponseBodyMethodProcessor类所能做的远不止此,它同样也可以处理@RequestBody的具体读取逻辑。

Spring中HttpMessageConverter的工作原理_第5张图片

从它的继续图可以看到两个SpringMvc中两个核心接口:

  1. HandlerMethodReturnValueHandler

  2. HandlerMethodArgumentResolver

前者总体负责处理Handler的返回值处理逻辑-对应http reponse的写

后者负责处理Handler参数的解析逻辑-对应http request的读

在SpringMvc中 一揽子Handler和ArguementResover通过组合模式被封装成一个整体,放到RequestMappingHandlerAdapter中,供SpringMvc直接用来处理http请求的读和写。

public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter
    implements BeanFactoryAware, InitializingBean {


  private List customArgumentResolvers;


  private HandlerMethodArgumentResolverComposite argumentResolvers;


  private HandlerMethodArgumentResolverComposite initBinderArgumentResolvers;


  private List 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

一个有用的公众号

长按,识别二维码,加关注

你可能感兴趣的:(Spring中HttpMessageConverter的工作原理)