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

Flesh out the documentation on RestTemplateBuilder customization 

Closes gh-7054
This commit is contained in:
Andy Wilkinson 2016-11-01 11:06:38 +00:00
parent 4919c6f30c
commit be78dc4b99
1 changed files with 15 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc
View File

@ -4546,11 +4546,17 @@ configure a `RestTemplate`. For example, to add BASIC auth support you can use
[[boot-features-restclient-customization]] [[boot-features-restclient-customization]]
=== RestTemplate customization === RestTemplate customization
When a `RestTemplateBuilder` builds a `RestTemplate` it can be further customized using There are three main approaches to `RestTemplate` customization, depending on how broadly
a `RestTemplateCustomizer`. Any `RestTemplateCustomizer` beans will be automatically to want the customizations to apply.
added to the auto-configured `RestTemplateBuilder`. Furthermore, a new
`RestTemplateBuilder` with additional customizers can be created by calling To make the scope of any customizations as narrow as possible, inject the auto-configured
`additionalCustomizers(RestTemplateCustomizer...)`. `RestTemplateBuilder` and then calls its methods as required. Each method call returns a
new `RestTemplateBuilder` instance so the customizations will only affect this use of
the builder.
To make a application-wide, additive customization a `RestTemplateCustomizer` bean can be
used. All such beans are automatically registered with the auto-configured
`RestTemplateBuilder` and will be applied to any templates that are built with it.
Here's an example of a customizer that configures the use of a proxy for all hosts except Here's an example of a customizer that configures the use of a proxy for all hosts except
`192.168.0.5`: `192.168.0.5`:
@ -4560,6 +4566,10 @@ Here's an example of a customizer that configures the use of a proxy for all hos
include::{code-examples}/web/client/RestTemplateProxyCustomizationExample.java[tag=customizer] include::{code-examples}/web/client/RestTemplateProxyCustomizationExample.java[tag=customizer]
---- ----
Lastly, the most extreme (and rarely used) option is to create your own
`RestTemplateBuilder` bean. This will switch off the auto-configuration of a
`RestTemplateBuilder` and will prevent any `RestTemplateCustomizer` beans from being used.
[[boot-features-email]] [[boot-features-email]]