RestTemplateBuilder (Spring Boot Docs 2.1.4.RELEASE API)

java.lang.ObjectSE
- org.springframework.boot.web.client.RestTemplateBuilder

```
public class RestTemplateBuilder
extends ObjectSE
```
RestTemplate の構成および作成に使用できるビルダー。converters、error handlers および UriTemplateHandlers を登録するための便利なメソッドを提供します。
デフォルトでは、構築された RestTemplate は最適な ClientHttpRequestFactory を使用しようとします。デフォルトのままにする場合は、detectRequestFactory(false) を呼び出します。典型的な自動構成の Spring Boot アプリケーションでは、このビルダーは Bean として使用可能であり、RestTemplate が必要なときにいつでも注入できます。
導入:
1.4.0
作成者:
Stephane Nicoll, Phillip Webb, Andy Wilkinson, Brian Clozel

コンストラクターの概要
コンストラクター
コンストラクターと説明
RestTemplateBuilder(RestTemplateCustomizer... customizers)
新しい RestTemplateBuilder インスタンスを作成します。

コンストラクター
コンストラクターと説明
`RestTemplateBuilder(RestTemplateCustomizer... customizers)` 新しい `RestTemplateBuilder` インスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`RestTemplateBuilder`	`additionalCustomizers(CollectionSE<? extends RestTemplateCustomizer> customizers)` `RestTemplate` に適用する必要がある `RestTemplateCustomizers` を追加します。
`RestTemplateBuilder`	`additionalCustomizers(RestTemplateCustomizer... restTemplateCustomizers)` `RestTemplate` に適用する必要がある `RestTemplateCustomizers` を追加します。
`RestTemplateBuilder`	`additionalInterceptors(ClientHttpRequestInterceptor... interceptors)` `RestTemplate` で使用する必要がある `ClientHttpRequestInterceptors` を追加します。
`RestTemplateBuilder`	`additionalInterceptors(CollectionSE<? extends ClientHttpRequestInterceptor> interceptors)` `RestTemplate` で使用する必要がある `ClientHttpRequestInterceptors` を追加します。
`RestTemplateBuilder`	`additionalMessageConverters(CollectionSE<? extends HttpMessageConverter<?>> messageConverters)` `RestTemplate` で使用する必要がある `HttpMessageConverters` を追加します。
`RestTemplateBuilder`	`additionalMessageConverters(HttpMessageConverter<?>... messageConverters)` `RestTemplate` で使用する必要がある `HttpMessageConverters` を追加します。
`RestTemplateBuilder`	`basicAuthentication(StringSE username, StringSE password)` HTTP 基本認証をリクエストに追加します。
`RestTemplateBuilder`	`basicAuthorization(StringSE username, StringSE password)` 使用すべきではありません。 2.1.0 以降、`basicAuthentication(String username, String password)` を推奨
`RestTemplate`	`build()` 新しい `RestTemplate` インスタンスをビルドし、このビルダーを使用して構成します。
`<T extends RestTemplate> T`	`build(ClassSE<T> restTemplateClass)` 指定された型の新しい `RestTemplate` インスタンスをビルドし、このビルダーを使用して構成します。
`<T extends RestTemplate> T`	`configure(T restTemplate)` このビルダーを使用して、提供された `RestTemplate` インスタンスを構成します。
`RestTemplateBuilder`	`customizers(CollectionSE<? extends RestTemplateCustomizer> restTemplateCustomizers)` `RestTemplate` に適用する `RestTemplateCustomizers` を設定します。
`RestTemplateBuilder`	`customizers(RestTemplateCustomizer... restTemplateCustomizers)` `RestTemplate` に適用する `RestTemplateCustomizers` を設定します。
`RestTemplateBuilder`	`defaultMessageConverters()` `RestTemplate` で使用する `HttpMessageConverters` をデフォルトセットに設定します。
`RestTemplateBuilder`	`detectRequestFactory(boolean detectRequestFactory)` `ClientHttpRequestFactory` をクラスパスに基づいて検出する必要がある場合に設定します。
`RestTemplateBuilder`	`errorHandler(ResponseErrorHandler errorHandler)` `RestTemplate` で使用する `ResponseErrorHandler` を設定します。
`RestTemplateBuilder`	`interceptors(ClientHttpRequestInterceptor... interceptors)` `RestTemplate` で使用する `ClientHttpRequestInterceptors` を設定します。
`RestTemplateBuilder`	`interceptors(CollectionSE<ClientHttpRequestInterceptor> interceptors)` `RestTemplate` で使用する `ClientHttpRequestInterceptors` を設定します。
`RestTemplateBuilder`	`messageConverters(CollectionSE<? extends HttpMessageConverter<?>> messageConverters)` `RestTemplate` で使用する `HttpMessageConverters` を設定します。
`RestTemplateBuilder`	`messageConverters(HttpMessageConverter<?>... messageConverters)` `RestTemplate` で使用する `HttpMessageConverters` を設定します。
`RestTemplateBuilder`	`requestFactory(ClassSE<? extends ClientHttpRequestFactory> requestFactory)` `RestTemplate` で使用する `ClientHttpRequestFactory` クラスを設定します。
`RestTemplateBuilder`	`requestFactory(SupplierSE<ClientHttpRequestFactory> requestFactorySupplier)` 新しい `RestTemplate` インスタンスを `build()` するたびに呼び出される `ClientHttpRequestFactory` の `Supplier` を設定します。
`RestTemplateBuilder`	`rootUri(StringSE rootUri)` `'/'` で始まる各リクエストに適用されるルート URL を設定します。
`RestTemplateBuilder`	`setConnectTimeout(DurationSE connectTimeout)` 基礎となる `ClientHttpRequestFactory` の接続タイムアウトを設定します。
`RestTemplateBuilder`	`setConnectTimeout(int connectTimeout)` 使用すべきではありません。 2.1.0 以降、`setConnectTimeout(Duration)` を推奨
`RestTemplateBuilder`	`setReadTimeout(DurationSE readTimeout)` 基になる `ClientHttpRequestFactory` の読み取りタイムアウトを設定します。
`RestTemplateBuilder`	`setReadTimeout(int readTimeout)` 使用すべきではありません。 2.1.0 以降、`setReadTimeout(Duration)` を推奨
`RestTemplateBuilder`	`uriTemplateHandler(UriTemplateHandler uriTemplateHandler)` `RestTemplate` で使用する `UriTemplateHandler` を設定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - RestTemplateBuilder
```
public RestTemplateBuilder(RestTemplateCustomizer... customizers)
```
    新しい RestTemplateBuilder インスタンスを作成します。
    パラメーター:
    customizers - RestTemplate の構築時に適用される RestTemplateCustomizers
- メソッドの詳細
  - detectRequestFactory
```
public RestTemplateBuilder detectRequestFactory(boolean detectRequestFactory)
```
    ClientHttpRequestFactory をクラスパスに基づいて検出する必要がある場合に設定します。true の場合のデフォルト。
    パラメーター:
    detectRequestFactory - ClientHttpRequestFactory を検出する必要がある場合
    戻り値:
    新しいビルダーインスタンス
  - rootUri
```
public RestTemplateBuilder rootUri(StringSE rootUri)
```
    '/' で始まる各リクエストに適用されるルート URL を設定します。詳細については、RootUriTemplateHandler を参照してください。
    パラメーター:
    rootUri - ルート URI または null
    戻り値:
    新しいビルダーインスタンス
  - messageConverters
```
public RestTemplateBuilder messageConverters(HttpMessageConverter<?>... messageConverters)
```
    RestTemplate で使用する HttpMessageConverters を設定します。この値を設定すると、以前に構成されたコンバーターが置き換えられ、ビルダーで構成されたコンバーターは RestTemplate のデフォルトのコンバーターを置き換えます。
    パラメーター:
    messageConverters - 設定するコンバーター
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    additionalMessageConverters(HttpMessageConverter...)
  - messageConverters
```
public RestTemplateBuilder messageConverters(CollectionSE<? extends HttpMessageConverter<?>> messageConverters)
```
    RestTemplate で使用する HttpMessageConverters を設定します。この値を設定すると、以前に構成されたコンバーターが置き換えられ、ビルダーで構成されたコンバーターは RestTemplate のデフォルトのコンバーターを置き換えます。
    パラメーター:
    messageConverters - 設定するコンバーター
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    additionalMessageConverters(HttpMessageConverter...)
  - additionalMessageConverters
```
public RestTemplateBuilder additionalMessageConverters(HttpMessageConverter<?>... messageConverters)
```
    RestTemplate で使用する必要がある HttpMessageConverters を追加します。ビルダーで構成されたコンバーターは、RestTemplate のデフォルトのコンバーターを置き換えます。
    パラメーター:
    messageConverters - 追加するコンバーター
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    messageConverters(HttpMessageConverter...)
  - additionalMessageConverters
```
public RestTemplateBuilder additionalMessageConverters(CollectionSE<? extends HttpMessageConverter<?>> messageConverters)
```
    RestTemplate で使用する必要がある HttpMessageConverters を追加します。ビルダーで構成されたコンバーターは、RestTemplate のデフォルトのコンバーターを置き換えます。
    パラメーター:
    messageConverters - 追加するコンバーター
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    messageConverters(HttpMessageConverter...)
  - defaultMessageConverters
```
public RestTemplateBuilder defaultMessageConverters()
```
    RestTemplate で使用する HttpMessageConverters をデフォルトセットに設定します。このメソッドを呼び出すと、以前に定義されたコンバーターが置き換えられます。
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    messageConverters(HttpMessageConverter...)
  - interceptors
```
public RestTemplateBuilder interceptors(ClientHttpRequestInterceptor... interceptors)
```
    RestTemplate で使用する ClientHttpRequestInterceptors を設定します。この値を設定すると、以前に定義されたインターセプターが置き換えられます。
    パラメーター:
    interceptors - 設定するインターセプター
    戻り値:
    新しいビルダーインスタンス
    導入:
    1.4.1
    関連事項:
    additionalInterceptors(ClientHttpRequestInterceptor...)
  - interceptors
```
public RestTemplateBuilder interceptors(CollectionSE<ClientHttpRequestInterceptor> interceptors)
```
    RestTemplate で使用する ClientHttpRequestInterceptors を設定します。この値を設定すると、以前に定義されたインターセプターが置き換えられます。
    パラメーター:
    interceptors - 設定するインターセプター
    戻り値:
    新しいビルダーインスタンス
    導入:
    1.4.1
    関連事項:
    additionalInterceptors(ClientHttpRequestInterceptor...)
  - additionalInterceptors
```
public RestTemplateBuilder additionalInterceptors(ClientHttpRequestInterceptor... interceptors)
```
    RestTemplate で使用する必要がある ClientHttpRequestInterceptors を追加します。
    パラメーター:
    interceptors - 追加するインターセプター
    戻り値:
    新しいビルダーインスタンス
    導入:
    1.4.1
    関連事項:
    interceptors(ClientHttpRequestInterceptor...)
  - additionalInterceptors
```
public RestTemplateBuilder additionalInterceptors(CollectionSE<? extends ClientHttpRequestInterceptor> interceptors)
```
    RestTemplate で使用する必要がある ClientHttpRequestInterceptors を追加します。
    パラメーター:
    interceptors - 追加するインターセプター
    戻り値:
    新しいビルダーインスタンス
    導入:
    1.4.1
    関連事項:
    interceptors(ClientHttpRequestInterceptor...)
  - requestFactory
```
public RestTemplateBuilder requestFactory(ClassSE<? extends ClientHttpRequestFactory> requestFactory)
```
    RestTemplate で使用する ClientHttpRequestFactory クラスを設定します。
    パラメーター:
    requestFactory - 使用するリクエストファクトリ
    戻り値:
    新しいビルダーインスタンス
  - requestFactory
```
public RestTemplateBuilder requestFactory(SupplierSE<ClientHttpRequestFactory> requestFactorySupplier)
```
    新しい RestTemplate インスタンスを build() するたびに呼び出される ClientHttpRequestFactory の Supplier を設定します。
    パラメーター:
    requestFactorySupplier - リクエストファクトリのサプライヤー
    戻り値:
    新しいビルダーインスタンス
    導入:
    2.0.0
  - uriTemplateHandler
```
public RestTemplateBuilder uriTemplateHandler(UriTemplateHandler uriTemplateHandler)
```
    RestTemplate で使用する UriTemplateHandler を設定します。
    パラメーター:
    uriTemplateHandler - 使用する URI テンプレートハンドラー
    戻り値:
    新しいビルダーインスタンス
  - errorHandler
```
public RestTemplateBuilder errorHandler(ResponseErrorHandler errorHandler)
```
    RestTemplate で使用する ResponseErrorHandler を設定します。
    パラメーター:
    errorHandler - 使用するエラーハンドラー
    戻り値:
    新しいビルダーインスタンス
  - basicAuthorization
```
@DeprecatedSE
public RestTemplateBuilder basicAuthorization(StringSE username,
                                                          StringSE password)
```
    非推奨。2.1.0 から basicAuthentication(String username, String password) に移行
    HTTP 基本認証をリクエストに追加します。詳細については、BasicAuthenticationInterceptor を参照してください。
    パラメーター:
    username - ユーザー名
    password - パスワード
    戻り値:
    新しいビルダーインスタンス
  - basicAuthentication
```
public RestTemplateBuilder basicAuthentication(StringSE username,
                                               StringSE password)
```
    HTTP 基本認証をリクエストに追加します。詳細については、BasicAuthenticationInterceptor を参照してください。
    パラメーター:
    username - ユーザー名
    password - パスワード
    戻り値:
    新しいビルダーインスタンス
    導入:
    2.1.0
  - customizers
```
public RestTemplateBuilder customizers(RestTemplateCustomizer... restTemplateCustomizers)
```
    RestTemplate に適用する RestTemplateCustomizers を設定します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。この値を設定すると、以前に構成されたカスタマイザーが置き換えられます。
    パラメーター:
    restTemplateCustomizers - 設定するカスタマイザー
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    additionalCustomizers(RestTemplateCustomizer...)
  - customizers
```
public RestTemplateBuilder customizers(CollectionSE<? extends RestTemplateCustomizer> restTemplateCustomizers)
```
    RestTemplate に適用する RestTemplateCustomizers を設定します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。この値を設定すると、以前に構成されたカスタマイザーが置き換えられます。
    パラメーター:
    restTemplateCustomizers - 設定するカスタマイザー
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    additionalCustomizers(RestTemplateCustomizer...)
  - additionalCustomizers
```
public RestTemplateBuilder additionalCustomizers(RestTemplateCustomizer... restTemplateCustomizers)
```
    RestTemplate に適用する必要がある RestTemplateCustomizers を追加します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。
    パラメーター:
    restTemplateCustomizers - 追加するカスタマイザー
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    customizers(RestTemplateCustomizer...)
  - additionalCustomizers
```
public RestTemplateBuilder additionalCustomizers(CollectionSE<? extends RestTemplateCustomizer> customizers)
```
    RestTemplate に適用する必要がある RestTemplateCustomizers を追加します。カスタマイザーは、ビルダー構成が適用された後に追加された順序で適用されます。
    パラメーター:
    customizers - 追加するカスタマイザー
    戻り値:
    新しいビルダーインスタンス
    関連事項:
    customizers(RestTemplateCustomizer...)
  - setConnectTimeout
```
public RestTemplateBuilder setConnectTimeout(DurationSE connectTimeout)
```
    基礎となる ClientHttpRequestFactory の接続タイムアウトを設定します。
    パラメーター:
    connectTimeout - 接続タイムアウト
    戻り値:
    新しいビルダーインスタンス。
    導入:
    2.1.0
  - setConnectTimeout
```
@DeprecatedSE
public RestTemplateBuilder setConnectTimeout(int connectTimeout)
```
    非推奨。2.1.0 から setConnectTimeout(Duration) に移行
    基礎となる ClientHttpRequestFactory の接続タイムアウトをミリ秒単位で設定します。
    パラメーター:
    connectTimeout - ミリ秒単位の接続タイムアウト
    戻り値:
    新しいビルダーインスタンス。
  - setReadTimeout
```
public RestTemplateBuilder setReadTimeout(DurationSE readTimeout)
```
    基になる ClientHttpRequestFactory の読み取りタイムアウトを設定します。
    パラメーター:
    readTimeout - 読み取りタイムアウト
    戻り値:
    新しいビルダーインスタンス。
    導入:
    2.1.0
  - setReadTimeout
```
@DeprecatedSE
public RestTemplateBuilder setReadTimeout(int readTimeout)
```
    非推奨。2.1.0 から setReadTimeout(Duration) に移行
    基礎となる ClientHttpRequestFactory の読み取りタイムアウトをミリ秒単位で設定します。
    パラメーター:
    readTimeout - ミリ秒単位の読み取りタイムアウト
    戻り値:
    新しいビルダーインスタンス。
  - build
```
public RestTemplate build()
```
    新しい RestTemplate インスタンスをビルドし、このビルダーを使用して構成します。
    戻り値:
    構成済みの RestTemplate インスタンス。
    関連事項:
    build(Class), configure(RestTemplate)
  - build
```
public <T extends RestTemplate> T build(ClassSE<T> restTemplateClass)
```
    指定された型の新しい RestTemplate インスタンスをビルドし、このビルダーを使用して構成します。
    型パラメーター:
    T - rest テンプレートの型
    パラメーター:
    restTemplateClass - 作成するテンプレート型
    戻り値:
    構成済みの RestTemplate インスタンス。
    関連事項:
    build(), configure(RestTemplate)
  - configure
```
public <T extends RestTemplate> T configure(T restTemplate)
```
    このビルダーを使用して、提供された RestTemplate インスタンスを構成します。
    型パラメーター:
    T - rest テンプレートの型
    パラメーター:
    restTemplate - 構成する RestTemplate
    戻り値:
    Rest テンプレートインスタンス
    関連事項:
    build(), build(Class)

クラス RestTemplateBuilder

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

RestTemplateBuilder

メソッドの詳細

detectRequestFactory

rootUri

messageConverters

messageConverters

additionalMessageConverters

additionalMessageConverters

defaultMessageConverters

interceptors

interceptors

additionalInterceptors

additionalInterceptors

requestFactory

requestFactory

uriTemplateHandler

errorHandler

basicAuthorization

basicAuthentication

customizers

customizers

additionalCustomizers

additionalCustomizers

setConnectTimeout

setConnectTimeout

setReadTimeout

setReadTimeout

build

build

configure