spring-framework/framework-docs/modules/ROOT/pages/web/webmvc-client.adoc

[[webmvc-client]]
= REST Clients

This section describes options for client-side access to REST endpoints.


[[webmvc-restclient]]
== `RestClient`

`RestClient` is a synchronous HTTP client that exposes a modern, fluent API.

See xref:integration/rest-clients.adoc#rest-restclient[`RestClient`] for more details.


[[webmvc-webclient]]
== `WebClient`

`WebClient` is a reactive client for making HTTP requests with a fluent API.

See xref:web/webflux-webclient.adoc[`WebClient`] for more details.


[[webmvc-resttemplate]]
== `RestTemplate`

`RestTemplate` is a synchronous client for making HTTP requests. It is the original
Spring REST client and exposes a simple, template-method API over underlying HTTP client
libraries.

See xref:integration/rest-clients.adoc#rest-resttemplate[`RestTemplate`] for details.


[[webmvc-http-interface]]
== HTTP Interface

The Spring Framework lets you define an HTTP service as a Java interface with HTTP
exchange methods. You can then generate a proxy that implements this interface and
performs the exchanges. This helps to simplify HTTP remote access and provides additional
flexibility for choosing an API style such as synchronous or reactive.

See xref:integration/rest-clients.adoc#rest-http-interface[HTTP Interface] for details.
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00			`[[webmvc-client]]`
			`= REST Clients`

			`This section describes options for client-side access to REST endpoints.`

Consistent separation between chapters and after chapter titles 2017-10-19 02:24:17 +08:00
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00			`[[webmvc-restclient]]`
			== `RestClient`
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00			`RestClient` is a synchronous HTTP client that exposes a modern, fluent API.
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00			See xref:integration/rest-clients.adoc#rest-restclient[`RestClient`] for more details.
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00
Consistent separation between chapters and after chapter titles 2017-10-19 02:24:17 +08:00
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00			`[[webmvc-webclient]]`
Restore sub-section headings in web content Headings are optimized for how they appear in the left-hand side navitation menu, with context provided by parent headings, and not necessarily for how they read on their own. At 2nd and 3rd level of nesting, which is where most headings are, the wrapping becomes too distracting and the left-hand side navigation sprawling. 2018-10-06 03:54:38 +08:00			== `WebClient`
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00
Polish wording in web sections 2025-08-29 23:25:15 +08:00			`WebClient` is a reactive client for making HTTP requests with a fluent API.
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00
Polish wording in web sections 2025-08-29 23:25:15 +08:00			See xref:web/webflux-webclient.adoc[`WebClient`] for more details.
Summary of client-side REST options in MVC section 2017-10-14 01:24:33 +08:00
Update section in reference on WebClient Rename "Builder" sub-section to "Configuration" and move it in the beginning before all others since it explains how to create a client in the first place. Update content on Reactor Netty connector based on the API in 0.8 and specifically address Reactor Netty resources and lifecycle. Issue: SPR-16963 2018-08-14 20:48:14 +08:00
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00			`[[webmvc-resttemplate]]`
			== `RestTemplate`
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00
Polish wording in web sections 2025-08-29 23:25:15 +08:00			`RestTemplate` is a synchronous client for making HTTP requests. It is the original
Create RestClient documentation placeholder This commit creates a placeholder for future RestClient reference documentation. It also creats a link to RestClient from the RestTemplate javadoc. See gh-30826 2023-07-07 20:00:34 +08:00			`Spring REST client and exposes a simple, template-method API over underlying HTTP client`
			`libraries.`
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00
Polish wording in web sections 2025-08-29 23:25:15 +08:00			See xref:integration/rest-clients.adoc#rest-resttemplate[`RestTemplate`] for details.
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00
Consistent line breaks in reference documentation 2025-07-11 01:33:34 +08:00
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00			`[[webmvc-http-interface]]`
			`== HTTP Interface`

Polish wording in web sections 2025-08-29 23:25:15 +08:00			`The Spring Framework lets you define an HTTP service as a Java interface with HTTP`
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00			`exchange methods. You can then generate a proxy that implements this interface and`
			`performs the exchanges. This helps to simplify HTTP remote access and provides additional`
Polish wording in web sections 2025-08-29 23:25:15 +08:00			`flexibility for choosing an API style such as synchronous or reactive.`
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00
Polish wording in web sections 2025-08-29 23:25:15 +08:00			`See xref:integration/rest-clients.adoc#rest-http-interface[HTTP Interface] for details.`