如何为外部world REST服务创建REST客户端

Question

如何使用JAX-RS Client Fluent API为外部世界REST服务创建rest客户端？

例如，假设一个服务返回一个person对象，该对象有两个字段名和年龄。

无论我遇到什么样的例子/教程，他们做同样的事情，下面的片段或他们开发客户端在同一个项目，以取代tring.classperson.class.我应该如何创建独立的客户端，将返回我pojo的人。

String entity = client.target("http://example.com/rest")
        .path("resource/helloworld")
        .queryParam("greeting", "Hi World!")
        .request(MediaType.TEXT_PLAIN_TYPE)
        .header("some-header", "true")
        .get(String.class);

Answer 1

例如，您正在使用一个REST API，它在执行<代码> >获取< /代码>请求时提供以下JSONhttp://example.com/api/people/1：

{
  "name": "John Doe",
  "age": 25
}

上述JSON可以映射到Java类，定义如下：

public class Person {

    private String name;

    private Integer age;

    // Constructor, getters and setters omitted
}

使用JAX-RS客户机API，可以按如下方式请求JSON，将请求的实体映射到Person类：

Client client = ClientBuilder.newClient();
Person person = client.target("http://example.com/api")
                      .path("people").path("1")
                      .request(MediaType.APPLICATION_JSON)
                      .get(Person.class);

String name = person.getName();
Integer age = person.getAge();

JAX-RS客户端API是JAX-RS 2.0规范的一部分，参考实现是泽西。

为了解析JSON，Jersey为多个框架提供了一组扩展模块，这些框架支持JSON处理和/或JSON到Java绑定。Jersey支持MOXy、JSON-P、Jackson和抛弃。有关更多详细信息，请参阅文档。

如果出于某种原因，需要手动解析请求的实体，可以将请求的实体存储在字符串中：

Client client = ClientBuilder.newClient();
String json = client.target("http://example.com/api")
                    .path("people").path("1")
                    .request(MediaType.APPLICATION_JSON)
                    .get(String.class);

然后可以使用例如Jackson手动解析请求的实体：

ObjectMapper mapper = new ObjectMapper();
JsonNode node = mapper.readTree(json);

String name = node.path("name").asText();
Integer age = node.path("age").asInt();

若要手动解析JSON，还可以考虑GSON。

有关如何使用Java使用REST API的替代方法，请查看此答案。