REST 客户端 (REST Clients) _ Spring Framework 6.1.11-SNAPSHOT 中文文档(官方文档中文翻译) —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Framework 6.1.10！Spring中文文档

Spring Framework 提供了以下用于调用 REST 端点的选择：Spring中文文档

RestClient - 具有流畅 API 的同步客户端。Spring中文文档
WebClient - 具有流畅 API 的非阻塞、反应式客户端.Spring中文文档
RestTemplate - 具有模板方法 API 的同步客户端。Spring中文文档
HTTP 接口 - 带有生成的动态代理实现的带注释的接口。Spring中文文档

`RestClient`

这是一个同步 HTTP 客户端，提供现代、流畅的 API。它提供了对 HTTP 库的抽象，允许方便地将 Java 对象转换为 HTTP 请求，以及从 HTTP 响应创建对象。RestClientSpring中文文档

创建`RestClient`

是使用静态方法之一创建的。您还可以使用来获取具有更多选项的构建器，例如指定要使用的 HTTP 库（请参阅客户端请求工厂）和要使用的消息转换器（请参阅 HTTP 消息转换）、设置默认 URI、默认路径变量、默认请求标头或，或注册侦听器和初始值设定项。RestClientcreatebuilder()uriBuilderFactorySpring中文文档

一旦创建（或构建），就可以由多个线程安全地使用。RestClientSpring中文文档

下面的示例演示如何创建默认值，以及如何生成自定义值。RestClientSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

RestClient defaultClient = RestClient.create();

RestClient customClient = RestClient.builder()
  .requestFactory(new HttpComponentsClientHttpRequestFactory())
  .messageConverters(converters -> converters.add(new MyCustomMessageConverter()))
  .baseUrl("https://example.com")
  .defaultUriVariables(Map.of("variable", "foo"))
  .defaultHeader("My-Header", "Foo")
  .requestInterceptor(myCustomInterceptor)
  .requestInitializer(myCustomInitializer)
  .build();

val defaultClient = RestClient.create()

val customClient = RestClient.builder()
  .requestFactory(HttpComponentsClientHttpRequestFactory())
  .messageConverters { converters -> converters.add(MyCustomMessageConverter()) }
  .baseUrl("https://example.com")
  .defaultUriVariables(mapOf("variable" to "foo"))
  .defaultHeader("My-Header", "Foo")
  .requestInterceptor(myCustomInterceptor)
  .requestInitializer(myCustomInitializer)
  .build()

使用`RestClient`

使用发出 HTTP 请求时，首先要指定的是要使用的 HTTP 方法。这可以使用方便方法、、等来完成。RestClientmethod(HttpMethod)get()head()post()Spring中文文档

请求 URL

接下来，可以使用以下方法指定请求 URI。此步骤是可选的，如果配置了默认 URI，则可以跳过此步骤。 URL 通常指定为，带有可选的 URI 模板变量。以下示例将 GET 请求配置为：uriRestClientStringexample.com/orders/42Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

int id = 42;
restClient.get()
  .uri("https://example.com/orders/{id}", id)
  ....

val id = 42
restClient.get()
  .uri("https://example.com/orders/{id}", id)
  ...

函数还可用于更多控件，例如指定请求参数。Spring中文文档

默认情况下，字符串 URL 是编码的，但这可以通过使用自定义 . URL 也可以与函数一起提供，也可以作为提供，这两者都不编码。有关使用 URI 和编码 URI 的更多详细信息，请参阅 URI 链接。uriBuilderFactoryjava.net.URISpring中文文档

请求标头和正文

如有必要，可以通过添加带有、或方便方法的请求标头来操作 HTTP 请求，依此类推。对于可以包含正文（、和）的 HTTP 请求，可以使用其他方法：和。header(String, String)headers(Consumer<HttpHeaders>accept(MediaType…)acceptCharset(Charset…)POSTPUTPATCHcontentType(MediaType)contentLength(long)Spring中文文档

请求正文本身可以由设置，后者内部使用 HTTP 消息转换。或者，可以使用来设置请求正文，从而允许您使用泛型。最后，可以将 body 设置为写入 .body(Object)ParameterizedTypeReferenceOutputStreamSpring中文文档

检索响应

设置请求后，将通过调用来访问 HTTP 响应。可以使用或针对参数化类型（如列表）访问响应正文。该方法将响应内容转换为各种类型，例如，字节可以转换为，JSON 可以使用 Jackson 转换为对象，等等（参见 HTTP 消息转换）。retrieve()body(Class)body(ParameterizedTypeReference)bodyStringSpring中文文档

响应也可以转换为，从而可以访问响应标头和正文。ResponseEntitySpring中文文档

此示例演示如何使用它来执行简单的请求。RestClientGETSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

String result = restClient.get() (1)
  .uri("https://example.com") (2)
  .retrieve() (3)
  .body(String.class); (4)

System.out.println(result); (5)

1	设置 GET 请求
2	指定要连接到的 URL
3	检索响应
4	将响应转换为字符串
5	打印结果

val result= restClient.get() (1)
  .uri("https://example.com") (2)
  .retrieve() (3)
  .body<String>() (4)

println(result) (5)

1	设置 GET 请求
2	指定要连接到的 URL
3	检索响应
4	将响应转换为字符串
5	打印结果

通过以下方式提供对响应状态代码和标头的访问：ResponseEntitySpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

ResponseEntity<String> result = restClient.get() (1)
  .uri("https://example.com") (1)
  .retrieve()
  .toEntity(String.class); (2)

System.out.println("Response status: " + result.getStatusCode()); (3)
System.out.println("Response headers: " + result.getHeaders()); (3)
System.out.println("Contents: " + result.getBody()); (3)

1	为指定的 URL 设置 GET 请求
2	将响应转换为`ResponseEntity`
3	打印结果

val result = restClient.get() (1)
  .uri("https://example.com") (1)
  .retrieve()
  .toEntity<String>() (2)

println("Response status: " + result.statusCode) (3)
println("Response headers: " + result.headers) (3)
println("Contents: " + result.body) (3)

1	为指定的 URL 设置 GET 请求
2	将响应转换为`ResponseEntity`
3	打印结果

RestClient可以使用 Jackson 库将 JSON 转换为对象。请注意此示例中 URI 变量的用法，并且标头设置为 JSON。AcceptSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

int id = ...;
Pet pet = restClient.get()
  .uri("https://petclinic.example.com/pets/{id}", id) (1)
  .accept(APPLICATION_JSON) (2)
  .retrieve()
  .body(Pet.class); (3)

1	使用 URI 变量
2	将标头设置为`Acceptapplication/json`
3	将 JSON 响应转换为域对象`Pet`

val id = ...
val pet = restClient.get()
  .uri("https://petclinic.example.com/pets/{id}", id) (1)
  .accept(APPLICATION_JSON) (2)
  .retrieve()
  .body<Pet>() (3)

1	使用 URI 变量
2	将标头设置为`Acceptapplication/json`
3	将 JSON 响应转换为域对象`Pet`

在下一个示例中，用于执行包含 JSON 的 POST 请求，该请求再次使用 Jackson 进行转换。RestClientSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

Pet pet = ... (1)
ResponseEntity<Void> response = restClient.post() (2)
  .uri("https://petclinic.example.com/pets/new") (2)
  .contentType(APPLICATION_JSON) (3)
  .body(pet) (4)
  .retrieve()
  .toBodilessEntity(); (5)

1	创建域对象`Pet`
2	设置 POST 请求和要连接到的 URL
3	将标头设置为`Content-Typeapplication/json`
4	用作请求正文`pet`
5	将响应转换为没有正文的响应实体。

val pet: Pet = ... (1)
val response = restClient.post() (2)
  .uri("https://petclinic.example.com/pets/new") (2)
  .contentType(APPLICATION_JSON) (3)
  .body(pet) (4)
  .retrieve()
  .toBodilessEntity() (5)

1	创建域对象`Pet`
2	设置 POST 请求和要连接到的 URL
3	将标头设置为`Content-Typeapplication/json`
4	用作请求正文`pet`
5	将响应转换为没有正文的响应实体。

错误处理

默认情况下，在检索具有 4xx 或 5xx 状态代码的响应时抛出的子类。可以使用来覆盖此行为。RestClientRestClientExceptiononStatusSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

String result = restClient.get() (1)
  .uri("https://example.com/this-url-does-not-exist") (1)
  .retrieve()
  .onStatus(HttpStatusCode::is4xxClientError, (request, response) -> { (2)
      throw new MyCustomRuntimeException(response.getStatusCode(), response.getHeaders()) (3)
  })
  .body(String.class);

1	为返回 404 状态代码的 URL 创建 GET 请求
2	为所有 4xx 状态代码设置状态处理程序
3	引发自定义异常

val result = restClient.get() (1)
  .uri("https://example.com/this-url-does-not-exist") (1)
  .retrieve()
  .onStatus(HttpStatusCode::is4xxClientError) { _, response -> (2)
    throw MyCustomRuntimeException(response.getStatusCode(), response.getHeaders()) } (3)
  .body<String>()

1	为返回 404 状态代码的 URL 创建 GET 请求
2	为所有 4xx 状态代码设置状态处理程序
3	引发自定义异常

交换

对于更高级的方案，可以通过该方法访问基础 HTTP 请求和响应，该方法可以代替 . 使用时不应用状态处理程序，因为 exchange 函数已经提供了对完整响应的访问，允许您执行任何必要的错误处理。RestClientexchange()retrieve()exchange()Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

Pet result = restClient.get()
  .uri("https://petclinic.example.com/pets/{id}", id)
  .accept(APPLICATION_JSON)
  .exchange((request, response) -> { (1)
    if (response.getStatusCode().is4xxClientError()) { (2)
      throw new MyCustomRuntimeException(response.getStatusCode(), response.getHeaders()); (2)
    }
    else {
      Pet pet = convertResponse(response); (3)
      return pet;
    }
  });

1	`exchange`提供请求和响应
2	当响应具有 4xx 状态代码时引发异常
3	将响应转换为 Pet 域对象

val result = restClient.get()
  .uri("https://petclinic.example.com/pets/{id}", id)
  .accept(MediaType.APPLICATION_JSON)
  .exchange { request, response -> (1)
    if (response.getStatusCode().is4xxClientError()) { (2)
      throw MyCustomRuntimeException(response.getStatusCode(), response.getHeaders()) (2)
    } else {
      val pet: Pet = convertResponse(response) (3)
      pet
    }
  }

1	`exchange`提供请求和响应
2	当响应具有 4xx 状态代码时引发异常
3	将响应转换为 Pet 域对象

HTTP 消息转换

请参阅 Reactive 堆栈中的等效项Spring中文文档

该模块包含用于读取和写入 HTTP 请求和响应正文的接口。实例用于客户端（例如，在）和服务器端（例如，在 Spring MVC REST 控制器中）。spring-webHttpMessageConverterInputStreamOutputStreamHttpMessageConverterRestClientSpring中文文档

框架中提供了主媒体（MIME）类型的具体实现，默认情况下，在客户端和和以及服务器端注册（请参阅配置消息转换器）。RestClientRestTemplateRequestMappingHandlerAdapterSpring中文文档

下面介绍了几种实现。有关完整列表，请参阅 HttpMessageConverter Javadoc。对于所有转换器，都使用默认媒体类型，但您可以通过设置属性来覆盖它。HttpMessageConvertersupportedMediaTypesSpring中文文档

表 1.HttpMessageConverter 实现
消息转换器	描述
`StringHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入实例的实现。默认情况下，此转换器支持所有文本媒体类型（），并使用的写入。`HttpMessageConverterStringtext/*Content-Typetext/plain`Spring中文文档
`FormHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入表单数据的实现。默认情况下，此转换器读取和写入媒体类型。表单数据从 . 转换器还可以写入（但不能读取）从 . 默认情况下，受支持。可以支持其他多部分子类型来写入表单数据。有关更多详细信息，请参阅 javadoc。`HttpMessageConverterapplication/x-www-form-urlencodedMultiValueMap<String, String>MultiValueMap<String, Object>multipart/form-dataFormHttpMessageConverter`Spring中文文档
`ByteArrayHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入字节数组的实现。默认情况下，此转换器支持所有媒体类型（），并使用的写入。可以通过设置属性并重写来覆盖此设置。`HttpMessageConverter/Content-Typeapplication/octet-streamsupportedMediaTypesgetContentType(byte[])`Spring中文文档
`MarshallingHttpMessageConverter`Spring中文文档	一个可以通过使用 Spring 和包中的抽象来读取和写入 XML 的实现。此转换器在使用之前需要 and。您可以通过构造函数或 Bean 属性注入这些属性。默认情况下，此转换器支持和。`HttpMessageConverterMarshallerUnmarshallerorg.springframework.oxmMarshallerUnmarshallertext/xmlapplication/xml`Spring中文文档
`MappingJackson2HttpMessageConverter`Spring中文文档	可以使用 Jackson 的 . 您可以通过使用 Jackson 提供的注释根据需要自定义 JSON 映射。当需要进一步控制时（对于需要为特定类型提供自定义 JSON 序列化程序/反序列化程序的情况），可以通过该属性注入自定义项。默认情况下，此转换器支持 .`HttpMessageConverterObjectMapperObjectMapperObjectMapperapplication/json`Spring中文文档
`MappingJackson2XmlHttpMessageConverter`Spring中文文档	可以使用 Jackson XML 扩展的 . 您可以根据需要使用 JAXB 或 Jackson 提供的注释来自定义 XML 映射。当需要进一步控制时（对于需要为特定类型提供自定义 XML 序列化程序/反序列化程序的情况），可以通过该属性注入自定义项。默认情况下，此转换器支持 .`HttpMessageConverterXmlMapperXmlMapperObjectMapperapplication/xml`Spring中文文档
`SourceHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入的实现。仅支持、和。默认情况下，此转换器支持和。`HttpMessageConverterjavax.xml.transform.SourceDOMSourceSAXSourceStreamSourcetext/xmlapplication/xml`Spring中文文档

默认情况下，并注册所有内置消息转换器，具体取决于类路径上基础库的可用性。还可以通过使用生成器上的方法或通过的属性将消息转换器设置为显式使用。RestClientRestTemplatemessageConverters()RestClientmessageConvertersRestTemplateSpring中文文档

Jackson JSON 视图

若要仅序列化对象属性的子集，可以指定 Jackson JSON 视图，如以下示例所示：Spring中文文档

MappingJacksonValue value = new MappingJacksonValue(new User("eric", "7!jd#h23"));
value.setSerializationView(User.WithoutPasswordView.class);

ResponseEntity<Void> response = restClient.post() // or RestTemplate.postForEntity
  .contentType(APPLICATION_JSON)
  .body(value)
  .retrieve()
  .toBodilessEntity();

多部分

若要发送多部分数据，需要提供其值可以是 for 部件内容、文件部件或带有标头的 for 部件内容。例如：MultiValueMap<String, Object>ObjectResourceHttpEntitySpring中文文档

MultiValueMap<String, Object> parts = new LinkedMultiValueMap<>();

parts.add("fieldPart", "fieldValue");
parts.add("filePart", new FileSystemResource("...logo.png"));
parts.add("jsonPart", new Person("Jason"));

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_XML);
parts.add("xmlPart", new HttpEntity<>(myBean, headers));

// send using RestClient.post or RestTemplate.postForEntity

在大多数情况下，您不必为每个部件指定。内容类型是根据所选择的序列化内容自动确定的，或者在序列化的情况下，基于文件扩展名。如有必要，可以显式提供包装器。Content-TypeHttpMessageConverterResourceMediaTypeHttpEntitySpring中文文档

准备就绪后，可以使用（或）将其用作请求的正文。MultiValueMapPOSTRestClient.post().body(parts)RestTemplate.postForObjectSpring中文文档

如果包含至少一个非值，则设置为。如果有值，则默认为。如有必要，也可以显式设置。MultiValueMapStringContent-Typemultipart/form-dataFormHttpMessageConverterMultiValueMapStringContent-Typeapplication/x-www-form-urlencodedContent-TypeSpring中文文档

客户端请求工厂

若要执行 HTTP 请求，请使用客户端 HTTP 库。这些库通过界面进行调整。有多种实现方式可供选择：RestClientClientRequestFactorySpring中文文档

JdkClientHttpRequestFactory对于 Java 的HttpClientSpring中文文档
HttpComponentsClientHttpRequestFactory用于 Apache HTTP 组件HttpClientSpring中文文档
JettyClientHttpRequestFactory对于Jetty'sHttpClientSpring中文文档
ReactorNettyClientRequestFactory用于 Reactor Netty'sHttpClientSpring中文文档
SimpleClientHttpRequestFactory作为简单的默认值Spring中文文档

如果在构建时未指定请求工厂，它将使用 Apache 或 Jetty（如果它们在类路径上可用）。否则，如果加载了模块，它将使用 Java 的 . 最后，它将采用简单的默认值。RestClientHttpClientjava.net.httpHttpClientSpring中文文档

请注意，在访问表示错误的响应状态（例如 401）时，可能会引发异常。如果这是一个问题，请使用任何替代请求工厂。SimpleClientHttpRequestFactory

1	设置 GET 请求
2	指定要连接到的 URL
3	检索响应
4	将响应转换为字符串
5	打印结果

1	设置 GET 请求
2	指定要连接到的 URL
3	检索响应
4	将响应转换为字符串
5	打印结果

1	为指定的 URL 设置 GET 请求
2	将响应转换为`ResponseEntity`
3	打印结果

1	为指定的 URL 设置 GET 请求
2	将响应转换为`ResponseEntity`
3	打印结果

1	使用 URI 变量
2	将标头设置为`Acceptapplication/json`
3	将 JSON 响应转换为域对象`Pet`

1	使用 URI 变量
2	将标头设置为`Acceptapplication/json`
3	将 JSON 响应转换为域对象`Pet`

1	创建域对象`Pet`
2	设置 POST 请求和要连接到的 URL
3	将标头设置为`Content-Typeapplication/json`
4	用作请求正文`pet`
5	将响应转换为没有正文的响应实体。

1	创建域对象`Pet`
2	设置 POST 请求和要连接到的 URL
3	将标头设置为`Content-Typeapplication/json`
4	用作请求正文`pet`
5	将响应转换为没有正文的响应实体。

1	为返回 404 状态代码的 URL 创建 GET 请求
2	为所有 4xx 状态代码设置状态处理程序
3	引发自定义异常

1	为返回 404 状态代码的 URL 创建 GET 请求
2	为所有 4xx 状态代码设置状态处理程序
3	引发自定义异常

1	`exchange`提供请求和响应
2	当响应具有 4xx 状态代码时引发异常
3	将响应转换为 Pet 域对象

1	`exchange`提供请求和响应
2	当响应具有 4xx 状态代码时引发异常
3	将响应转换为 Pet 域对象

表 1.HttpMessageConverter 实现
消息转换器	描述
`StringHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入实例的实现。默认情况下，此转换器支持所有文本媒体类型（），并使用的写入。`HttpMessageConverterStringtext/*Content-Typetext/plain`Spring中文文档
`FormHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入表单数据的实现。默认情况下，此转换器读取和写入媒体类型。表单数据从 . 转换器还可以写入（但不能读取）从 . 默认情况下，受支持。可以支持其他多部分子类型来写入表单数据。有关更多详细信息，请参阅 javadoc。`HttpMessageConverterapplication/x-www-form-urlencodedMultiValueMap<String, String>MultiValueMap<String, Object>multipart/form-dataFormHttpMessageConverter`Spring中文文档
`ByteArrayHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入字节数组的实现。默认情况下，此转换器支持所有媒体类型（），并使用的写入。可以通过设置属性并重写来覆盖此设置。`HttpMessageConverter/Content-Typeapplication/octet-streamsupportedMediaTypesgetContentType(byte[])`Spring中文文档
`MarshallingHttpMessageConverter`Spring中文文档	一个可以通过使用 Spring 和包中的抽象来读取和写入 XML 的实现。此转换器在使用之前需要 and。您可以通过构造函数或 Bean 属性注入这些属性。默认情况下，此转换器支持和。`HttpMessageConverterMarshallerUnmarshallerorg.springframework.oxmMarshallerUnmarshallertext/xmlapplication/xml`Spring中文文档
`MappingJackson2HttpMessageConverter`Spring中文文档	可以使用 Jackson 的 . 您可以通过使用 Jackson 提供的注释根据需要自定义 JSON 映射。当需要进一步控制时（对于需要为特定类型提供自定义 JSON 序列化程序/反序列化程序的情况），可以通过该属性注入自定义项。默认情况下，此转换器支持 .`HttpMessageConverterObjectMapperObjectMapperObjectMapperapplication/json`Spring中文文档
`MappingJackson2XmlHttpMessageConverter`Spring中文文档	可以使用 Jackson XML 扩展的 . 您可以根据需要使用 JAXB 或 Jackson 提供的注释来自定义 XML 映射。当需要进一步控制时（对于需要为特定类型提供自定义 XML 序列化程序/反序列化程序的情况），可以通过该属性注入自定义项。默认情况下，此转换器支持 .`HttpMessageConverterXmlMapperXmlMapperObjectMapperapplication/xml`Spring中文文档
`SourceHttpMessageConverter`Spring中文文档	可以从 HTTP 请求和响应读取和写入的实现。仅支持、和。默认情况下，此转换器支持和。`HttpMessageConverterjavax.xml.transform.SourceDOMSourceSAXSourceStreamSourcetext/xmlapplication/xml`Spring中文文档

请注意，在访问表示错误的响应状态（例如 401）时，可能会引发异常。如果这是一个问题，请使用任何替代请求工厂。SimpleClientHttpRequestFactory

`WebClient`

WebClient是用于执行 HTTP 请求的非阻塞反应式客户端。它是在 5.0 中引入，并提供了的替代方案，支持同步、异步和流式处理方案。RestTemplateSpring中文文档

WebClient支持以下功能：Spring中文文档

非阻塞 I/OSpring中文文档
反应流背压Spring中文文档
硬件资源少，高并发Spring中文文档
利用 Java 8 lambda 的功能式流畅 APISpring中文文档
同步和异步交互Spring中文文档
向上流式传输到服务器或从服务器向式传输Spring中文文档

有关详细信息，请参阅 WebClient。Spring中文文档

`RestTemplate`

它以经典的 Spring Template 类的形式提供了基于 HTTP 客户端库的高级 API。它公开了以下重载方法组：RestTemplateSpring中文文档

RestClient 为同步 HTTP 访问提供了更现代的 API。对于异步和流式处理方案，请考虑反应式 WebClient。

表 2.RestTemplate 方法
方法组	描述
`getForObject`Spring中文文档	通过 GET 检索表示。Spring中文文档
`getForEntity`Spring中文文档	使用 GET 检索（即 status、headers 和 body）。`ResponseEntity`Spring中文文档
`headForHeaders`Spring中文文档	使用 HEAD 检索资源的所有标头。Spring中文文档
`postForLocation`Spring中文文档	使用 POST 创建新资源，并从响应中返回标头。`Location`Spring中文文档
`postForObject`Spring中文文档	使用 POST 创建新资源，并从响应中返回表示形式。Spring中文文档
`postForEntity`Spring中文文档	使用 POST 创建新资源，并从响应中返回表示形式。Spring中文文档
`put`Spring中文文档	使用 PUT 创建或更新资源。Spring中文文档
`patchForObject`Spring中文文档	使用 PATCH 更新资源，并从响应中返回表示形式。请注意，JDK 不支持，但 Apache HttpComponents 和其他支持。`HttpURLConnectionPATCH`Spring中文文档
`delete`Spring中文文档	使用 DELETE 删除指定 URI 处的资源。Spring中文文档
`optionsForAllow`Spring中文文档	使用 ALLOW 检索资源允许的 HTTP 方法。Spring中文文档
`exchange`Spring中文文档	上述方法的更通用（且不那么固执己见）版本，可在需要时提供额外的灵活性。它接受 a（包括 HTTP 方法、URL、标头和正文作为输入）并返回 .`RequestEntityResponseEntity`Spring中文文档这些方法允许使用而不是指定具有泛型的响应类型。`ParameterizedTypeReferenceClass`Spring中文文档
`execute`Spring中文文档	执行请求的最通用方式，可完全控制请求通过回调接口进行准备和响应提取。Spring中文文档

初始化

RestTemplate使用与相同的 HTTP 库抽象。默认情况下，它使用，但这可以通过构造函数进行更改。请参阅客户端请求工厂。RestClientSimpleClientHttpRequestFactorySpring中文文档

RestTemplate可以检测可观察性，以生成指标和跟踪。请参阅 RestTemplate 可观测性支持部分。

身体

传入和从方法返回的对象在的帮助下与 HTTP 消息之间相互转换，请参见HTTP 消息转换。RestTemplateHttpMessageConverterSpring中文文档

从迁移到`RestTemplateRestClient`

下表显示了方法的等效项。它可用于从后者迁移到前者。RestClientRestTemplateSpring中文文档

表 3.RestTemplate 方法的 RestClient 等效项
`RestTemplate`方法	`RestClient`等效
`getForObject(String, Class, Object…)`Spring中文文档	`get() .uri(String, Object…) .retrieve() .body(Class)`Spring中文文档
`getForObject(String, Class, Map)`Spring中文文档	`get() .uri(String, Map) .retrieve() .body(Class)`Spring中文文档
`getForObject(URI, Class)`Spring中文文档	`get() .uri(URI) .retrieve() .body(Class)`Spring中文文档
`getForEntity(String, Class, Object…)`Spring中文文档	`get() .uri(String, Object…) .retrieve() .toEntity(Class)`Spring中文文档
`getForEntity(String, Class, Map)`Spring中文文档	`get() .uri(String, Map) .retrieve() .toEntity(Class)`Spring中文文档
`getForEntity(URI, Class)`Spring中文文档	`get() .uri(URI) .retrieve() .toEntity(Class)`Spring中文文档
`headForHeaders(String, Object…)`Spring中文文档	`head() .uri(String, Object…) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`headForHeaders(String, Map)`Spring中文文档	`head() .uri(String, Map) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`headForHeaders(URI)`Spring中文文档	`head() .uri(URI) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`postForLocation(String, Object, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object).retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForLocation(String, Object, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForLocation(URI, Object)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForObject(String, Object, Class, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForObject(String, Object, Class, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForObject(URI, Object, Class)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForEntity(String, Object, Class, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`postForEntity(String, Object, Class, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`postForEntity(URI, Object, Class)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`put(String, Object, Object…)`Spring中文文档	`put() .uri(String, Object…) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`put(String, Object, Map)`Spring中文文档	`put() .uri(String, Map) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`put(URI, Object)`Spring中文文档	`put() .uri(URI) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`patchForObject(String, Object, Class, Object…)`Spring中文文档	`patch() .uri(String, Object…) .body(Object) .retrieve() .body(Class)`Spring中文文档
`patchForObject(String, Object, Class, Map)`Spring中文文档	`patch() .uri(String, Map) .body(Object) .retrieve() .body(Class)`Spring中文文档
`patchForObject(URI, Object, Class)`Spring中文文档	`patch() .uri(URI) .body(Object) .retrieve() .body(Class)`Spring中文文档
`delete(String, Object…)`Spring中文文档	`delete() .uri(String, Object…) .retrieve() .toBodilessEntity()`Spring中文文档
`delete(String, Map)`Spring中文文档	`delete() .uri(String, Map) .retrieve() .toBodilessEntity()`Spring中文文档
`delete(URI)`Spring中文文档	`delete() .uri(URI) .retrieve() .toBodilessEntity()`Spring中文文档
`optionsForAllow(String, Object…)`Spring中文文档	`options() .uri(String, Object…) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`optionsForAllow(String, Map)`Spring中文文档	`options() .uri(String, Map) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`optionsForAllow(URI)`Spring中文文档	`options() .uri(URI) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`exchange(String, HttpMethod, HttpEntity, Class, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, Class, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(URI, HttpMethod, HttpEntity, Class)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, ParameterizedTypeReference, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, ParameterizedTypeReference, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(URI, HttpMethod, HttpEntity, ParameterizedTypeReference)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(RequestEntity, Class)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[2]Spring中文文档
`exchange(RequestEntity, ParameterizedTypeReference)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[2]Spring中文文档
`execute(String, HttpMethod, RequestCallback, ResponseExtractor, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .exchange(ExchangeFunction)`Spring中文文档
`execute(String, HttpMethod, RequestCallback, ResponseExtractor, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .exchange(ExchangeFunction)`Spring中文文档
`execute(URI, HttpMethod, RequestCallback, ResponseExtractor)`Spring中文文档	`method(HttpMethod) .uri(URI) .exchange(ExchangeFunction)`Spring中文文档

RestClient 为同步 HTTP 访问提供了更现代的 API。对于异步和流式处理方案，请考虑反应式 WebClient。

表 2.RestTemplate 方法
方法组	描述
`getForObject`Spring中文文档	通过 GET 检索表示。Spring中文文档
`getForEntity`Spring中文文档	使用 GET 检索（即 status、headers 和 body）。`ResponseEntity`Spring中文文档
`headForHeaders`Spring中文文档	使用 HEAD 检索资源的所有标头。Spring中文文档
`postForLocation`Spring中文文档	使用 POST 创建新资源，并从响应中返回标头。`Location`Spring中文文档
`postForObject`Spring中文文档	使用 POST 创建新资源，并从响应中返回表示形式。Spring中文文档
`postForEntity`Spring中文文档	使用 POST 创建新资源，并从响应中返回表示形式。Spring中文文档
`put`Spring中文文档	使用 PUT 创建或更新资源。Spring中文文档
`patchForObject`Spring中文文档	使用 PATCH 更新资源，并从响应中返回表示形式。请注意，JDK 不支持，但 Apache HttpComponents 和其他支持。`HttpURLConnectionPATCH`Spring中文文档
`delete`Spring中文文档	使用 DELETE 删除指定 URI 处的资源。Spring中文文档
`optionsForAllow`Spring中文文档	使用 ALLOW 检索资源允许的 HTTP 方法。Spring中文文档
`exchange`Spring中文文档	上述方法的更通用（且不那么固执己见）版本，可在需要时提供额外的灵活性。它接受 a（包括 HTTP 方法、URL、标头和正文作为输入）并返回 .`RequestEntityResponseEntity`Spring中文文档这些方法允许使用而不是指定具有泛型的响应类型。`ParameterizedTypeReferenceClass`Spring中文文档
`execute`Spring中文文档	执行请求的最通用方式，可完全控制请求通过回调接口进行准备和响应提取。Spring中文文档

RestTemplate可以检测可观察性，以生成指标和跟踪。请参阅 RestTemplate 可观测性支持部分。

表 3.RestTemplate 方法的 RestClient 等效项
`RestTemplate`方法	`RestClient`等效
`getForObject(String, Class, Object…)`Spring中文文档	`get() .uri(String, Object…) .retrieve() .body(Class)`Spring中文文档
`getForObject(String, Class, Map)`Spring中文文档	`get() .uri(String, Map) .retrieve() .body(Class)`Spring中文文档
`getForObject(URI, Class)`Spring中文文档	`get() .uri(URI) .retrieve() .body(Class)`Spring中文文档
`getForEntity(String, Class, Object…)`Spring中文文档	`get() .uri(String, Object…) .retrieve() .toEntity(Class)`Spring中文文档
`getForEntity(String, Class, Map)`Spring中文文档	`get() .uri(String, Map) .retrieve() .toEntity(Class)`Spring中文文档
`getForEntity(URI, Class)`Spring中文文档	`get() .uri(URI) .retrieve() .toEntity(Class)`Spring中文文档
`headForHeaders(String, Object…)`Spring中文文档	`head() .uri(String, Object…) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`headForHeaders(String, Map)`Spring中文文档	`head() .uri(String, Map) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`headForHeaders(URI)`Spring中文文档	`head() .uri(URI) .retrieve() .toBodilessEntity() .getHeaders()`Spring中文文档
`postForLocation(String, Object, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object).retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForLocation(String, Object, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForLocation(URI, Object)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .toBodilessEntity() .getLocation()`Spring中文文档
`postForObject(String, Object, Class, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForObject(String, Object, Class, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForObject(URI, Object, Class)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .body(Class)`Spring中文文档
`postForEntity(String, Object, Class, Object…)`Spring中文文档	`post() .uri(String, Object…) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`postForEntity(String, Object, Class, Map)`Spring中文文档	`post() .uri(String, Map) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`postForEntity(URI, Object, Class)`Spring中文文档	`post() .uri(URI) .body(Object) .retrieve() .toEntity(Class)`Spring中文文档
`put(String, Object, Object…)`Spring中文文档	`put() .uri(String, Object…) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`put(String, Object, Map)`Spring中文文档	`put() .uri(String, Map) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`put(URI, Object)`Spring中文文档	`put() .uri(URI) .body(Object) .retrieve() .toBodilessEntity()`Spring中文文档
`patchForObject(String, Object, Class, Object…)`Spring中文文档	`patch() .uri(String, Object…) .body(Object) .retrieve() .body(Class)`Spring中文文档
`patchForObject(String, Object, Class, Map)`Spring中文文档	`patch() .uri(String, Map) .body(Object) .retrieve() .body(Class)`Spring中文文档
`patchForObject(URI, Object, Class)`Spring中文文档	`patch() .uri(URI) .body(Object) .retrieve() .body(Class)`Spring中文文档
`delete(String, Object…)`Spring中文文档	`delete() .uri(String, Object…) .retrieve() .toBodilessEntity()`Spring中文文档
`delete(String, Map)`Spring中文文档	`delete() .uri(String, Map) .retrieve() .toBodilessEntity()`Spring中文文档
`delete(URI)`Spring中文文档	`delete() .uri(URI) .retrieve() .toBodilessEntity()`Spring中文文档
`optionsForAllow(String, Object…)`Spring中文文档	`options() .uri(String, Object…) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`optionsForAllow(String, Map)`Spring中文文档	`options() .uri(String, Map) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`optionsForAllow(URI)`Spring中文文档	`options() .uri(URI) .retrieve() .toBodilessEntity() .getAllow()`Spring中文文档
`exchange(String, HttpMethod, HttpEntity, Class, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, Class, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(URI, HttpMethod, HttpEntity, Class)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, ParameterizedTypeReference, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(String, HttpMethod, HttpEntity, ParameterizedTypeReference, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(URI, HttpMethod, HttpEntity, ParameterizedTypeReference)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[1]Spring中文文档
`exchange(RequestEntity, Class)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(Class)` ^[2]Spring中文文档
`exchange(RequestEntity, ParameterizedTypeReference)`Spring中文文档	`method(HttpMethod) .uri(URI) .headers(Consumer<HttpHeaders>) .body(Object) .retrieve() .toEntity(ParameterizedTypeReference)` ^[2]Spring中文文档
`execute(String, HttpMethod, RequestCallback, ResponseExtractor, Object…)`Spring中文文档	`method(HttpMethod) .uri(String, Object…) .exchange(ExchangeFunction)`Spring中文文档
`execute(String, HttpMethod, RequestCallback, ResponseExtractor, Map)`Spring中文文档	`method(HttpMethod) .uri(String, Map) .exchange(ExchangeFunction)`Spring中文文档
`execute(URI, HttpMethod, RequestCallback, ResponseExtractor)`Spring中文文档	`method(HttpMethod) .uri(URI) .exchange(ExchangeFunction)`Spring中文文档

HTTP 接口

Spring Framework 允许您将 HTTP 服务定义为带有方法的 Java 接口。您可以将此类接口传递给以创建一个代理，该代理通过 HTTP 客户端（如或）执行请求。您还可以从 for 服务器实现接口请求处理。@HttpExchangeHttpServiceProxyFactoryRestClientWebClient@ControllerSpring中文文档

首先使用以下方法创建接口：@HttpExchangeSpring中文文档

interface RepositoryService {

	@GetExchange("/repos/{owner}/{repo}")
	Repository getRepository(@PathVariable String owner, @PathVariable String repo);

	// more HTTP exchange methods...

}

现在，您可以创建一个代理，用于在调用方法时执行请求。Spring中文文档

为：RestClientSpring中文文档

RestClient restClient = RestClient.builder().baseUrl("https://api.github.com/").build();
RestClientAdapter adapter = RestClientAdapter.create(restClient);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter).build();

RepositoryService service = factory.createClient(RepositoryService.class);

为：WebClientSpring中文文档

WebClient webClient = WebClient.builder().baseUrl("https://api.github.com/").build();
WebClientAdapter adapter = WebClientAdapter.create(webClient);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter).build();

RepositoryService service = factory.createClient(RepositoryService.class);

为：RestTemplateSpring中文文档

RestTemplate restTemplate = new RestTemplate();
restTemplate.setUriTemplateHandler(new DefaultUriBuilderFactory("https://api.github.com/"));
RestTemplateAdapter adapter = RestTemplateAdapter.create(restTemplate);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter).build();

RepositoryService service = factory.createClient(RepositoryService.class);

@HttpExchange在适用于所有方法的类型级别受支持：Spring中文文档

@HttpExchange(url = "/repos/{owner}/{repo}", accept = "application/vnd.github.v3+json")
interface RepositoryService {

	@GetExchange
	Repository getRepository(@PathVariable String owner, @PathVariable String repo);

	@PatchExchange(contentType = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
	void updateRepository(@PathVariable String owner, @PathVariable String repo,
			@RequestParam String name, @RequestParam String description, @RequestParam String homepage);

}

方法参数

带注释的 HTTP 交换方法支持灵活的方法签名，具有以下功能方法参数：Spring中文文档

方法参数描述

方法参数	描述
`URI`Spring中文文档	动态设置请求的 URL，覆盖注释的属性。`url`Spring中文文档
`UriBuilderFactory`Spring中文文档	提供用于扩展 URI 模板和 URI 变量的 WITH。实际上，替换基础客户端的（及其基本 URL）。`UriBuilderFactoryUriBuilderFactory`Spring中文文档
`HttpMethod`Spring中文文档	动态设置请求的 HTTP 方法，覆盖注释的属性`method`Spring中文文档
`@RequestHeader`Spring中文文档	添加一个或多个请求标头。参数可以是具有多个标头的或、值的或个人价值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档
`@PathVariable`Spring中文文档	添加一个变量，以便在请求 URL 中展开占位符。参数可以是具有多个变量的 a，也可以是单个值。类型转换支持非 String 值。`Map<String, ?>`Spring中文文档
`@RequestAttribute`Spring中文文档	提供要添加为请求的属性。仅受支持。`ObjectWebClient`Spring中文文档
`@RequestBody`Spring中文文档	提供请求的正文作为要序列化的对象，或支持的反应式流（如、或任何其他异步类型）通过配置的 .`PublisherMonoFluxReactiveAdapterRegistry`Spring中文文档
`@RequestParam`Spring中文文档	添加一个或多个请求参数。参数可以是具有多个参数的 a、值的 a 或单个值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档当设置为时，请求参数在请求正文中编码。否则，它们将添加为 URL 查询参数。`"content-type""application/x-www-form-urlencoded"`Spring中文文档
`@RequestPart`Spring中文文档	添加请求部分，可以是 String（表单字段）、（文件部分）、对象（要编码的实体，例如 JSON）、（部分内容和标头）、弹簧，或上述任何一种的反应流。`ResourceHttpEntityPartPublisher`Spring中文文档
`MultipartFile`Spring中文文档	添加请求部分，通常用于 Spring MVC 控制器其中它表示上传的文件。`MultipartFile`Spring中文文档
`@CookieValue`Spring中文文档	添加一个或多个 Cookie。参数可以是具有多个 cookie 的或、值的或个人价值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档

URISpring中文文档

动态设置请求的 URL，覆盖注释的属性。urlSpring中文文档

UriBuilderFactorySpring中文文档

提供用于扩展 URI 模板和 URI 变量的 WITH。实际上，替换基础客户端的（及其基本 URL）。UriBuilderFactoryUriBuilderFactorySpring中文文档

HttpMethodSpring中文文档

动态设置请求的 HTTP 方法，覆盖注释的属性methodSpring中文文档

@RequestHeaderSpring中文文档

添加一个或多个请求标头。参数可以是具有多个标头的或、值的或个人价值。非 String 值支持类型转换。Map<String, ?>MultiValueMap<String, ?>Collection<?>Spring中文文档

@PathVariableSpring中文文档

添加一个变量，以便在请求 URL 中展开占位符。参数可以是具有多个变量的 a，也可以是单个值。类型转换支持非 String 值。Map<String, ?>Spring中文文档

@RequestAttributeSpring中文文档

提供要添加为请求的属性。仅受支持。ObjectWebClientSpring中文文档

@RequestBodySpring中文文档

提供请求的正文作为要序列化的对象，或支持的反应式流（如、或任何其他异步类型）通过配置的 .PublisherMonoFluxReactiveAdapterRegistrySpring中文文档

@RequestParamSpring中文文档

添加一个或多个请求参数。参数可以是具有多个参数的 a、值的 a 或单个值。非 String 值支持类型转换。Map<String, ?>MultiValueMap<String, ?>Collection<?>Spring中文文档

当设置为时，请求参数在请求正文中编码。否则，它们将添加为 URL 查询参数。"content-type""application/x-www-form-urlencoded"Spring中文文档

@RequestPartSpring中文文档

添加请求部分，可以是 String（表单字段）、（文件部分）、对象（要编码的实体，例如 JSON）、（部分内容和标头）、弹簧，或上述任何一种的反应流。ResourceHttpEntityPartPublisherSpring中文文档

MultipartFileSpring中文文档

添加请求部分，通常用于 Spring MVC 控制器其中它表示上传的文件。MultipartFileSpring中文文档

@CookieValueSpring中文文档

添加一个或多个 Cookie。参数可以是具有多个 cookie 的或、值的或个人价值。非 String 值支持类型转换。Map<String, ?>MultiValueMap<String, ?>Collection<?>Spring中文文档

返回值

支持的返回值取决于基础客户端。Spring中文文档

适用于并支持同步返回值的客户端：HttpExchangeAdapterRestClientRestTemplateSpring中文文档

方法返回值描述

方法返回值	描述
`void`Spring中文文档	执行给定的请求。Spring中文文档
`HttpHeaders`Spring中文文档	执行给定的请求并返回响应标头。Spring中文文档
`<T>`Spring中文文档	执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档
`ResponseEntity<Void>`Spring中文文档	执行给定的请求并返回带有状态和标头的 a。`ResponseEntity`Spring中文文档
`ResponseEntity<T>`Spring中文文档	执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。`ResponseEntity`Spring中文文档

voidSpring中文文档

执行给定的请求。Spring中文文档

HttpHeadersSpring中文文档

执行给定的请求并返回响应标头。Spring中文文档

<T>Spring中文文档

执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档

ResponseEntity<Void>Spring中文文档

执行给定的请求并返回带有状态和标头的 a。ResponseEntitySpring中文文档

ResponseEntity<T>Spring中文文档

执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。ResponseEntitySpring中文文档

客户端适应如，支持以上所有以及反应性变体。下表显示了反应器类型，但您也可以使用通过以下方式支持的其他反应式类型：ReactorHttpExchangeAdapterWebClientReactiveAdapterRegistrySpring中文文档

方法返回值描述

方法返回值	描述
`Mono<Void>`Spring中文文档	执行给定的请求，并发布响应内容（如果有）。Spring中文文档
`Mono<HttpHeaders>`Spring中文文档	执行给定的请求，释放响应内容（如果有），然后返回响应标头。Spring中文文档
`Mono<T>`Spring中文文档	执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档
`Flux<T>`Spring中文文档	执行给定的请求并将响应内容解码为声明的流元素类型。Spring中文文档
`Mono<ResponseEntity<Void>>`Spring中文文档	执行给定的请求，并释放响应内容（如果有），并返回带有状态和标头的 a。`ResponseEntity`Spring中文文档
`Mono<ResponseEntity<T>>`Spring中文文档	执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。`ResponseEntity`Spring中文文档
`Mono<ResponseEntity<Flux<T>>`Spring中文文档	执行给定的请求，将响应内容解码为声明的流元素类型，并返回 A 与状态、标头和解码响应正文流。`ResponseEntity`Spring中文文档

Mono<Void>Spring中文文档

执行给定的请求，并发布响应内容（如果有）。Spring中文文档

Mono<HttpHeaders>Spring中文文档

执行给定的请求，释放响应内容（如果有），然后返回响应标头。Spring中文文档

Mono<T>Spring中文文档

执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档

Flux<T>Spring中文文档

执行给定的请求并将响应内容解码为声明的流元素类型。Spring中文文档

Mono<ResponseEntity<Void>>Spring中文文档

执行给定的请求，并释放响应内容（如果有），并返回带有状态和标头的 a。ResponseEntitySpring中文文档

Mono<ResponseEntity<T>>Spring中文文档

执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。ResponseEntitySpring中文文档

Mono<ResponseEntity<Flux<T>>Spring中文文档

执行给定的请求，将响应内容解码为声明的流元素类型，并返回 A 与状态、标头和解码响应正文流。ResponseEntitySpring中文文档

默认情况下，同步返回值的超时取决于基础 HTTP 客户端的配置方式。您也可以在适配器级别上设置一个值，但我们建议依赖底层 HTTP 客户端，它在较低级别运行并提供更多控制。ReactorHttpExchangeAdapterblockTimeoutSpring中文文档

错误处理

要自定义错误响应处理，您需要配置基础 HTTP 客户端。Spring中文文档

为：RestClientSpring中文文档

默认情况下，引发 4xx 和 5xx HTTP 状态代码。若要自定义此项，请注册适用于所有响应的响应状态处理程序通过客户端执行：RestClientRestClientExceptionSpring中文文档

RestClient restClient = RestClient.builder()
		.defaultStatusHandler(HttpStatusCode::isError, (request, response) -> ...)
		.build();

RestClientAdapter adapter = RestClientAdapter.create(restClient);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter).build();

有关更多详细信息和选项，例如禁止显示错误状态代码，请参阅 in 的 Javadoc。defaultStatusHandlerRestClient.BuilderSpring中文文档

为：WebClientSpring中文文档

默认情况下，引发 4xx 和 5xx HTTP 状态代码。若要自定义此项，请注册适用于所有响应的响应状态处理程序通过客户端执行：WebClientWebClientResponseExceptionSpring中文文档

WebClient webClient = WebClient.builder()
		.defaultStatusHandler(HttpStatusCode::isError, resp -> ...)
		.build();

WebClientAdapter adapter = WebClientAdapter.create(webClient);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(adapter).build();

有关更多详细信息和选项，例如禁止显示错误状态代码，请参阅 in 的 Javadoc。defaultStatusHandlerWebClient.BuilderSpring中文文档

为：RestTemplateSpring中文文档

默认情况下，引发 4xx 和 5xx HTTP 状态代码。若要自定义此项，请注册适用于所有响应的错误处理程序通过客户端执行：RestTemplateRestClientExceptionSpring中文文档

RestTemplate restTemplate = new RestTemplate();
restTemplate.setErrorHandler(myErrorHandler);

RestTemplateAdapter adapter = RestTemplateAdapter.create(restTemplate);
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter).build();

有关更多详细信息和选项，请参阅 in 和的 Javadoc 层次结构。setErrorHandlerRestTemplateResponseErrorHandlerSpring中文文档

方法参数描述

方法参数	描述
`URI`Spring中文文档	动态设置请求的 URL，覆盖注释的属性。`url`Spring中文文档
`UriBuilderFactory`Spring中文文档	提供用于扩展 URI 模板和 URI 变量的 WITH。实际上，替换基础客户端的（及其基本 URL）。`UriBuilderFactoryUriBuilderFactory`Spring中文文档
`HttpMethod`Spring中文文档	动态设置请求的 HTTP 方法，覆盖注释的属性`method`Spring中文文档
`@RequestHeader`Spring中文文档	添加一个或多个请求标头。参数可以是具有多个标头的或、值的或个人价值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档
`@PathVariable`Spring中文文档	添加一个变量，以便在请求 URL 中展开占位符。参数可以是具有多个变量的 a，也可以是单个值。类型转换支持非 String 值。`Map<String, ?>`Spring中文文档
`@RequestAttribute`Spring中文文档	提供要添加为请求的属性。仅受支持。`ObjectWebClient`Spring中文文档
`@RequestBody`Spring中文文档	提供请求的正文作为要序列化的对象，或支持的反应式流（如、或任何其他异步类型）通过配置的 .`PublisherMonoFluxReactiveAdapterRegistry`Spring中文文档
`@RequestParam`Spring中文文档	添加一个或多个请求参数。参数可以是具有多个参数的 a、值的 a 或单个值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档当设置为时，请求参数在请求正文中编码。否则，它们将添加为 URL 查询参数。`"content-type""application/x-www-form-urlencoded"`Spring中文文档
`@RequestPart`Spring中文文档	添加请求部分，可以是 String（表单字段）、（文件部分）、对象（要编码的实体，例如 JSON）、（部分内容和标头）、弹簧，或上述任何一种的反应流。`ResourceHttpEntityPartPublisher`Spring中文文档
`MultipartFile`Spring中文文档	添加请求部分，通常用于 Spring MVC 控制器其中它表示上传的文件。`MultipartFile`Spring中文文档
`@CookieValue`Spring中文文档	添加一个或多个 Cookie。参数可以是具有多个 cookie 的或、值的或个人价值。非 String 值支持类型转换。`Map<String, ?>MultiValueMap<String, ?>Collection<?>`Spring中文文档

URISpring中文文档

动态设置请求的 URL，覆盖注释的属性。urlSpring中文文档

UriBuilderFactorySpring中文文档

提供用于扩展 URI 模板和 URI 变量的 WITH。实际上，替换基础客户端的（及其基本 URL）。UriBuilderFactoryUriBuilderFactorySpring中文文档

HttpMethodSpring中文文档

动态设置请求的 HTTP 方法，覆盖注释的属性methodSpring中文文档

@RequestHeaderSpring中文文档

@PathVariableSpring中文文档

添加一个变量，以便在请求 URL 中展开占位符。参数可以是具有多个变量的 a，也可以是单个值。类型转换支持非 String 值。Map<String, ?>Spring中文文档

@RequestAttributeSpring中文文档

提供要添加为请求的属性。仅受支持。ObjectWebClientSpring中文文档

@RequestBodySpring中文文档

提供请求的正文作为要序列化的对象，或支持的反应式流（如、或任何其他异步类型）通过配置的 .PublisherMonoFluxReactiveAdapterRegistrySpring中文文档

@RequestParamSpring中文文档

当设置为时，请求参数在请求正文中编码。否则，它们将添加为 URL 查询参数。"content-type""application/x-www-form-urlencoded"Spring中文文档

@RequestPartSpring中文文档

MultipartFileSpring中文文档

添加请求部分，通常用于 Spring MVC 控制器其中它表示上传的文件。MultipartFileSpring中文文档

@CookieValueSpring中文文档

方法返回值描述

方法返回值	描述
`void`Spring中文文档	执行给定的请求。Spring中文文档
`HttpHeaders`Spring中文文档	执行给定的请求并返回响应标头。Spring中文文档
`<T>`Spring中文文档	执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档
`ResponseEntity<Void>`Spring中文文档	执行给定的请求并返回带有状态和标头的 a。`ResponseEntity`Spring中文文档
`ResponseEntity<T>`Spring中文文档	执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。`ResponseEntity`Spring中文文档

voidSpring中文文档

执行给定的请求。Spring中文文档

HttpHeadersSpring中文文档

执行给定的请求并返回响应标头。Spring中文文档

<T>Spring中文文档

执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档

ResponseEntity<Void>Spring中文文档

执行给定的请求并返回带有状态和标头的 a。ResponseEntitySpring中文文档

ResponseEntity<T>Spring中文文档

执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。ResponseEntitySpring中文文档

方法返回值描述

方法返回值	描述
`Mono<Void>`Spring中文文档	执行给定的请求，并发布响应内容（如果有）。Spring中文文档
`Mono<HttpHeaders>`Spring中文文档	执行给定的请求，释放响应内容（如果有），然后返回响应标头。Spring中文文档
`Mono<T>`Spring中文文档	执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档
`Flux<T>`Spring中文文档	执行给定的请求并将响应内容解码为声明的流元素类型。Spring中文文档
`Mono<ResponseEntity<Void>>`Spring中文文档	执行给定的请求，并释放响应内容（如果有），并返回带有状态和标头的 a。`ResponseEntity`Spring中文文档
`Mono<ResponseEntity<T>>`Spring中文文档	执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。`ResponseEntity`Spring中文文档
`Mono<ResponseEntity<Flux<T>>`Spring中文文档	执行给定的请求，将响应内容解码为声明的流元素类型，并返回 A 与状态、标头和解码响应正文流。`ResponseEntity`Spring中文文档

Mono<Void>Spring中文文档

执行给定的请求，并发布响应内容（如果有）。Spring中文文档

Mono<HttpHeaders>Spring中文文档

执行给定的请求，释放响应内容（如果有），然后返回响应标头。Spring中文文档

Mono<T>Spring中文文档

执行给定的请求，并将响应内容解码为声明的返回类型。Spring中文文档

Flux<T>Spring中文文档

执行给定的请求并将响应内容解码为声明的流元素类型。Spring中文文档

Mono<ResponseEntity<Void>>Spring中文文档

执行给定的请求，并释放响应内容（如果有），并返回带有状态和标头的 a。ResponseEntitySpring中文文档

Mono<ResponseEntity<T>>Spring中文文档

执行给定的请求，将响应内容解码为声明的返回类型，然后返回 A 以及状态、标头和解码正文。ResponseEntitySpring中文文档

Mono<ResponseEntity<Flux<T>>Spring中文文档

执行给定的请求，将响应内容解码为声明的流元素类型，并返回 A 与状态、标头和解码响应正文流。ResponseEntitySpring中文文档

1. 接头和主体必须提供给 Via 和 .HttpEntityRestClientheaders(Consumer<HttpHeaders>)body(Object)

2. 方法、URI、标头和正文必须提供给 via 、和。RequestEntityRestClientmethod(HttpMethod)uri(URI)headers(Consumer<HttpHeaders>)body(Object)

RestClient

创建RestClient

使用RestClient

请求 URL

请求标头和正文

检索响应

错误处理

交换

HTTP 消息转换

Jackson JSON 视图

多部分

客户端请求工厂

WebClient

RestTemplate

初始化

身体

从 迁移到RestTemplateRestClient

HTTP 接口

方法参数

返回值

错误处理

`RestClient`

创建`RestClient`

使用`RestClient`

`WebClient`

`RestTemplate`

从迁移到`RestTemplateRestClient`