RestTemplate：exchange（）vs postForEntity（）vs execute（）

Question

我正在使用Spring Boot开发Rest API，并且必须访问应用程序的端点。我曾经用过RestTemplate。我能够使用2种方法来做到这一点，

• postForEntity()：

  responseEntity = 
      restTemplate.postForEntity(uri, httpEntity, ResponseClass.class);
  

• exchange()：

  responseEntity = 
      restTemplate.exchange(uri, HttpMethod.POST, httpEntity, ResponseClass.class);
  

我想知道这两种方法的用法和区别。

我也看到了另一种方法execute()。请阐明一下。如何以及何时使用它。

Answer 1

这RestTemplate是一个非常通用的对象。

让我们从开始execute，因为它是最通用的方法：

execute(String url, HttpMethod method, @Nullable RequestCallback requestCallback,
        @Nullable ResponseExtractor<T> responseExtractor, Object... uriVariables)

请注意，uriVariables也可以通过Map。

execute 设计用于尽可能多的场景：

• 第一个和第二个参数允许URL和方法的任何有效组合。
• 可以通过在发送请求之前传递自定义RequestCallback（@FunctionalInterface仅使用一种方法doWithRequest(ClientHttpRequest request)）来以多种不同方式修改请求。
• 可以通过传递自定义以任何必要的方式反序列化从远程资源返回的响应ResponseExtractor。

将此与exchange：

exchange(String url, HttpMethod method, @Nullable HttpEntity<?> requestEntity,
         Class<T> responseType, Object... uriVariables)

这里有两个主要区别：

• 您现在可以HttpEntity直接传递，而之前需要使用手动设置RequestCallback。
• 通过传递所需的响应类型，即可提供反序列化机制Class。

如您所见，这对于日常使用更为方便。

这样的方法getForEntity，postForEntity甚至更短，更易于理解：

getForEntity(String url, Class<T> responseType, Object... uriVariables)

postForEntity(String url, @Nullable Object request, Class<T> responseType,
              Object... uriVariables)

postForEntity现在，通知使您Object无需包装即可直接发布任何内容。使用它们来代替execute它们并不会带来性能上的好处或损害，因为它们execute在幕后称呼自己-这只是为了方便。

Answer 2

RestTemplate是执行HTTP请求的同步客户端。除了支持不常见情况的通用方法exchange(...)和execute(...)方法之外，它还提供了每种HTTP方法的常见方案模板。

在Spring集成文档总结了每种方法的用法：

postForEntity

通过创建一个新资源，POST并从响应中返回表示形式。

exchange

上述方法的通用性强，观点少的版本，在需要时提供了额外的灵活性。它接受RequestEntityHTTP方法，URL，标头和正文作为输入，并返回ResponseEntity。

这些方法允许使用ParameterizedTypeReference而不是Class使用泛型来指定响应类型。

execute

执行请求的最通用方法，完全控制通过回调接口进行的请求准备和响应提取。

最后，两个postForEntity(...)，exchange(...)和execute(...)方法将调用受保护的doExecute(...)方法，该方法将执行实际的HTTP请求。您可以查看源代码以获取详细信息