程序包 org.springframework.boot.web.client

类 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.

从以下版本开始:

1.4.0

作者:

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

构造器概要

构造器

构造器	说明
RestTemplateBuilder(RestTemplateCustomizer... customizers)	Create a new RestTemplateBuilder instance.

方法概要

修饰符和类型	方法	说明
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	connectTimeout(Duration connectTimeout)	Sets the connection timeout on the underlying ClientHttpRequestFactory.
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 ClientHttpRequest.
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	readTimeout(Duration readTimeout)	Sets the read timeout on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	redirects(ClientHttpRequestFactorySettings.Redirects redirects)	Sets the redirect strategy on the underlying ClientHttpRequestFactory.
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)	已过时, 待删除: 此 API 元素将从以后的版本中删除。 since 3.4.0 for removal in 4.0.0 in favor of requestFactoryBuilder(ClientHttpRequestFactoryBuilder)
RestTemplateBuilder	requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier)	Set the Supplier of ClientHttpRequestFactory that should be called each time we build() a new RestTemplate instance.
ClientHttpRequestFactoryBuilder<?>	requestFactoryBuilder()	Return a ClientHttpRequestFactoryBuilder instance using the settings of this builder.
RestTemplateBuilder	requestFactoryBuilder(ClientHttpRequestFactoryBuilder<?> requestFactoryBuilder)	Set the ClientHttpRequestFactoryBuilder that should be used each time we build() a new RestTemplate instance.
RestTemplateBuilder	requestFactorySettings(UnaryOperator<ClientHttpRequestFactorySettings> requestFactorySettingsCustomizer)	Update the ClientHttpRequestFactorySettings using the given customizer.
RestTemplateBuilder	requestFactorySettings(ClientHttpRequestFactorySettings requestFactorySettings)	Sets the ClientHttpRequestFactorySettings.
RestTemplateBuilder	rootUri(String rootUri)	Set a root URL that should be applied to each request that starts with '/'.
RestTemplateBuilder	setConnectTimeout(Duration connectTimeout)	已过时, 待删除: 此 API 元素将从以后的版本中删除。 since 3.4.0 for removal in 4.0.0 in favor of connectTimeout(Duration)
RestTemplateBuilder	setReadTimeout(Duration readTimeout)	已过时, 待删除: 此 API 元素将从以后的版本中删除。 since 3.4.0 for removal in 4.0.0 in favor of readTimeout(Duration)
RestTemplateBuilder	setSslBundle(SslBundle sslBundle)	已过时, 待删除: 此 API 元素将从以后的版本中删除。 since 3.4.0 for removal in 4.0.0 in favor of sslBundle(SslBundle)
RestTemplateBuilder	sslBundle(SslBundle sslBundle)	Sets the SSL bundle on the underlying ClientHttpRequestFactory.
RestTemplateBuilder	uriTemplateHandler(UriTemplateHandler uriTemplateHandler)	Set the UriTemplateHandler that should be used with the RestTemplate.

从类继承的方法 java.lang.Object

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

构造器详细资料

RestTemplateBuilder

public RestTemplateBuilder(RestTemplateCustomizer... customizers)

Create a new RestTemplateBuilder instance.

参数:

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

方法详细资料

detectRequestFactory

public RestTemplateBuilder detectRequestFactory(boolean detectRequestFactory)

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

参数:

detectRequestFactory - if the ClientHttpRequestFactory should be detected

返回:

a new builder instance

rootUri

public RestTemplateBuilder rootUri(String rootUri)

Set a root URL that should be applied to each request that starts with '/'. The root URL will only apply when String variants of the RestTemplate methods are used for specifying the request URL.

参数:

rootUri - the root URI or null

返回:

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.

参数:

messageConverters - the converters to set

返回:

a new builder instance

另请参阅:

• 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.

参数:

messageConverters - the converters to set

返回:

a new builder instance

另请参阅:

• 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.

参数:

messageConverters - the converters to add

返回:

a new builder instance

另请参阅:

• 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.

参数:

messageConverters - the converters to add

返回:

a new builder instance

另请参阅:

• 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.

返回:

a new builder instance

另请参阅:

• 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.

参数:

interceptors - the interceptors to set

返回:

a new builder instance

从以下版本开始:

1.4.1

另请参阅:

• 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.

参数:

interceptors - the interceptors to set

返回:

a new builder instance

从以下版本开始:

1.4.1

另请参阅:

• additionalInterceptors(ClientHttpRequestInterceptor...)

additionalInterceptors

public RestTemplateBuilder additionalInterceptors(ClientHttpRequestInterceptor... interceptors)

Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.

参数:

interceptors - the interceptors to add

返回:

a new builder instance

从以下版本开始:

1.4.1

另请参阅:

• interceptors(ClientHttpRequestInterceptor...)

additionalInterceptors

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

Add additional ClientHttpRequestInterceptors that should be used with the RestTemplate.

参数:

interceptors - the interceptors to add

返回:

a new builder instance

从以下版本开始:

1.4.1

另请参阅:

• interceptors(ClientHttpRequestInterceptor...)

requestFactory

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

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

参数:

requestFactoryType - the request factory type to use

返回:

a new builder instance

另请参阅:

• ClientHttpRequestFactoryBuilder.of(Class)
• requestFactoryBuilder(ClientHttpRequestFactoryBuilder)

requestFactory

public RestTemplateBuilder requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier)

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

参数:

requestFactorySupplier - the supplier for the request factory

返回:

a new builder instance

从以下版本开始:

2.0.0

另请参阅:

• ClientHttpRequestFactoryBuilder.of(Supplier)
• requestFactoryBuilder(ClientHttpRequestFactoryBuilder)

requestFactory

@Deprecated(since="3.4.0",
            forRemoval=true)
public RestTemplateBuilder requestFactory(Function<ClientHttpRequestFactorySettings,ClientHttpRequestFactory> requestFactoryFunction)

已过时, 待删除: 此 API 元素将从以后的版本中删除。

since 3.4.0 for removal in 4.0.0 in favor of requestFactoryBuilder(ClientHttpRequestFactoryBuilder)

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

参数:

requestFactoryFunction - the settings to request factory function

返回:

a new builder instance

从以下版本开始:

3.0.0

另请参阅:

• ClientHttpRequestFactoryBuilder
• requestFactoryBuilder(ClientHttpRequestFactoryBuilder)

requestFactoryBuilder

public RestTemplateBuilder requestFactoryBuilder(ClientHttpRequestFactoryBuilder<?> requestFactoryBuilder)

Set the ClientHttpRequestFactoryBuilder that should be used each time we build() a new RestTemplate instance.

参数:

requestFactoryBuilder - the ClientHttpRequestFactoryBuilder to use

返回:

a new builder instance

从以下版本开始:

3.4.0

另请参阅:

• ClientHttpRequestFactoryBuilder

uriTemplateHandler

public RestTemplateBuilder uriTemplateHandler(UriTemplateHandler uriTemplateHandler)

Set the UriTemplateHandler that should be used with the RestTemplate.

参数:

uriTemplateHandler - the URI template handler to use

返回:

a new builder instance

errorHandler

public RestTemplateBuilder errorHandler(ResponseErrorHandler errorHandler)

Set the ResponseErrorHandler that should be used with the RestTemplate.

参数:

errorHandler - the error handler to use

返回:

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.

参数:

username - the user name

password - the password

返回:

a new builder instance

从以下版本开始:

2.1.0

另请参阅:

• 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.

参数:

username - the user name

password - the password

charset - the charset to use

返回:

a new builder instance

从以下版本开始:

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 ClientHttpRequest.

参数:

name - the name of the header

values - the header values

返回:

a new builder instance

从以下版本开始:

2.2.0

requestFactorySettings

public RestTemplateBuilder requestFactorySettings(ClientHttpRequestFactorySettings requestFactorySettings)

Sets the ClientHttpRequestFactorySettings. This will replace any previously set connectTimeout, readTimeout and sslBundle values.

参数:

requestFactorySettings - the request factory settings

返回:

a new builder instance

从以下版本开始:

3.4.0

requestFactorySettings

public RestTemplateBuilder requestFactorySettings(UnaryOperator<ClientHttpRequestFactorySettings> requestFactorySettingsCustomizer)

Update the ClientHttpRequestFactorySettings using the given customizer.

参数:

requestFactorySettingsCustomizer - a UnaryOperator to update request factory settings

返回:

a new builder instance

从以下版本开始:

3.4.1

setConnectTimeout

@Deprecated(since="3.4.0",
            forRemoval=true)
public RestTemplateBuilder setConnectTimeout(Duration connectTimeout)

已过时, 待删除: 此 API 元素将从以后的版本中删除。

since 3.4.0 for removal in 4.0.0 in favor of connectTimeout(Duration)

Sets the connection timeout on the underlying ClientHttpRequestFactory.

参数:

connectTimeout - the connection timeout

返回:

a new builder instance.

从以下版本开始:

2.1.0

connectTimeout

public RestTemplateBuilder connectTimeout(Duration connectTimeout)

Sets the connection timeout on the underlying ClientHttpRequestFactory.

参数:

connectTimeout - the connection timeout

返回:

a new builder instance.

从以下版本开始:

3.4.0

setReadTimeout

@Deprecated(since="3.4.0",
            forRemoval=true)
public RestTemplateBuilder setReadTimeout(Duration readTimeout)

已过时, 待删除: 此 API 元素将从以后的版本中删除。

since 3.4.0 for removal in 4.0.0 in favor of readTimeout(Duration)

Sets the read timeout on the underlying ClientHttpRequestFactory.

参数:

readTimeout - the read timeout

返回:

a new builder instance.

从以下版本开始:

2.1.0

readTimeout

public RestTemplateBuilder readTimeout(Duration readTimeout)

Sets the read timeout on the underlying ClientHttpRequestFactory.

参数:

readTimeout - the read timeout

返回:

a new builder instance.

从以下版本开始:

3.4.0

redirects

public RestTemplateBuilder redirects(ClientHttpRequestFactorySettings.Redirects redirects)

Sets the redirect strategy on the underlying ClientHttpRequestFactory.

参数:

redirects - the redirect strategy

返回:

a new builder instance.

从以下版本开始:

3.4.1

setSslBundle

@Deprecated(since="3.4.0",
            forRemoval=true)
public RestTemplateBuilder setSslBundle(SslBundle sslBundle)

已过时, 待删除: 此 API 元素将从以后的版本中删除。

since 3.4.0 for removal in 4.0.0 in favor of sslBundle(SslBundle)

Sets the SSL bundle on the underlying ClientHttpRequestFactory.

参数:

sslBundle - the SSL bundle

返回:

a new builder instance

从以下版本开始:

3.1.0

sslBundle

public RestTemplateBuilder sslBundle(SslBundle sslBundle)

Sets the SSL bundle on the underlying ClientHttpRequestFactory.

参数:

sslBundle - the SSL bundle

返回:

a new builder instance

从以下版本开始:

3.4.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.

参数:

customizers - the customizers to set

返回:

a new builder instance

另请参阅:

• 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.

参数:

customizers - the customizers to set

返回:

a new builder instance

另请参阅:

• 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.

参数:

customizers - the customizers to add

返回:

a new builder instance

另请参阅:

• 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.

参数:

customizers - the customizers to add

返回:

a new builder instance

另请参阅:

• 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.

参数:

requestCustomizers - the request customizers to set

返回:

a new builder instance

从以下版本开始:

2.2.0

另请参阅:

• 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.

参数:

requestCustomizers - the request customizers to set

返回:

a new builder instance

从以下版本开始:

2.2.0

另请参阅:

• 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.

参数:

requestCustomizers - the request customizers to add

返回:

a new builder instance

从以下版本开始:

2.2.0

另请参阅:

• 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.

参数:

requestCustomizers - the request customizers to add

返回:

a new builder instance

从以下版本开始:

2.2.0

另请参阅:

• requestCustomizers(Collection)

build

public RestTemplate build()

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

返回:

a configured RestTemplate instance.

另请参阅:

• 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.

类型参数:

T - the type of rest template

参数:

restTemplateClass - the template type to create

返回:

a configured RestTemplate instance.

另请参阅:

• build()
• configure(RestTemplate)

configure

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

Configure the provided RestTemplate instance using this builder.

类型参数:

T - the type of rest template

参数:

restTemplate - the RestTemplate to configure

返回:

the rest template instance

另请参阅:

• build()
• build(Class)

buildRequestFactory

public ClientHttpRequestFactory buildRequestFactory()

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

返回:

a ClientHttpRequestFactory or null

从以下版本开始:

2.2.0

requestFactoryBuilder

public ClientHttpRequestFactoryBuilder<?> requestFactoryBuilder()

Return a ClientHttpRequestFactoryBuilder instance using the settings of this builder.

返回:

a ClientHttpRequestFactoryBuilder or null

从以下版本开始:

3.5.0