diff --git a/framework-docs/modules/ROOT/pages/integration/rest-clients.adoc b/framework-docs/modules/ROOT/pages/integration/rest-clients.adoc index 1cf4363b0e..73d2fcf728 100644 --- a/framework-docs/modules/ROOT/pages/integration/rest-clients.adoc +++ b/framework-docs/modules/ROOT/pages/integration/rest-clients.adoc @@ -928,6 +928,13 @@ Now, you're ready to create client proxies: // Use service methods for remote calls... ---- +HTTP service clients is a powerful and expressive choice for remote access over HTTP. +It allows one team to own the knowledge of how a REST API works, what parts are relevant +to a client application, what input and output types to create, what endpoint method +signatures are needed, what Javadoc to have, and so on. The resulting Java API guides and +is ready to use. + + [[rest-http-service-client-method-parameters]] === Method Parameters diff --git a/framework-docs/modules/ROOT/pages/web/webflux-http-service-client.adoc b/framework-docs/modules/ROOT/pages/web/webflux-http-service-client.adoc index 55280b4a34..f083a87545 100644 --- a/framework-docs/modules/ROOT/pages/web/webflux-http-service-client.adoc +++ b/framework-docs/modules/ROOT/pages/web/webflux-http-service-client.adoc @@ -4,6 +4,6 @@ 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. +flexibility in choosing an API style such as synchronous or reactive. See xref:integration/rest-clients.adoc#rest-http-service-client[HTTP Service Clients] for details.