root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 8 Packages Projects Releases Wiki Activity

Update advice on RestTemplate 

Closes gh-24503
This commit is contained in:
Rossen Stoyanchev 2020-02-11 14:01:21 +00:00
parent 0a974511bd
commit e35d3b8bb5
3 changed files with 13 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
spring-web/src/main/java/org/springframework/web/client/RestTemplate.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright 2002-2019 the original author or authors. * Copyright 2002-2020 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@ -72,13 +72,10 @@ import org.springframework.web.util.UriTemplateHandler;
* addition to the generalized {@code exchange} and {@code execute} methods that * addition to the generalized {@code exchange} and {@code execute} methods that
* support of less frequent cases. * support of less frequent cases.
* *
* <p><strong>NOTE:</strong> As of 5.0, the non-blocking, reactive * <p><strong>NOTE:</strong> As of 5.0 this class is in maintenance mode, with
* {@code org.springframework.web.reactive.client.WebClient} offers a * only minor requests for changes and bugs to be accepted going forward. Please,
* modern alternative to the {@code RestTemplate} with efficient support for * consider using the {@code org.springframework.web.reactive.client.WebClient}
* both sync and async, as well as streaming scenarios. The {@code RestTemplate} * which has a more modern API and supports sync, async, and streaming scenarios.
* will be deprecated in a future version and will not have major new features
* added going forward. See the WebClient section of the Spring Framework reference
* documentation for more details and example code.
* *
* @author Arjen Poutsma * @author Arjen Poutsma
* @author Brian Clozel * @author Brian Clozel

8
src/docs/asciidoc/integration.adoc
View File

@ -920,10 +920,10 @@ method API.
* <<web-reactive.adoc#webflux-client, WebClient>>: a non-blocking, reactive alternative * <<web-reactive.adoc#webflux-client, WebClient>>: a non-blocking, reactive alternative
that supports both synchronous and asynchronous as well as streaming scenarios. that supports both synchronous and asynchronous as well as streaming scenarios.
NOTE: As of 5.0, the non-blocking, reactive `WebClient` offers a modern alternative to the NOTE: As of 5.0 the `RestTemplate` is in maintenance mode, with only minor requests for
`RestTemplate` with efficient support for both synchronous and asynchronous as well as streaming changes and bugs to be accepted going forward. Please, consider using the
scenarios. The `RestTemplate` will be deprecated in a future version and will not have <<web-reactive.adoc#webflux-client, WebClient>> which offers a more modern API and
major new features added going forward. supports sync, async, and streaming scenarios.
[[rest-resttemplate]] [[rest-resttemplate]]

10
src/docs/asciidoc/web/webmvc-client.adoc
View File

@ -13,12 +13,10 @@ This section describes options for client-side access to REST endpoints.
Spring REST client and exposes a simple, template-method API over underlying HTTP client Spring REST client and exposes a simple, template-method API over underlying HTTP client
libraries. libraries.
NOTE: As of 5.0, the non-blocking, reactive `WebClient` offers a modern alternative to the NOTE: As of 5.0 the `RestTemplate` is in maintenance mode, with only minor requests for
`RestTemplate`, with efficient support for both changes and bugs to be accepted going forward. Please, consider using the
<<web-reactive.adoc#webflux-client-synchronous, synchronous and asynchronous>>, as well as <<web-reactive.adoc#webflux-client, WebClient>> which offers a more modern API and
streaming scenarios. The `RestTemplate` will be deprecated in a future version and will supports sync, async, and streaming scenarios.
not have major new features added going forward.
See <<integration.adoc#rest-client-access, REST Endpoints>> for details. See <<integration.adoc#rest-client-access, REST Endpoints>> for details.