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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
RestTemplateBuilder	additionalCustomizers(Collection<? extends RestTemplateCustomizer> customizers) Add RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	additionalCustomizers(RestTemplateCustomizer... restTemplateCustomizers) Add RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	additionalInterceptors(ClientHttpRequestInterceptor... interceptors) Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	additionalInterceptors(Collection<? extends 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	basicAuthentication(String username, String password) Add HTTP basic authentication to requests.
RestTemplateBuilder	basicAuthorization(String username, String password) Deprecated. since 2.1.0 in favor of basicAuthentication(String username, String password)
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.
<T extends RestTemplate> T	configure(T restTemplate) Configure the provided RestTemplate instance using this builder.
RestTemplateBuilder	customizers(Collection<? extends RestTemplateCustomizer> restTemplateCustomizers) Set the RestTemplateCustomizers that should be applied to the RestTemplate.
RestTemplateBuilder	customizers(RestTemplateCustomizer... restTemplateCustomizers) Set the RestTemplateCustomizers that should be applied to the RestTemplate.
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(ClientHttpRequestInterceptor... interceptors) Set the ClientHttpRequestInterceptors that should be used with the RestTemplate.
RestTemplateBuilder	interceptors(Collection<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	requestFactory(Class<? extends ClientHttpRequestFactory> requestFactory) Set the ClientHttpRequestFactory class that should be used with the RestTemplate.
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	setConnectTimeout(Duration connectTimeout) Sets the connection timeout on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	setConnectTimeout(int connectTimeout) Deprecated. since 2.1.0 in favor of setConnectTimeout(Duration)
RestTemplateBuilder	setReadTimeout(Duration readTimeout) Sets the read timeout on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	setReadTimeout(int readTimeout) Deprecated. since 2.1.0 in favor of setReadTimeout(Duration)
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 Detail

RestTemplateBuilder

public RestTemplateBuilder(RestTemplateCustomizer... customizers)

Create a new RestTemplateBuilder instance.

Parameters:

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

Method Detail

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 '/'. 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> requestFactory)

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

Parameters:

requestFactory - the request factory 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

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

basicAuthorization

@Deprecated
public RestTemplateBuilder basicAuthorization(String username,
                                                          String password)

Deprecated. since 2.1.0 in favor of basicAuthentication(String username, String password)

Add HTTP basic authentication to requests. See BasicAuthenticationInterceptor for details.

Parameters:

username - the user name

password - the password

Returns:

a new builder instance

basicAuthentication

public RestTemplateBuilder basicAuthentication(String username,
                                               String password)

Add HTTP basic authentication to requests. See BasicAuthenticationInterceptor for details.

Parameters:

username - the user name

password - the password

Returns:

a new builder instance

Since:

2.1.0

customizers

public RestTemplateBuilder customizers(RestTemplateCustomizer... restTemplateCustomizers)

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:

restTemplateCustomizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(RestTemplateCustomizer...)

customizers

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

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:

restTemplateCustomizers - the customizers to set

Returns:

a new builder instance

See Also:

additionalCustomizers(RestTemplateCustomizer...)

additionalCustomizers

public RestTemplateBuilder additionalCustomizers(RestTemplateCustomizer... restTemplateCustomizers)

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:

restTemplateCustomizers - 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...)

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

setConnectTimeout

@Deprecated
public RestTemplateBuilder setConnectTimeout(int connectTimeout)

Deprecated. since 2.1.0 in favor of setConnectTimeout(Duration)

Sets the connection timeout in milliseconds on the underlying ClientHttpRequestFactory.

Parameters:

connectTimeout - the connection timeout in milliseconds

Returns:

a new builder instance.

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

setReadTimeout

@Deprecated
public RestTemplateBuilder setReadTimeout(int readTimeout)

Deprecated. since 2.1.0 in favor of setReadTimeout(Duration)

Sets the read timeout in milliseconds on the underlying ClientHttpRequestFactory.

Parameters:

readTimeout - the read timeout in milliseconds

Returns:

a new builder instance.

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)