java - REST:如何发送 YAML 负载 (Java)

Question

如何使用 Java 将 yml 负载发送到 POST 实体。

---

环境

要求:

• 语言:Java
• 使用的库:Jersey

目标(已存在):

• REST 端点
• 输入 POST
• 负载内容 YAML

---

代码

我曾经用它来实现同样的目的:

curl --noproxy '*' -X POST --header 'content-type: application/x-yml' --data-binary @file.yaml --url "http://my.yaml.endpoint.com"

我试过这样的:

private Client client;
private ObjectMapper mapper = new ObjectMapper(new YAMLFactory());

YMLPayload yml= null;
    try {
        yml = mapper.readValue(yml, YMLPayload.class);
    } catch (IOException e) {e.printStackTrace();}

Response res = client
                .target("http://my.yaml.endpoint.com")
                .request(/* which mediatype? */)
                .header("content-type", "application/x-yml")
                .post(/* how to transform the data? */);

---

由于我对这个主题还很陌生，所以我可能忽略了一些东西。

Answer 1

在您的 JAX-RS 客户端中使用JacksonYAMLProvider

Jackson 有一个模块用于处理 JAX-RS 中的 YAML 序列化/反序列化。它提供了 MessageBodyReader和 MessageBodyWriter将 YAML 内容绑定(bind)到 Java 对象和从 Java 对象绑定(bind)所需的。要使用它，请将以下依赖项添加到您的项目中:

<dependency>
    <groupId>com.fasterxml.jackson.jaxrs</groupId>
    <artifactId>jackson-jaxrs-yaml-provider</artifactId>
    <version>2.9.7</version>
</dependency>

然后注册 JacksonYAMLProvider类并按如下方式执行您的请求:

Client client = ClientBuilder.newClient().register(new JacksonYAMLProvider());

Response response = client.target("http://example.org")
        .request().accept(YAMLMediaTypes.APPLICATION_JACKSON_YAML)
        .post(Entity.entity(foo, YAMLMediaTypes.APPLICATION_JACKSON_YAML_TYPE));

其中 foo 是将被序列化为 YAML 的对象。

如果您需要微调 YAML 序列化/反序列化，您可以传递 YAMLMapper 的实例到 JacksonYAMLProvider构造函数:

YAMLMapper mapper = new YAMLMapper();
mapper.disable(YAMLGenerator.Feature.WRITE_DOC_START_MARKER);

Client client = ClientBuilder.newClient().register(new JacksonYAMLProvider(mapper));

一次there's no media type for YAML registered in IANA ，没有官方标准。 Jackson 使用的 YAML 媒体类型是 application/yaml。例如，如果您需要使用 application/x-yml，您可以覆盖 hasMatchingMediaType()方法来自 JacksonYAMLProvider根据您的需要:

JacksonYAMLProvider jacksonYAMLProvider = new JacksonYAMLProvider() {

    @Override
    protected boolean hasMatchingMediaType(MediaType mediaType) {
        return super.hasMatchingMediaType(mediaType) ||
                "x-yml".equalsIgnoreCase(mediaType.getSubtype());
    }
};

Client client = ClientBuilder.newClient().register(jacksonYAMLProvider);

直接使用YAMLMapper

或者，您可以使用下面显示的方法，它不依赖于 JAX-RS 的 Jackson YAML 提供程序。

YAMLMapper mapper = new YAMLMapper();
Client client = ClientBuilder.newClient();

Response response = client.target("http://example.org")
        .request().accept("application/x-yml")
        .post(Entity.entity(mapper.writeValueAsString(foo), "application/x-yml"));

在这种方法中，foo 使用 YAMLMapper 序列化为 YAML直接。