java - @RequestBody 注释究竟是如何工作的以及它与 HttpMessageConverter 接口(interface)有何关系？

Question

我正在研究 Spring 如何处理 REST web 服务，我对 HttpMessageConverter 的概念有一些疑问。

在官方文档上我可以看到:

Strategy interface that specifies a converter that can convert from and to HTTP requests and responses.

所以HttpMessageConverter 似乎是一个接口(interface)，但究竟什么是策略接口(interface)？是否与策略模式相关？

据我了解，Spring 在使用 @EnableWebMvc 或

时会自动提供一些默认注册的实现

但是这些实现到底是什么？你能给我一个实际的例子吗？

我认为它是这样工作的:

例如，一个客户端执行一个 HttpRequest，在这个请求的主体中放入一个 JSON 消息(我不太实际，但我认为我可以做这样的事情)，然后 Controller 处理此 HttpRequst 使用 HttpMessageConverter 的实现将此 JSON 消息转换为模型对象。我认为反之亦然。

我的推理正确还是我遗漏了什么？

还有一个疑惑是关于@RequestBody注解的(我觉得跟上一个话题有关)

我有这个例子:

@RequestMapping(value="/orders/{id}", method=RequestMethod.PUT)
@ResponseStatus(HttpStatus.NO_CONTENT) // 204
public void updateOrder(@RequestBody Order updatedOrder, @PathVariable("id") long id) {
    // process updated order data and return empty response
    orderManager.updateOrder(id, updatedOrder);
}

所以我认为 @RequestBody Order updatedOrder 从 HttpRequest 的主体中获取 updatedOrder 输入参数的值，然后将其转换为 Order 使用 HttpMessageConverter 实现的对象。

是正确的还是我遗漏了什么？如果是正确的如何选择正确的转换器？

例如，我在这里找到了另一个与前一个类似的例子:http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html

@Controller
@RequestMapping(value = "/pets", method = RequestMethod.POST, consumes="application/json")
public void addPet(@RequestBody Pet pet, Model model) {
    // implementation omitted
}

我认为这里明确指定它必须使用 JSON 到 MODEL OBJECT 转换器。为什么在前面的例子中没有指定？如何选择合适的转换器？

谢谢

Answer 1

处理程序方法参数由 Spring 的 HandlerMethodArgumentResolver 生成，处理程序方法返回值由 Spring 的 HandlerMethodReturnValueHandler 处理。处理@ResponseBody 和@RequestBody 的实现是RequestResponseBodyMethodProcessor。

其中一个是默认注册的(@EnableWebMvc 配置)，默认列表是 HttpMessageConverter 实例。这是在 WebMvcConfigurationSupport#addDefaultHttpMessageConverters(List) 中完成的。您可以找到源代码并查看添加了哪些以及添加的顺序。

当 Spring 为 @RequestBody 参数生成参数时，它循环遍历 HttpMessageConverter 实例，检查该实例是否 HttpMessageConverter#canRead 请求中给出的内容类型，可以生成参数类型的实例。如果可以，Spring 将使用该 HttpMessageConverter 生成一个参数。如果不能，Spring 将跳过它并尝试下一个实例，直到它用完。此时，它会抛出异常。

对于 @ResponseBody，除了 Spring 现在使用 HttpMessageConverter#canWrite 之外，过程是相同的。它将检查 HttpMessageConverter 是否可以序列化返回类型并生成符合响应中预期内容类型的响应内容(在 Accept 请求 header 中给出)。

@RequestParam的consumes属性

@RequestMapping(value = "/pets", method = RequestMethod.POST, consumes="application/json")

与上面声明的策略无关。 consumes 在这里做的唯一一件事是限制处理程序的映射。例如，拿这两个处理程序

@RequestMapping(value = "/pets", method = RequestMethod.POST)

@RequestMapping(value = "/pets", method = RequestMethod.POST, consumes="application/json")

第一个可以处理对任何内容类型的/pets 的任何请求。第二个只能处理内容类型为 application/json 的 /pets 请求。