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