クラス RestTemplate
- 実装されたすべてのインターフェース:
RestOperations
HttpURLConnection
、Apache HttpComponents などの基盤となる HTTP クライアントライブラリを介して、シンプルなテンプレートメソッド API を公開します。RestTemplate は、あまり頻繁でないケースをサポートする一般化された exchange
および execute
メソッドに加えて、HTTP メソッドによる一般的なシナリオのテンプレートを提供します。RestTemplate は通常、共有コンポーネントとして使用されます。ただし、その構成は同時変更をサポートしていないため、その構成は通常、起動時に準備されます。必要に応じて、起動時に複数の異なる構成の RestTemplate インスタンスを作成できます。このようなインスタンスは、HTTP クライアントリソースを共有する必要がある場合、同じ基礎となる ClientHttpRequestFactory
を使用できます。
注意 : 6.1 以降、RestClient
は同期 HTTP アクセス用のより最新の API を提供します。非同期およびストリーミングのシナリオの場合は、リアクティブ WebClient
を検討してください。
RestTemplate
と RestClient
は同じインフラストラクチャ (つまり、リクエストファクトリ、リクエストインターセプタおよびイニシャライザー、メッセージコンバーターなど) を共有するため、そこで行われた改善も同様に共有されます。ただし、RestClient
は新しい高レベルの機能に焦点を当てています。
- 導入:
- 3.0
- 作成者:
- Arjen Poutsma, Brian Clozel, Roy Clarkson, Juergen Hoeller, Sam Brannen, Sebastien Deleuze, Hyoungjune Kim
- 関連事項:
フィールドサマリー
クラス org.springframework.http.client.support.HttpAccessor から継承されたフィールド
logger
コンストラクターのサマリー
コンストラクター説明デフォルト設定を使用して、RestTemplate
の新しいインスタンスを作成します。RestTemplate
(ListSE<HttpMessageConverter<?>> messageConverters) 使用するHttpMessageConverter
の指定されたリストを使用して、RestTemplate
の新しいインスタンスを作成します。RestTemplate
(ClientHttpRequestFactory requestFactory) 指定されたClientHttpRequestFactory
に基づいて、RestTemplate
の新しいインスタンスを作成します。メソッドのサマリー
修飾子と型メソッド説明<T> RequestCallback
acceptHeaderRequestCallback
(ClassSE<T> responseType) 指定されたレスポンス型に基づいてリクエストAccept
ヘッダーを設定するRequestCallback
を返し、構成されたメッセージコンバーターと照合します。void
指定された URI のリソースを削除します。void
指定された URI のリソースを削除します。void
指定された URL のリソースを削除します。protected <T> T
doExecute
(URISE url, StringSE uriTemplate, HttpMethod method, RequestCallback requestCallback, ResponseExtractor<T> responseExtractor) 指定された URI で指定されたメソッドを実行します。protected <T> T
doExecute
(URISE url, HttpMethod method, RequestCallback requestCallback, ResponseExtractor<T> responseExtractor) 使用すべきではありません。<T> ResponseEntity<T>
exchange
(StringSE url, HttpMethod method, HttpEntity<?> requestEntity, ClassSE<T> responseType, ObjectSE... uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(StringSE url, HttpMethod method, HttpEntity<?> requestEntity, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(StringSE url, HttpMethod method, HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType, ObjectSE... uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(StringSE url, HttpMethod method, HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType, MapSE<StringSE, ?> uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(URISE url, HttpMethod method, HttpEntity<?> requestEntity, ClassSE<T> responseType) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(URISE url, HttpMethod method, HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType) 指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(RequestEntity<?> entity, ClassSE<T> responseType) 指定されたRequestEntity
で指定されたリクエストを実行し、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
exchange
(RequestEntity<?> entity, ParameterizedTypeReference<T> responseType) 指定されたRequestEntity
で指定されたリクエストを実行し、レスポンスをResponseEntity
として返します。<T> T
execute
(StringSE uriTemplate, HttpMethod method, RequestCallback requestCallback, ResponseExtractor<T> responseExtractor, ObjectSE... uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。<T> T
execute
(StringSE uriTemplate, HttpMethod method, RequestCallback requestCallback, ResponseExtractor<T> responseExtractor, MapSE<StringSE, ?> uriVariables) 指定された URI テンプレートに対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。<T> T
execute
(URISE url, HttpMethod method, RequestCallback requestCallback, ResponseExtractor<T> responseExtractor) 指定された URL に対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。エラーハンドラーを返します。<T> ResponseEntity<T>
getForEntity
(StringSE url, ClassSE<T> responseType, ObjectSE... uriVariables) 指定された URL で GET を実行して、エンティティを取得します。<T> ResponseEntity<T>
getForEntity
(StringSE url, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) URI テンプレートで GET を実行して、表現を取得します。<T> ResponseEntity<T>
getForEntity
(URISE url, ClassSE<T> responseType) URL で GET を実行して表現を取得します。<T> T
getForObject
(StringSE url, ClassSE<T> responseType, ObjectSE... uriVariables) 指定された URL で GET を実行して、表現を取得します。<T> T
getForObject
(StringSE url, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) URI テンプレートで GET を実行して、表現を取得します。<T> T
getForObject
(URISE url, ClassSE<T> responseType) URL で GET を実行して表現を取得します。メッセージ本文コンバーターのリストを返します。構成されたClientRequestObservationConvention
、または設定されていない場合はnull
を返します。io.micrometer.observation.ObservationRegistry
設定されたObservationRegistry
を返します。設定済みの URI テンプレートハンドラーを返します。protected void
handleResponse
(URISE url, HttpMethod method, ClientHttpResponse response) 指定されたレスポンスを処理し、適切なロギングを実行し、必要に応じてResponseErrorHandler
を呼び出します。protected ResponseExtractor<HttpHeaders>
HttpHeaders
のレスポンス抽出プログラムを返します。headForHeaders
(StringSE url, ObjectSE... uriVariables) URI テンプレートで指定されたリソースのすべてのヘッダーを取得します。headForHeaders
(StringSE url, MapSE<StringSE, ?> uriVariables) URI テンプレートで指定されたリソースのすべてのヘッダーを取得します。headForHeaders
(URISE url) URL で指定されたリソースのすべてのヘッダーを取得します。<T> RequestCallback
httpEntityCallback
(ObjectSE requestBody) 指定されたオブジェクトをリクエストストリームに書き込むRequestCallback
実装を返します。<T> RequestCallback
httpEntityCallback
(ObjectSE requestBody, TypeSE responseType) RequestCallback
実装を返します。指定されたレスポンス型に基づいて、リクエストAccept
ヘッダーを設定し、構成されたメッセージコンバーターに対してクロスチェックします。optionsForAllow
(StringSE url, ObjectSE... uriVariables) 指定された URI のAllow
ヘッダーの値を返します。optionsForAllow
(StringSE url, MapSE<StringSE, ?> uriVariables) 指定された URI のAllow
ヘッダーの値を返します。optionsForAllow
(URISE url) 指定された URL のAllow
ヘッダーの値を返します。<T> T
patchForObject
(StringSE url, ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) 指定されたオブジェクトを URI テンプレートにパッチしてリソースを更新し、レスポンスで見つかった表現を返します。<T> T
patchForObject
(StringSE url, ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) 指定されたオブジェクトを URI テンプレートにパッチしてリソースを更新し、レスポンスで見つかった表現を返します。<T> T
patchForObject
(URISE url, ObjectSE request, ClassSE<T> responseType) 指定されたオブジェクトを URL にパッチしてリソースを更新し、レスポンスで見つかった表現を返します。<T> ResponseEntity<T>
postForEntity
(StringSE url, ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスをResponseEntity
として返します。<T> ResponseEntity<T>
postForEntity
(StringSE url, ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスをHttpEntity
として返します。<T> ResponseEntity<T>
postForEntity
(URISE url, ObjectSE request, ClassSE<T> responseType) 指定されたオブジェクトを URL に POST して新しいリソースを作成し、レスポンスをResponseEntity
として返します。postForLocation
(StringSE url, ObjectSE request, ObjectSE... uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、Location
ヘッダーの値を返します。postForLocation
(StringSE url, ObjectSE request, MapSE<StringSE, ?> uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、Location
ヘッダーの値を返します。postForLocation
(URISE url, ObjectSE request) 指定されたオブジェクトを URL に POST して新しいリソースを作成し、Location
ヘッダーの値を返します。<T> T
postForObject
(StringSE url, ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。<T> T
postForObject
(StringSE url, ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) 指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。<T> T
postForObject
(URISE url, ObjectSE request, ClassSE<T> responseType) 指定されたオブジェクトを URL に POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。void
指定されたオブジェクトを URI に PUT することにより、リソースを作成または更新します。void
指定されたオブジェクトを URI テンプレートに PUT することにより、新しいリソースを作成します。void
指定されたオブジェクトを URL に PUT することにより、新しいリソースを作成します。<T> ResponseExtractor<ResponseEntity<T>>
responseEntityExtractor
(TypeSE responseType) ResponseEntity
を準備するResponseExtractor
を返します。void
setDefaultUriVariables
(MapSE<StringSE, ?> uriVars) デフォルトの URI 変数値を構成します。void
setErrorHandler
(ResponseErrorHandler errorHandler) エラーハンドラーを設定します。void
setMessageConverters
(ListSE<HttpMessageConverter<?>> messageConverters) 使用するメッセージ本文コンバーターを設定します。void
setObservationConvention
(ClientRequestObservationConvention observationConvention) ClientRequestObservationContext
から抽出されたobservation
とそのKeyValues
の名前を設定するObservationConvention
を構成します。void
setObservationRegistry
(io.micrometer.observation.ObservationRegistry observationRegistry) リクエスト実行のスパンとメトリクスを収集するためにObservationRegistry
を構成します。void
setUriTemplateHandler
(UriTemplateHandler handler) URI テンプレートを展開するための戦略を構成します。クラス org.springframework.http.client.support.InterceptingHttpAccessor から継承されたメソッド
getInterceptors, getRequestFactory, setInterceptors, setRequestFactory
クラス org.springframework.http.client.support.HttpAccessor から継承されたメソッド
createRequest, getClientHttpRequestInitializers, setClientHttpRequestInitializers
コンストラクターの詳細
RestTemplate
public RestTemplate()デフォルト設定を使用して、RestTemplate
の新しいインスタンスを作成します。デフォルトのHttpMessageConverters
が初期化されます。RestTemplate
指定されたClientHttpRequestFactory
に基づいて、RestTemplate
の新しいインスタンスを作成します。- パラメーター:
requestFactory
- 使用する HTTP リクエストファクトリ- 関連事項:
RestTemplate
使用するHttpMessageConverter
の指定されたリストを使用して、RestTemplate
の新しいインスタンスを作成します。- パラメーター:
messageConverters
- 使用するHttpMessageConverter
のリスト- 導入:
- 3.2.7
メソッドの詳細
setMessageConverters
使用するメッセージ本文コンバーターを設定します。これらのコンバーターは、HTTP リクエストとレスポンスの変換に使用されます。
getMessageConverters
メッセージ本文コンバーターのリストを返します。返された
List
SE はアクティブであり、追加される場合があります。setErrorHandler
エラーハンドラーを設定します。デフォルトでは、RestTemplate は
DefaultResponseErrorHandler
を使用します。getErrorHandler
エラーハンドラーを返します。setDefaultUriVariables
デフォルトの URI 変数値を構成します。これは次のショートカットです:DefaultUriBuilderFactory factory = new DefaultUriBuilderFactory(); handler.setDefaultUriVariables(...); RestTemplate restTemplate = new RestTemplate(); restTemplate.setUriTemplateHandler(handler);
- パラメーター:
uriVars
- デフォルトの URI 変数値- 導入:
- 4.3
setUriTemplateHandler
URI テンプレートを展開するための戦略を構成します。デフォルトでは、
DefaultUriBuilderFactory
が使用され、後方互換性のために、エンコードモードはURI_COMPONENT
に設定されます。5.0.8 では、TEMPLATE_AND_VALUES
を使用することを優先します。- パラメーター:
handler
- 使用する URI テンプレートハンドラー
getUriTemplateHandler
設定済みの URI テンプレートハンドラーを返します。setObservationRegistry
public void setObservationRegistry(io.micrometer.observation.ObservationRegistry observationRegistry) リクエスト実行のスパンとメトリクスを収集するためにObservationRegistry
を構成します。デフォルトでは、observations
はノーオペレーションです。- パラメーター:
observationRegistry
- 使用する観測レジストリ- 導入:
- 6.0
getObservationRegistry
public io.micrometer.observation.ObservationRegistry getObservationRegistry()設定されたObservationRegistry
を返します。- 導入:
- 6.1
setObservationConvention
ClientRequestObservationContext
から抽出されたobservation
とそのKeyValues
の名前を設定するObservationConvention
を構成します。何も設定されていない場合、default convention
が使用されます。- パラメーター:
observationConvention
- 使用する観察規則- 導入:
- 6.0
- 関連事項:
getObservationConvention
構成されたClientRequestObservationConvention
、または設定されていない場合はnull
を返します。- 導入:
- 6.1
getForObject
@Nullable public <T> T getForObject(StringSE url, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URL で GET を実行して、表現を取得します。レスポンス(ある場合)が変換されて返されます。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のgetForObject
- パラメーター:
url
- URLresponseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
getForObject
@Nullable public <T> T getForObject(StringSE url, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
URI テンプレートで GET を実行して、表現を取得します。レスポンス(ある場合)が変換されて返されます。URI テンプレート変数は、指定されたマップを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のgetForObject
- パラメーター:
url
- URLresponseType
- 戻り値の型uriVariables
- URI テンプレートの変数を含むマップ- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
getForObject
インターフェースからコピーされた説明:RestOperations
URL で GET を実行して表現を取得します。レスポンス (存在する場合) が変換されて返されます。- 次で指定:
- インターフェース
RestOperations
のgetForObject
- パラメーター:
url
- URLresponseType
- 戻り値の型- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
getForEntity
public <T> ResponseEntity<T> getForEntity(StringSE url, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URL で GET を実行して、エンティティを取得します。レスポンスは変換され、ResponseEntity
に格納されます。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のgetForEntity
- パラメーター:
url
- URLresponseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- エンティティ
- 例外:
RestClientException
getForEntity
public <T> ResponseEntity<T> getForEntity(StringSE url, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
URI テンプレートで GET を実行して表現を取得します。レスポンスは変換され、ResponseEntity
に格納されます。URI テンプレート変数は、指定されたマップを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のgetForEntity
- パラメーター:
url
- URLresponseType
- 戻り値の型uriVariables
- URI テンプレートの変数を含むマップ- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
getForEntity
public <T> ResponseEntity<T> getForEntity(URISE url, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
URL で GET を実行して表現を取得します。レスポンスは変換され、ResponseEntity
に格納されます。- 次で指定:
- インターフェース
RestOperations
のgetForEntity
- パラメーター:
url
- URLresponseType
- 戻り値の型- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
headForHeaders
public HttpHeaders headForHeaders(StringSE url, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
URI テンプレートで指定されたリソースのすべてのヘッダーを取得します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のheadForHeaders
- パラメーター:
url
- URLuriVariables
- テンプレートを展開する変数- 戻り値:
- そのリソースのすべての HTTP ヘッダー
- 例外:
RestClientException
headForHeaders
public HttpHeaders headForHeaders(StringSE url, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
URI テンプレートで指定されたリソースのすべてのヘッダーを取得します。URI テンプレート変数は、指定されたマップを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のheadForHeaders
- パラメーター:
url
- URLuriVariables
- URI テンプレートの変数を含むマップ- 戻り値:
- そのリソースのすべての HTTP ヘッダー
- 例外:
RestClientException
headForHeaders
インターフェースからコピーされた説明:RestOperations
URL で指定されたリソースのすべてのヘッダーを取得します。- 次で指定:
- インターフェース
RestOperations
のheadForHeaders
- パラメーター:
url
- URL- 戻り値:
- そのリソースのすべての HTTP ヘッダー
- 例外:
RestClientException
postForLocation
@Nullable public URISE postForLocation(StringSE url, @Nullable ObjectSE request, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、Location
ヘッダーの値を返します。通常、このヘッダーは新しいリソースが保存される場所を示します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForLocation
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 戻り値:
Location
ヘッダーの値- 例外:
RestClientException
- 関連事項:
postForLocation
@Nullable public URISE postForLocation(StringSE url, @Nullable ObjectSE request, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、Location
ヘッダーの値を返します。通常、このヘッダーは新しいリソースが保存される場所を示します。URI テンプレート変数は、指定されたマップを使用して展開されます。
request
パラメーターは、追加の HTTP ヘッダーをリクエストに追加するためにHttpEntity
にすることができますエンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForLocation
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 戻り値:
Location
ヘッダーの値- 例外:
RestClientException
- 関連事項:
postForLocation
@Nullable public URISE postForLocation(URISE url, @Nullable ObjectSE request) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URL に POST して新しいリソースを作成し、Location
ヘッダーの値を返します。通常、このヘッダーは新しいリソースが保存される場所を示します。リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForLocation
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)- 戻り値:
Location
ヘッダーの値- 例外:
RestClientException
- 関連事項:
postForObject
@Nullable public <T> T postForObject(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForObject
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)responseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
postForObject
@Nullable public <T> T postForObject(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。URI テンプレート変数は、指定されたマップを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForObject
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)responseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
postForObject
@Nullable public <T> T postForObject(URISE url, @Nullable ObjectSE request, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URL に POST して新しいリソースを作成し、レスポンスで見つかった表現を返します。リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForObject
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)responseType
- 戻り値の型- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
postForEntity
public <T> ResponseEntity<T> postForEntity(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスをResponseEntity
として返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForEntity
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
postForEntity
public <T> ResponseEntity<T> postForEntity(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに POST して新しいリソースを作成し、レスポンスをHttpEntity
として返します。URI テンプレート変数は、指定されたマップを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForEntity
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
postForEntity
public <T> ResponseEntity<T> postForEntity(URISE url, @Nullable ObjectSE request, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URL に POST して新しいリソースを作成し、レスポンスをResponseEntity
として返します。リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。エンティティの本体、または
request
自体は、マルチパートリクエストを作成するためにMultiValueMap
にすることができます。MultiValueMap
の値は、パーツのボディを表す任意のオブジェクト、またはボディとヘッダーを持つパーツを表すHttpEntity
のいずれかです。- 次で指定:
- インターフェース
RestOperations
のpostForEntity
- パラメーター:
url
- URLrequest
- POST されるオブジェクト (null
の場合があります)- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
put
public void put(StringSE url, @Nullable ObjectSE request, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI に PUT することにより、リソースを作成または更新します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。- 次で指定:
- インターフェース
RestOperations
のput
- パラメーター:
url
- URLrequest
- PUT されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 例外:
RestClientException
- 関連事項:
put
public void put(StringSE url, @Nullable ObjectSE request, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートに PUT することにより、新しいリソースを作成します。URI テンプレート変数は、指定されたマップを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。- 次で指定:
- インターフェース
RestOperations
のput
- パラメーター:
url
- URLrequest
- PUT されるオブジェクト (null
の場合があります)uriVariables
- テンプレートを展開する変数- 例外:
RestClientException
- 関連事項:
put
インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URL に PUT することにより、新しいリソースを作成します。リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。- 次で指定:
- インターフェース
RestOperations
のput
- パラメーター:
url
- URLrequest
- PUT されるオブジェクト (null
の場合があります)- 例外:
RestClientException
- 関連事項:
patchForObject
@Nullable public <T> T patchForObject(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートにパッチしてリソースを更新し、レスポンスで見つかった表現を返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。NOTE: 標準の JDK HTTP ライブラリは HTTP PATCH をサポートしていません。たとえば、Apache HttpComponents リクエストファクトリを使用する必要があります。
- 次で指定:
- インターフェース
RestOperations
のpatchForObject
- パラメーター:
url
- URLrequest
- パッチされるオブジェクト (null
の場合があります)responseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
patchForObject
@Nullable public <T> T patchForObject(StringSE url, @Nullable ObjectSE request, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URI テンプレートにパッチしてリソースを更新し、レスポンスで見つかった表現を返します。URI テンプレート変数は、指定されたマップを使用して展開されます。
リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。NOTE: 標準の JDK HTTP ライブラリは HTTP PATCH をサポートしていません。たとえば、Apache HttpComponents リクエストファクトリを使用する必要があります。
- 次で指定:
- インターフェース
RestOperations
のpatchForObject
- パラメーター:
url
- URLrequest
- パッチされるオブジェクト (null
の場合があります)responseType
- 戻り値の型uriVariables
- テンプレートを展開する変数- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
patchForObject
@Nullable public <T> T patchForObject(URISE url, @Nullable ObjectSE request, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたオブジェクトを URL にパッチしてリソースを更新し、レスポンスで見つかった表現を返します。リクエストに追加の HTTP ヘッダーを追加するには、
request
パラメーターをHttpEntity
にすることができます。NOTE: 標準の JDK HTTP ライブラリは HTTP PATCH をサポートしていません。たとえば、Apache HttpComponents リクエストファクトリを使用する必要があります。
- 次で指定:
- インターフェース
RestOperations
のpatchForObject
- パラメーター:
url
- URLrequest
- パッチされるオブジェクト (null
の場合があります)responseType
- 戻り値の型- 戻り値:
- 変換されたオブジェクト
- 例外:
RestClientException
- 関連事項:
delete
インターフェースからコピーされた説明:RestOperations
指定された URI のリソースを削除します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のdelete
- パラメーター:
url
- URLuriVariables
- テンプレートで展開する変数- 例外:
RestClientException
delete
インターフェースからコピーされた説明:RestOperations
指定された URI のリソースを削除します。URI テンプレート変数は、指定されたマップを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のdelete
- パラメーター:
url
- URLuriVariables
- テンプレートを展開する変数- 例外:
RestClientException
delete
インターフェースからコピーされた説明:RestOperations
指定された URL のリソースを削除します。- 次で指定:
- インターフェース
RestOperations
のdelete
- パラメーター:
url
- URL- 例外:
RestClientException
optionsForAllow
public SetSE<HttpMethod> optionsForAllow(StringSE url, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URI のAllow
ヘッダーの値を返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のoptionsForAllow
- パラメーター:
url
- URLuriVariables
- テンプレートで展開する変数- 戻り値:
Allow
ヘッダーの値- 例外:
RestClientException
optionsForAllow
public SetSE<HttpMethod> optionsForAllow(StringSE url, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定された URI のAllow
ヘッダーの値を返します。URI テンプレート変数は、指定されたマップを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のoptionsForAllow
- パラメーター:
url
- URLuriVariables
- テンプレートで展開する変数- 戻り値:
Allow
ヘッダーの値- 例外:
RestClientException
optionsForAllow
インターフェースからコピーされた説明:RestOperations
指定された URL のAllow
ヘッダーの値を返します。- 次で指定:
- インターフェース
RestOperations
のoptionsForAllow
- パラメーター:
url
- URL- 戻り値:
Allow
ヘッダーの値- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(StringSE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ClassSE<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文)はnull
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
uriVariables
- テンプレートで展開する変数- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(StringSE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ClassSE<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文) (null
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
uriVariables
- テンプレートで展開する変数- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(URISE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文) (null
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(StringSE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType, ObjectSE... uriVariables) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。指定されたParameterizedTypeReference
は、ジェネリクス型情報を渡すために使用されます。ParameterizedTypeReference<List<MyBean>> myBean = new ParameterizedTypeReference<List<MyBean>>() {}; ResponseEntity<List<MyBean>> response = template.exchange("https://example.com",HttpMethod.GET, null, myBean);
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文) (null
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
uriVariables
- テンプレートで展開する変数- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(StringSE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType, MapSE<StringSE, ?> uriVariables) throws RestClientExceptionインターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。指定されたParameterizedTypeReference
は、ジェネリクス型情報を渡すために使用されます。ParameterizedTypeReference<List<MyBean>> myBean = new ParameterizedTypeReference<List<MyBean>>() {}; ResponseEntity<List<MyBean>> response = template.exchange("https://example.com",HttpMethod.GET, null, myBean);
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文) (null
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
uriVariables
- テンプレートで展開する変数- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(URISE url, HttpMethod method, @Nullable HttpEntity<?> requestEntity, ParameterizedTypeReference<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定された URI テンプレートに対して HTTP メソッドを実行し、指定されたリクエストエンティティをリクエストに書き込み、レスポンスをResponseEntity
として返します。指定されたParameterizedTypeReference
は、ジェネリクス型情報を渡すために使用されます。ParameterizedTypeReference<List<MyBean>> myBean = new ParameterizedTypeReference<List<MyBean>>() {}; ResponseEntity<List<MyBean>> response = template.exchange("https://example.com",HttpMethod.GET, null, myBean);
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestEntity
- リクエストに書き込むエンティティ(ヘッダーおよび / または本文) (null
の場合があります)responseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(RequestEntity<?> entity, ClassSE<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたRequestEntity
で指定されたリクエストを実行し、レスポンスをResponseEntity
として返します。通常、たとえばRequestEntity
の静的ビルダーメソッドと組み合わせて使用されます。MyRequest body = ... RequestEntity request = RequestEntity .post(URI.create("https://example.com/foo")) .accept(MediaType.APPLICATION_JSON) .body(body); ResponseEntity<MyResponse> response = template.exchange(request, MyResponse.class);
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
entity
- リクエストに書き込むエンティティresponseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
exchange
public <T> ResponseEntity<T> exchange(RequestEntity<?> entity, ParameterizedTypeReference<T> responseType) throws RestClientException インターフェースからコピーされた説明:RestOperations
指定されたRequestEntity
で指定されたリクエストを実行し、レスポンスをResponseEntity
として返します。指定されたParameterizedTypeReference
は、一般的な型情報を渡すために使用されます。MyRequest body = ... RequestEntity request = RequestEntity .post(URI.create("https://example.com/foo")) .accept(MediaType.APPLICATION_JSON) .body(body); ParameterizedTypeReference<List<MyResponse>> myBean = new ParameterizedTypeReference<List<MyResponse>>() {}; ResponseEntity<List<MyResponse>> response = template.exchange(request, myBean);
- 次で指定:
- インターフェース
RestOperations
のexchange
- パラメーター:
entity
- リクエストに書き込むエンティティresponseType
- レスポンスを変換する型、または本体なしの場合はVoid.class
- 戻り値:
- エンティティとしてのレスポンス
- 例外:
RestClientException
execute
@Nullable public <T> T execute(StringSE uriTemplate, HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor, ObjectSE... uriVariables) throws RestClientException 指定された URI テンプレートに対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。URI テンプレート変数は、指定された URI 変数があればそれを使用して展開されます。
RequestCallback
またはResponseExtractor
のみを提供し、両方ではない場合は、次の使用を検討してください。- 次で指定:
- インターフェース
RestOperations
のexecute
- パラメーター:
uriTemplate
- URI テンプレートmethod
- HTTP メソッド (GET、POST など)requestCallback
- リクエストを準備するオブジェクトresponseExtractor
- レスポンスから戻り値を抽出するオブジェクトuriVariables
- テンプレートで展開する変数- 戻り値:
ResponseExtractor
によって返される任意のオブジェクト- 例外:
RestClientException
execute
@Nullable public <T> T execute(StringSE uriTemplate, HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor, MapSE<StringSE, ?> uriVariables) throws RestClientException指定された URI テンプレートに対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。URI テンプレート変数は、指定された URI 変数マップを使用して展開されます。
RequestCallback
またはResponseExtractor
のみを提供し、両方ではない場合は、次の使用を検討してください。- 次で指定:
- インターフェース
RestOperations
のexecute
- パラメーター:
uriTemplate
- URI テンプレートmethod
- HTTP メソッド (GET、POST など)requestCallback
- リクエストを準備するオブジェクトresponseExtractor
- レスポンスから戻り値を抽出するオブジェクトuriVariables
- テンプレートで展開する変数- 戻り値:
ResponseExtractor
によって返される任意のオブジェクト- 例外:
RestClientException
execute
@Nullable public <T> T execute(URISE url, HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor) throws RestClientException 指定された URL に対して HTTP メソッドを実行し、RequestCallback
を使用してリクエストを準備し、ResponseExtractor
を使用してレスポンスを読み取ります。RequestCallback
またはResponseExtractor
のみを提供し、両方ではない場合は、次の使用を検討してください。- 次で指定:
- インターフェース
RestOperations
のexecute
- パラメーター:
url
- URLmethod
- HTTP メソッド (GET、POST など)requestCallback
- リクエストを準備するオブジェクトresponseExtractor
- レスポンスから戻り値を抽出するオブジェクト- 戻り値:
ResponseExtractor
によって返される任意のオブジェクト- 例外:
RestClientException
doExecute
@Nullable @DeprecatedSE protected <T> T doExecute(URISE url, @Nullable HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor) throws RestClientException 指定された URI で指定されたメソッドを実行します。ClientHttpRequest
はRequestCallback
を使用して処理されます。ResponseExtractor
を使用したレスポンス。- パラメーター:
url
- 接続する完全に展開された URLmethod
- 実行する HTTP メソッド (GET、POST など)requestCallback
- リクエストを準備するオブジェクト (null
にすることができます)responseExtractor
- レスポンスから戻り値を抽出するオブジェクト (null
にすることができます)- 戻り値:
ResponseExtractor
によって返される任意のオブジェクト- 例外:
RestClientException
doExecute
@Nullable protected <T> T doExecute(URISE url, @Nullable StringSE uriTemplate, @Nullable HttpMethod method, @Nullable RequestCallback requestCallback, @Nullable ResponseExtractor<T> responseExtractor) throws RestClientException 指定された URI で指定されたメソッドを実行します。ClientHttpRequest
はRequestCallback
を使用して処理されます。ResponseExtractor
を使用したレスポンス。- パラメーター:
url
- 接続する完全に展開された URLuriTemplate
- 拡張 URL の作成に使用された URI テンプレートmethod
- 実行する HTTP メソッド (GET、POST など)requestCallback
- リクエストを準備するオブジェクト (null
にすることができます)responseExtractor
- レスポンスから戻り値を抽出するオブジェクト (null
にすることができます)- 戻り値:
ResponseExtractor
によって返される任意のオブジェクト- 例外:
RestClientException
- 導入:
- 6.0
handleResponse
protected void handleResponse(URISE url, HttpMethod method, ClientHttpResponse response) throws IOExceptionSE 指定されたレスポンスを処理し、適切なロギングを実行し、必要に応じてResponseErrorHandler
を呼び出します。サブクラスでオーバーライドできます。
- パラメーター:
url
- 接続する完全に展開された URLmethod
- 実行する HTTP メソッド (GET、POST など)response
- 結果のClientHttpResponse
- 例外:
IOExceptionSE
-ResponseErrorHandler
から伝播された場合- 導入:
- 4.1.6
- 関連事項:
acceptHeaderRequestCallback
指定されたレスポンス型に基づいてリクエストAccept
ヘッダーを設定するRequestCallback
を返し、構成されたメッセージコンバーターと照合します。httpEntityCallback
指定されたオブジェクトをリクエストストリームに書き込むRequestCallback
実装を返します。httpEntityCallback
次のRequestCallback
実装を返します。- 指定されたレスポンス型に基づいて、構成されたメッセージコンバーターに対してクロスチェックされたリクエスト
Accept
ヘッダーを設定します。 - 指定されたオブジェクトをリクエストストリームに書き込みます。
- 指定されたレスポンス型に基づいて、構成されたメッセージコンバーターに対してクロスチェックされたリクエスト
responseEntityExtractor
ResponseEntity
を準備するResponseExtractor
を返します。headersExtractor
HttpHeaders
のレスポンス抽出プログラムを返します。
doExecute(URI, String, HttpMethod, RequestCallback, ResponseExtractor)
を推奨