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 to perform HTTP requests with a fluent API.

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


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

`RestTemplate` is a synchronous client to perform 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 Endpoints] for details.

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

The Spring Frameworks 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 to choose an API style such as synchronous or reactive.

See xref:integration/rest-clients.adoc#rest-http-interface[REST Endpoints] 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

Asciidoc revision (chapter declarations, javadoc references, etc) 2018-10-25 21:15:58 +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

Asciidoc revision (chapter declarations, javadoc references, etc) 2018-10-25 21:15:58 +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
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			`WebClient` is a reactive client to perform HTTP requests with a fluent API.

			`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

Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +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
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			`RestTemplate` is a synchronous client to perform HTTP requests. It is the original
			`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
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 Endpoints] for details.`
Add documentation for interface proxy client Closes gh-28386 2022-05-09 16:49:28 +08:00
			`[[webmvc-http-interface]]`
			`== HTTP Interface`

			`The Spring Frameworks 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 to choose an API style such as synchronous or reactive.`

Fix cross references 2023-04-19 23:26:17 +08:00			`See xref:integration/rest-clients.adoc#rest-http-interface[REST Endpoints] for details.`