Package org.springframework.boot.web.client

Class RestTemplateBuilder

java.lang.Object

org.springframework.boot.web.client.RestTemplateBuilder

public class RestTemplateBuilder
extends Object

Builder that can be used to configure and create a RestTemplate. Provides convenience methods to register converters, error handlers and UriTemplateHandlers.

By default, the built RestTemplate will attempt to use the most suitable ClientHttpRequestFactory, call detectRequestFactory(false) if you prefer to keep the default. In a typical auto-configured Spring Boot application this builder is available as a bean and can be injected whenever a RestTemplate is needed.

Since:

1.4.0

Author:

Stephane Nicoll, Phillip Webb, Andy Wilkinson, Brian Clozel, Dmytro Nosan, Kevin Strijbos, Ilya Lukyanovich, Scott Frederick

Constructor Summary

Constructors

Constructor	Description
RestTemplateBuilder(RestTemplateCustomizer... customizers)	Create a new RestTemplateBuilder instance.

Method Summary

Modifier and Type	Method	Description
RestTemplateBuilder	additionalCustomizers(Collection<? extends RestTemplateCustomizer> customizers)	Add RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	additionalCustomizers(RestTemplateCustomizer... customizers)	Add RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	additionalInterceptors(Collection<? extends ClientHttpRequestInterceptor> interceptors)	Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	additionalInterceptors(ClientHttpRequestInterceptor... interceptors)	Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	additionalMessageConverters(Collection<? extends HttpMessageConverter<?>> messageConverters)	Add additional HttpMessageConverters that should be used with the RestTemplate.
RestTemplateBuilder	additionalMessageConverters(HttpMessageConverter<?>... messageConverters)	Add additional HttpMessageConverters that should be used with the RestTemplate.
RestTemplateBuilder	additionalRequestCustomizers(Collection<? extends RestTemplateRequestCustomizer<?>> requestCustomizers)	Add the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest.
RestTemplateBuilder	additionalRequestCustomizers(RestTemplateRequestCustomizer<?>... requestCustomizers)	Add the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest.
RestTemplateBuilder	basicAuthentication(String username, String password)	Add HTTP Basic Authentication to requests with the given username/password pair, unless a custom Authorization header has been set before.
RestTemplateBuilder	basicAuthentication(String username, String password, Charset charset)	Add HTTP Basic Authentication to requests with the given username/password pair, unless a custom Authorization header has been set before.
RestTemplate	build()	Build a new RestTemplate instance and configure it using this builder.
<T extends RestTemplate> T	build(Class<T> restTemplateClass)	Build a new RestTemplate instance of the specified type and configure it using this builder.
ClientHttpRequestFactory	buildRequestFactory()	Build a new ClientHttpRequestFactory instance using the settings of this builder.
<T extends RestTemplate> T	configure(T restTemplate)	Configure the provided RestTemplate instance using this builder.
RestTemplateBuilder	customizers(Collection<? extends RestTemplateCustomizer> customizers)	Set the RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	customizers(RestTemplateCustomizer... customizers)	Set the RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	defaultHeader(String name, String... values)	Add a default header that will be set if not already present on the outgoing HttpClientRequest.
RestTemplateBuilder	defaultMessageConverters()	Set the HttpMessageConverters that should be used with the RestTemplate to the default set.
RestTemplateBuilder	detectRequestFactory(boolean detectRequestFactory)	Set if the ClientHttpRequestFactory should be detected based on the classpath.
RestTemplateBuilder	errorHandler(ResponseErrorHandler errorHandler)	Set the ResponseErrorHandler that should be used with the RestTemplate.
RestTemplateBuilder	interceptors(Collection<ClientHttpRequestInterceptor> interceptors)	Set the ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	interceptors(ClientHttpRequestInterceptor... interceptors)	Set the ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	messageConverters(Collection<? extends HttpMessageConverter<?>> messageConverters)	Set the HttpMessageConverters that should be used with the RestTemplate.
RestTemplateBuilder	messageConverters(HttpMessageConverter<?>... messageConverters)	Set the HttpMessageConverters that should be used with the RestTemplate.
RestTemplateBuilder	requestCustomizers(Collection<? extends RestTemplateRequestCustomizer<?>> requestCustomizers)	Set the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest.
RestTemplateBuilder	requestCustomizers(RestTemplateRequestCustomizer<?>... requestCustomizers)	Set the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest.
RestTemplateBuilder	requestFactory(Class<? extends ClientHttpRequestFactory> requestFactoryType)	Set the ClientHttpRequestFactory class that should be used with the RestTemplate.
RestTemplateBuilder	requestFactory(Function<ClientHttpRequestFactorySettings,ClientHttpRequestFactory> requestFactoryFunction)	Set the request factory function that should be called to provide a ClientHttpRequestFactory each time we build() a new RestTemplate instance.
RestTemplateBuilder	requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier)	Set the Supplier of ClientHttpRequestFactory that should be called each time we build() a new RestTemplate instance.
RestTemplateBuilder	rootUri(String rootUri)	Set a root URL that should be applied to each request that starts with '/'.
RestTemplateBuilder	setBufferRequestBody(boolean bufferRequestBody)	Deprecated, for removal: This API element is subject to removal in a future version. since 3.2.0 for removal in 3.4.0 as support for buffering has been removed in Spring Framework 6.1
RestTemplateBuilder	setConnectTimeout(Duration connectTimeout)	Sets the connection timeout on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	setReadTimeout(Duration readTimeout)	Sets the read timeout on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	setSslBundle(SslBundle sslBundle)	Sets the SSL bundle on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	uriTemplateHandler(UriTemplateHandler uriTemplateHandler)	Set the UriTemplateHandler that should be used with the RestTemplate.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RestTemplateBuilder

public RestTemplateBuilder(RestTemplateCustomizer... customizers)

Create a new RestTemplateBuilder instance.

Parameters:

customizers - any RestTemplateCustomizers that should be applied when the RestTemplate is built

Method Details

detectRequestFactory

public RestTemplateBuilder detectRequestFactory(boolean detectRequestFactory)

Set if the ClientHttpRequestFactory should be detected based on the classpath. Default if true.

Parameters:

detectRequestFactory - if the ClientHttpRequestFactory should be detected

Returns:

a new builder instance

rootUri

public RestTemplateBuilder rootUri(String rootUri)

Set a root URL that should be applied to each request that starts with '/'. Since this works by adding a UriTemplateHandler to the RestTemplate, the root URL will only apply when String variants of the RestTemplate methods are used for specifying the request URL. See RootUriTemplateHandler for details.

Parameters:

rootUri - the root URI or null

Returns:

a new builder instance

messageConverters

public RestTemplateBuilder messageConverters(HttpMessageConverter<?>... messageConverters)

Set the HttpMessageConverters that should be used with the RestTemplate. Setting this value will replace any previously configured converters and any converters configured on the builder will replace RestTemplate's default converters.

Parameters:

messageConverters - the converters to set

Returns:

a new builder instance

See Also:

• additionalMessageConverters(HttpMessageConverter...)

messageConverters

public RestTemplateBuilder messageConverters(Collection<? extends HttpMessageConverter<?>> messageConverters)

Set the HttpMessageConverters that should be used with the RestTemplate. Setting this value will replace any previously configured converters and any converters configured on the builder will replace RestTemplate's default converters.

Parameters:

messageConverters - the converters to set

Returns:

a new builder instance

See Also:

• additionalMessageConverters(HttpMessageConverter...)

additionalMessageConverters

public RestTemplateBuilder additionalMessageConverters(HttpMessageConverter<?>... messageConverters)

Add additional HttpMessageConverters that should be used with the RestTemplate. Any converters configured on the builder will replace RestTemplate's default converters.

Parameters:

messageConverters - the converters to add

Returns:

a new builder instance

See Also:

• messageConverters(HttpMessageConverter...)

additionalMessageConverters

public RestTemplateBuilder additionalMessageConverters(Collection<? extends HttpMessageConverter<?>> messageConverters)

Add additional HttpMessageConverters that should be used with the RestTemplate. Any converters configured on the builder will replace RestTemplate's default converters.

Parameters:

messageConverters - the converters to add

Returns:

a new builder instance

See Also:

• messageConverters(HttpMessageConverter...)

defaultMessageConverters

public RestTemplateBuilder defaultMessageConverters()

Set the HttpMessageConverters that should be used with the RestTemplate to the default set. Calling this method will replace any previously defined converters.

Returns:

a new builder instance

See Also:

• messageConverters(HttpMessageConverter...)

interceptors

public RestTemplateBuilder interceptors(ClientHttpRequestInterceptor... interceptors)

Set the ClientHttpRequestInterceptors that should be used with the RestTemplate. Setting this value will replace any previously defined interceptors.

Parameters:

interceptors - the interceptors to set

Returns:

a new builder instance

Since:

1.4.1

See Also:

• additionalInterceptors(ClientHttpRequestInterceptor...)

interceptors

public RestTemplateBuilder interceptors(Collection<ClientHttpRequestInterceptor> interceptors)

Set the ClientHttpRequestInterceptors that should be used with the RestTemplate. Setting this value will replace any previously defined interceptors.

Parameters:

interceptors - the interceptors to set

Returns:

a new builder instance

Since:

1.4.1

See Also:

• additionalInterceptors(ClientHttpRequestInterceptor...)

additionalInterceptors

public RestTemplateBuilder additionalInterceptors(ClientHttpRequestInterceptor... interceptors)

Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.

Parameters:

interceptors - the interceptors to add

Returns:

a new builder instance

Since:

1.4.1

See Also:

• interceptors(ClientHttpRequestInterceptor...)

additionalInterceptors

public RestTemplateBuilder additionalInterceptors(Collection<? extends ClientHttpRequestInterceptor> interceptors)

Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.

Parameters:

interceptors - the interceptors to add

Returns:

a new builder instance

Since:

1.4.1

See Also:

• interceptors(ClientHttpRequestInterceptor...)

requestFactory

public RestTemplateBuilder requestFactory(Class<? extends ClientHttpRequestFactory> requestFactoryType)

Set the ClientHttpRequestFactory class that should be used with the RestTemplate.

Parameters:

requestFactoryType - the request factory type to use

Returns:

a new builder instance

requestFactory

public RestTemplateBuilder requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier)

Set the Supplier of ClientHttpRequestFactory that should be called each time we build() a new RestTemplate instance.

Parameters:

requestFactorySupplier - the supplier for the request factory

Returns:

a new builder instance

Since:

2.0.0

requestFactory

public RestTemplateBuilder requestFactory(Function<ClientHttpRequestFactorySettings,ClientHttpRequestFactory> requestFactoryFunction)

Set the request factory function that should be called to provide a ClientHttpRequestFactory each time we build() a new RestTemplate instance.

Parameters:

requestFactoryFunction - the settings to request factory function

Returns:

a new builder instance

Since:

3.0.0

See Also:

• ClientHttpRequestFactories

uriTemplateHandler

public RestTemplateBuilder uriTemplateHandler(UriTemplateHandler uriTemplateHandler)

Set the UriTemplateHandler that should be used with the RestTemplate.

Parameters:

uriTemplateHandler - the URI template handler to use

Returns:

a new builder instance

errorHandler

public RestTemplateBuilder errorHandler(ResponseErrorHandler errorHandler)

Set the ResponseErrorHandler that should be used with the RestTemplate.

Parameters:

errorHandler - the error handler to use

Returns:

a new builder instance

basicAuthentication

public RestTemplateBuilder basicAuthentication(String username,
 String password)

Add HTTP Basic Authentication to requests with the given username/password pair, unless a custom Authorization header has been set before.

Parameters:

username - the user name

password - the password

Returns:

a new builder instance

Since:

2.1.0

See Also:

• basicAuthentication(String, String, Charset)

basicAuthentication

public RestTemplateBuilder basicAuthentication(String username,
 String password,
 Charset charset)

Add HTTP Basic Authentication to requests with the given username/password pair, unless a custom Authorization header has been set before.

Parameters:

username - the user name

password - the password

charset - the charset to use

Returns:

a new builder instance

Since:

2.2.0

defaultHeader

public RestTemplateBuilder defaultHeader(String name,
 String... values)

Add a default header that will be set if not already present on the outgoing HttpClientRequest.

Parameters:

name - the name of the header

values - the header values

Returns:

a new builder instance

Since:

2.2.0

setConnectTimeout

public RestTemplateBuilder setConnectTimeout(Duration connectTimeout)

Sets the connection timeout on the underlying ClientHttpRequestFactory.

Parameters:

connectTimeout - the connection timeout

Returns:

a new builder instance.

Since:

2.1.0

setReadTimeout

public RestTemplateBuilder setReadTimeout(Duration readTimeout)

Sets the read timeout on the underlying ClientHttpRequestFactory.

Parameters:

readTimeout - the read timeout

Returns:

a new builder instance.

Since:

2.1.0

setBufferRequestBody

@Deprecated(since="3.2.0",
            forRemoval=true)
public RestTemplateBuilder setBufferRequestBody(boolean bufferRequestBody)

Deprecated, for removal: This API element is subject to removal in a future version.

since 3.2.0 for removal in 3.4.0 as support for buffering has been removed in Spring Framework 6.1

Has no effect as support for buffering has been removed in Spring Framework 6.1.

Parameters:

bufferRequestBody - value of the bufferRequestBody parameter

Returns:

a new builder instance.

Since:

2.2.0

See Also:

• SimpleClientHttpRequestFactory.setBufferRequestBody(boolean)
• HttpComponentsClientHttpRequestFactory.setBufferRequestBody(boolean)

setSslBundle

public RestTemplateBuilder setSslBundle(SslBundle sslBundle)

Sets the SSL bundle on the underlying ClientHttpRequestFactory.

Parameters:

sslBundle - the SSL bundle

Returns:

a new builder instance

Since:

3.1.0

customizers

public RestTemplateBuilder customizers(RestTemplateCustomizer... customizers)

Set the RestTemplateCustomizers that should be applied to the RestTemplate. Customizers are applied in the order that they were added after builder configuration has been applied. Setting this value will replace any previously configured customizers.

Parameters:

customizers - the customizers to set

Returns:

a new builder instance

See Also:

• additionalCustomizers(RestTemplateCustomizer...)

customizers

public RestTemplateBuilder customizers(Collection<? extends RestTemplateCustomizer> customizers)

Set the RestTemplateCustomizers that should be applied to the RestTemplate. Customizers are applied in the order that they were added after builder configuration has been applied. Setting this value will replace any previously configured customizers.

Parameters:

customizers - the customizers to set

Returns:

a new builder instance

See Also:

• additionalCustomizers(RestTemplateCustomizer...)

additionalCustomizers

public RestTemplateBuilder additionalCustomizers(RestTemplateCustomizer... customizers)

Add RestTemplateCustomizers that should be applied to the RestTemplate. Customizers are applied in the order that they were added after builder configuration has been applied.

Parameters:

customizers - the customizers to add

Returns:

a new builder instance

See Also:

• customizers(RestTemplateCustomizer...)

additionalCustomizers

public RestTemplateBuilder additionalCustomizers(Collection<? extends RestTemplateCustomizer> customizers)

Add RestTemplateCustomizers that should be applied to the RestTemplate. Customizers are applied in the order that they were added after builder configuration has been applied.

Parameters:

customizers - the customizers to add

Returns:

a new builder instance

See Also:

• customizers(RestTemplateCustomizer...)

requestCustomizers

public RestTemplateBuilder requestCustomizers(RestTemplateRequestCustomizer<?>... requestCustomizers)

Set the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest. Customizers are applied in the order that they were added. Setting this value will replace any previously configured request customizers.

Parameters:

requestCustomizers - the request customizers to set

Returns:

a new builder instance

Since:

2.2.0

See Also:

• additionalRequestCustomizers(RestTemplateRequestCustomizer...)

requestCustomizers

public RestTemplateBuilder requestCustomizers(Collection<? extends RestTemplateRequestCustomizer<?>> requestCustomizers)

Set the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest. Customizers are applied in the order that they were added. Setting this value will replace any previously configured request customizers.

Parameters:

requestCustomizers - the request customizers to set

Returns:

a new builder instance

Since:

2.2.0

See Also:

• additionalRequestCustomizers(RestTemplateRequestCustomizer...)

additionalRequestCustomizers

public RestTemplateBuilder additionalRequestCustomizers(RestTemplateRequestCustomizer<?>... requestCustomizers)

Add the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest. Customizers are applied in the order that they were added.

Parameters:

requestCustomizers - the request customizers to add

Returns:

a new builder instance

Since:

2.2.0

See Also:

• requestCustomizers(RestTemplateRequestCustomizer...)

additionalRequestCustomizers

public RestTemplateBuilder additionalRequestCustomizers(Collection<? extends RestTemplateRequestCustomizer<?>> requestCustomizers)

Add the RestTemplateRequestCustomizers that should be applied to the ClientHttpRequest. Customizers are applied in the order that they were added.

Parameters:

requestCustomizers - the request customizers to add

Returns:

a new builder instance

Since:

2.2.0

See Also:

• requestCustomizers(Collection)

build

public RestTemplate build()

Build a new RestTemplate instance and configure it using this builder.

Returns:

a configured RestTemplate instance.

See Also:

• build(Class)
• configure(RestTemplate)

build

public <T extends RestTemplate> T build(Class<T> restTemplateClass)

Build a new RestTemplate instance of the specified type and configure it using this builder.

Type Parameters:

T - the type of rest template

Parameters:

restTemplateClass - the template type to create

Returns:

a configured RestTemplate instance.

See Also:

• build()
• configure(RestTemplate)

configure

public <T extends RestTemplate> T configure(T restTemplate)

Configure the provided RestTemplate instance using this builder.

Type Parameters:

T - the type of rest template

Parameters:

restTemplate - the RestTemplate to configure

Returns:

the rest template instance

See Also:

• build()
• build(Class)

buildRequestFactory

public ClientHttpRequestFactory buildRequestFactory()

Build a new ClientHttpRequestFactory instance using the settings of this builder.

Returns:

a ClientHttpRequestFactory or null

Since:

2.2.0