spring-boot/spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/http-clients.adoc

[[howto.http-clients]]
== HTTP Clients
Spring Boot offers a number of starters that work with HTTP clients.
This section answers questions related to using them.


[[howto.http-clients.rest-template-proxy-configuration]]
=== Configure RestTemplate to Use a Proxy
As described in <<features#features.resttemplate.customization>>, you can use a `RestTemplateCustomizer` with `RestTemplateBuilder` to build a customized `RestTemplate`.
This is the recommended approach for creating a `RestTemplate` configured to use a proxy.

The exact details of the proxy configuration depend on the underlying client request factory that is being used.


[[howto.http-clients.webclient-reactor-netty-customization]]
=== Configure the TcpClient used by a Reactor Netty-based WebClient
When Reactor Netty is on the classpath a Reactor Netty-based `WebClient` is auto-configured.
To customize the client's handling of network connections, provide a `ClientHttpConnector` bean.
The following example configures a 60 second connect timeout and adds a `ReadTimeoutHandler`:

[source,java,indent=0]
----
include::{docs-java}/howto/httpclients/webclientreactornettycustomization/MyReactorNettyClientConfiguration.java[]
----

TIP: Note the use of `ReactorResourceFactory` for the connection provider and event loop resources.
This ensures efficient sharing of resources for the server receiving requests and the client making requests.
Split up adoc files Closes gh-23254 2021-04-30 00:11:56 +08:00			`[[howto.http-clients]]`
			`== HTTP Clients`
			`Spring Boot offers a number of starters that work with HTTP clients.`
			`This section answers questions related to using them.`



			`[[howto.http-clients.rest-template-proxy-configuration]]`
			`=== Configure RestTemplate to Use a Proxy`
			As described in <<features#features.resttemplate.customization>>, you can use a `RestTemplateCustomizer` with `RestTemplateBuilder` to build a customized `RestTemplate`.
			This is the recommended approach for creating a `RestTemplate` configured to use a proxy.

			`The exact details of the proxy configuration depend on the underlying client request factory that is being used.`



			`[[howto.http-clients.webclient-reactor-netty-customization]]`
			`=== Configure the TcpClient used by a Reactor Netty-based WebClient`
			When Reactor Netty is on the classpath a Reactor Netty-based `WebClient` is auto-configured.
			To customize the client's handling of network connections, provide a `ClientHttpConnector` bean.
			The following example configures a 60 second connect timeout and adds a `ReadTimeoutHandler`:

			`[source,java,indent=0]`
			`----`
Polish docs code See gh-6313 2021-05-01 09:19:12 +08:00			`include::{docs-java}/howto/httpclients/webclientreactornettycustomization/MyReactorNettyClientConfiguration.java[]`
Split up adoc files Closes gh-23254 2021-04-30 00:11:56 +08:00			`----`

			TIP: Note the use of `ReactorResourceFactory` for the connection provider and event loop resources.
			`This ensures efficient sharing of resources for the server receiving requests and the client making requests.`