如何使用ResponseEntity处理RestTemplate返回的Client资源列表

我有一个外部REST API，会以JSON格式返回client对象列表，示例请求与响应如下：

GET externalapi.io/api/clients

[ {
    "id" : "b15asgdc-6efd-4a2d-re08-2q3r3bae",
    "clientName" : "test1",
    ...
  },
  {
    "id" : "ryec-6efd-4a2d-aa08-29a9drjrteae",
    "clientName" : "test2",
    ...
  },
  ...
]

我的API使用Spring的RestTemplate调用该外部服务，目标是获取响应并将其解析为ClientResource Java对象。我尝试了以下代码：

HttpEntity<Object> entity = new HttpEntity<Object>(null, headers);

ResponseEntity<String> responseEntityJson = resttemplate.exchange(path, HttpMethod.GET, entity, String.class);

Type listType = new TypeToken<ArrayList<ClientResource>>(){}.getType();

ArrayList<ClientResource> responseResources = gson.fromJson(responseEntityJson.getBody(), listType);

但上述代码中ResponseEntity<String> responseEntityJson = resttemplate.exchange(path, HttpMethod.GET, entity, String.class);这一行无法正常工作。我看到有人建议用ResponseEntity<ClientResource> responseEntityJson = resttemplate.exchange(path, HttpMethod.GET, entity, ClientResource.class);，但这显然不适用于列表场景。我想使用ResponseEntity<List<ClientResource>>，但exchange()方法似乎不直接支持这种类型，请问如何用ResponseEntity处理资源列表？

方法1：使用ParameterizedTypeReference直接解析 #

RestTemplate的exchange方法支持通过ParameterizedTypeReference指定泛型集合类型，直接获取封装了列表的ResponseEntity，无需手动处理JSON字符串：

HttpEntity<Object> entity = new HttpEntity<>(null, headers);

ResponseEntity<List<ClientResource>> response = restTemplate.exchange(
    path,
    HttpMethod.GET,
    entity,
    new ParameterizedTypeReference<List<ClientResource>>() {}
);

List<ClientResource> clientResources = response.getBody();

这种方式依赖Spring内置的消息转换器（默认是Jackson），需要确保ClientResource类与JSON字段映射正确——字段名一致，或通过@JsonProperty注解指定对应关系。

方法2：修复GSON解析方案 #

如果坚持使用GSON，先排查原代码的潜在问题：确保RestTemplate没有对字符串响应做额外编码处理，可直接获取原始JSON字符串后解析：

HttpEntity<Object> entity = new HttpEntity<>(null, headers);

// 确保获取到原始JSON字符串
String jsonResponse = resttemplate.exchange(path, HttpMethod.GET, entity, String.class).getBody();

Type listType = new TypeToken<ArrayList<ClientResource>>(){}.getType();
ArrayList<ClientResource> responseResources = new Gson().fromJson(jsonResponse, listType);

同时要确认ClientResource类的字段与JSON匹配，可通过@SerializedName注解指定字段映射，比如：

public class ClientResource {
    @SerializedName("id")
    private String id;
    @SerializedName("clientName")
    private String clientName;
    // getter、setter
}

方法3：简化调用（无需完整ResponseEntity） #

如果不需要响应头、状态码等额外信息，可直接提取响应体：

List<ClientResource> clientResources = restTemplate.exchange(
    path,
    HttpMethod.GET,
    new HttpEntity<>(null, headers),
    new ParameterizedTypeReference<List<ClientResource>>() {}
).getBody();

内容的提问来源于stack exchange，提问作者KJ0797