クラス ExtractingResponseErrorHandler
- 実装されているすべてのインターフェース:
ResponseErrorHandler
HttpMessageConverters を使用して HTTP エラーレスポンスを RestClientExceptions に変換する ResponseErrorHandler の実装。 このエラーハンドラーを使用するには、ステータスマッピングまたはシリーズマッピング、あるいはその両方を指定する必要があります。これらのマッピングのいずれかが特定の ClientHttpResponse のステータスコードと一致する場合、DefaultResponseErrorHandler.hasError(ClientHttpResponse) は true を返し、DefaultResponseErrorHandler.handleError(ClientHttpResponse) は構成されたメッセージコンバーターを使用してレスポンスを RestClientException のマップされたサブクラスに変換しようとします。ステータスマッピングはシリーズマッピングよりも優先されることに注意してください。
一致しない場合、このエラーハンドラーはデフォルトで DefaultResponseErrorHandler の動作になります。HttpStatus.Series#CLIENT_ERROR および / または HttpStatus.Series#SERVER_ERROR から null へのシリーズマッピングを指定することにより、このデフォルトの動作を上書きできることに注意してください。
- 導入:
- 5.0
- 作成者:
- Simon Galperin, Arjen Poutsma
- 関連事項:
コンストラクターの概要
コンストラクターコンストラクター説明新しい空のExtractingResponseErrorHandlerを作成します。ExtractingResponseErrorHandler(ListSE<HttpMessageConverter<?>> messageConverters) 指定されたHttpMessageConverterインスタンスで新しいExtractingResponseErrorHandlerを作成します。メソッドのサマリー
修飾子と型メソッド説明voidhandleError(ClientHttpResponse response, HttpStatusCode statusCode) 解決されたステータスコードに基づいてエラーを処理します。protected booleanhasError(HttpStatusCode statusCode) DefaultResponseErrorHandler.hasError(ClientHttpResponse)から呼び出されるテンプレートメソッド。voidsetMessageConverters(ListSE<HttpMessageConverter<?>> messageConverters) この抽出プログラムで使用するメッセージコンバーターを設定します。voidsetSeriesMapping(MapSE<HttpStatus.Series, ClassSE<? extends RestClientException>> seriesMapping) HTTP ステータスシリーズからRestClientExceptionサブクラスへのマッピングを設定します。voidsetStatusMapping(MapSE<HttpStatusCode, ClassSE<? extends RestClientException>> statusMapping) HTTP ステータスコードからRestClientExceptionサブクラスへのマッピングを設定します。クラス org.springframework.web.client.DefaultResponseErrorHandler から継承されたメソッド
getCharset, getResponseBody, handleError, hasError, hasError, initBodyConvertFunctionクラス java.lang.ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSEインターフェース org.springframework.web.client.ResponseErrorHandler から継承されたメソッド
handleError
コンストラクターの詳細
ExtractingResponseErrorHandler
public ExtractingResponseErrorHandler()新しい空のExtractingResponseErrorHandlerを作成します。このコンストラクターを使用する場合は、
setMessageConverters(List)を呼び出す必要があることに注意してください。ExtractingResponseErrorHandler
指定されたHttpMessageConverterインスタンスで新しいExtractingResponseErrorHandlerを作成します。- パラメーター:
messageConverters- 使用するメッセージコンバーター
メソッドの詳細
setMessageConverters
この抽出プログラムで使用するメッセージコンバーターを設定します。setStatusMapping
public void setStatusMapping(MapSE<HttpStatusCode, ClassSE<? extends RestClientException>> statusMapping) HTTP ステータスコードからRestClientExceptionサブクラスへのマッピングを設定します。このマッピングが特定のClientHttpResponseのステータスコードと一致する場合、DefaultResponseErrorHandler.hasError(ClientHttpResponse)はtrueを返し、DefaultResponseErrorHandler.handleError(ClientHttpResponse)は構成されたメッセージコンバーターを使用してレスポンスをRestClientExceptionのマップされたサブクラスに変換しようとします。setSeriesMapping
public void setSeriesMapping(MapSE<HttpStatus.Series, ClassSE<? extends RestClientException>> seriesMapping) HTTP ステータスシリーズからRestClientExceptionサブクラスへのマッピングを設定します。このマッピングが特定のClientHttpResponseのステータスコードと一致する場合、DefaultResponseErrorHandler.hasError(ClientHttpResponse)はtrueを返し、DefaultResponseErrorHandler.handleError(ClientHttpResponse)は構成されたメッセージコンバーターを使用してレスポンスをRestClientExceptionのマップされたサブクラスに変換しようとします。hasError
クラスからコピーされた説明:DefaultResponseErrorHandlerDefaultResponseErrorHandler.hasError(ClientHttpResponse)から呼び出されるテンプレートメソッド。デフォルトの実装は
HttpStatusCode.isError()をチェックします。サブクラスでオーバーライドできます。- オーバーライド:
- クラス
DefaultResponseErrorHandlerのhasError - パラメーター:
statusCode- HTTP ステータスコード- 戻り値:
- レスポンスがエラーを示す場合、
true。それ以外の場合はfalse - 関連事項:
handleError
public void handleError(ClientHttpResponse response, HttpStatusCode statusCode) throws IOExceptionSE クラスからコピーされた説明:DefaultResponseErrorHandler解決されたステータスコードに基づいてエラーを処理します。デフォルトの実装は、4xx の範囲のエラーの場合は
HttpClientErrorException.create(org.springframework.http.HttpStatusCode, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset)に委譲し、5xx の範囲のエラーの場合はHttpServerErrorException.create(org.springframework.http.HttpStatusCode, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset)に委譲するか、そうでなければUnknownHttpStatusCodeExceptionを発生させます。- オーバーライド:
- クラス
DefaultResponseErrorHandlerのhandleError - 例外:
IOExceptionSE- 関連事項:
HttpClientErrorException.create(org.springframework.http.HttpStatusCode, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset)HttpServerErrorException.create(org.springframework.http.HttpStatusCode, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset)