Spring Boot - RestController 反序列化 YAML 上传？

Question

如何配置 Spring Boot RestController 以接受 YAML 上传？

下面的结果是 415。我可以通过调试看到我的 Spring 上下文中的 MappingJackson2HttpMessageConverter 实例仅支持 [application/json;charset=UTF-8, application/*+json;charset=UTF-8]。我不能是唯一一个尝试这样做的 Spring Boot 用户，我很惊讶它不能正常工作 - 大多数事情都在 Spring Boot 中完成！

我的 POM 中有 YAML 数据格式：

    <dependency>
        <groupId>com.fasterxml.jackson.dataformat</groupId>
        <artifactId>jackson-dataformat-yaml</artifactId>
    </dependency>

我的 RestController 有一个方法：

@RequestMapping(method=RequestMethod.POST, value="/", consumes="application/yaml")
public String upload(@RequestBody Declaration declaration) {
    //Do stuff
}

我的测试：

@Test
public void triggersConvergence() throws Exception {
    ClassPathResource fixture = new ClassPathResource("declaration.yml");
    HttpHeaders requestHeaders = new HttpHeaders();
    requestHeaders.add("Content-Type", "application/yaml");
    requestHeaders.add("Accept", "application/json");

    URI uri = new URI("http://127.0.0.1:"+port);
    byte[] bytes = new byte[(int)fixture.contentLength()];
    fixture.getInputStream().read(bytes);
    RequestEntity<byte[]> postRequest = new RequestEntity<byte[]>(bytes, requestHeaders, HttpMethod.POST, uri);

    ResponseEntity<String> response = rest.exchange(postRequest, String.class);
    assertThat(response.getStatusCode(), is(HttpStatus.OK));
    assertThat(response.getBody(), is("Converged org my-lovely-org"));
}

Answer 1

虽然此功能在 Spring 中不可用，但使用 YAMLMapper 只需 2 个简单步骤即可轻松添加：

1. 定义你自己的支持Content-Type: application/x-yaml的HttpMessageConverter：

   final class YamlJackson2HttpMessageConverter extends AbstractJackson2HttpMessageConverter {
       YamlJackson2HttpMessageConverter() {
           super(new YAMLMapper(), MediaType.parseMediaType("application/x-yaml"));
       }
   }
   

2. 注册您的转换器：

   @Configuration
   public class YamlConfiguration extends WebMvcConfigurerAdapter {
       @Override
       public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
           converters.add(new YamlJackson2HttpMessageConverter());
       }
   }
   

享受来自 POJO 的控制器方法消费和生产application/x-yaml。

Answer 2

是的，你可以这样做。

Maven 依赖：

<dependency>
  <groupId>com.fasterxml.jackson.dataformat</groupId>
  <artifactId>jackson-dataformat-yaml</artifactId>
  <version>2.5.4</version>
</dependency>

控制器方法：

@RequestMapping(value = "/my/endpoint", method = RequestMethod.POST, consumes = "application/x-yaml")
@ResponseBody
public ResponseEntity<MyResponse> receiveYaml(@RequestBody final String yaml) {
    //unserialize yaml
}

使用 curl 的请求示例：

curl -X POST --header "Content-Type: application/x-yaml" --header "Accept: */*" -d "invoice: 34843
date   : 2001-01-23
bill-to: &id001
    given  : Chris
    family : Dumars
    address:
        lines: |
            458 Walkman Dr.
            Suite #292
        city    : Royal Oak
        state   : MI
        postal  : 48046
ship-to: *id001
product:
    - sku         : BL394D
      quantity    : 4
      description : Basketball
      price       : 450.00
    - sku         : BL4438H
      quantity    : 1
      description : Super Hoop
      price       : 2392.00
tax  : 251.42
total: 4443.52
comments: >
    Late afternoon is best.
    Backup contact is Nancy
    Billsmer @ 338-4338."