org.springframework.web.client

Class DefaultResponseErrorHandler

java.lang.Object

org.springframework.web.client.DefaultResponseErrorHandler

All Implemented Interfaces:

ResponseErrorHandler

Direct Known Subclasses:

ExtractingResponseErrorHandler

public class DefaultResponseErrorHandler
extends java.lang.Object
implements ResponseErrorHandler

Spring's default implementation of the ResponseErrorHandler interface.

This error handler checks for the status code on the ClientHttpResponse: Any code with series HttpStatus.Series.CLIENT_ERROR or HttpStatus.Series.SERVER_ERROR is considered to be an error; this behavior can be changed by overriding the hasError(HttpStatus) method. Unknown status codes will be ignored by hasError(ClientHttpResponse).

Since:

3.0

Author:

Arjen Poutsma, Rossen Stoyanchev, Juergen Hoeller

See Also:

RestTemplate.setErrorHandler(org.springframework.web.client.ResponseErrorHandler)

Constructor Summary

Constructors

Constructor and Description
DefaultResponseErrorHandler()

Method Summary

Modifier and Type	Method and Description
protected java.nio.charset.Charset	getCharset(ClientHttpResponse response) Determine the charset of the response (for inclusion in a status exception).
protected HttpStatus	getHttpStatusCode(ClientHttpResponse response) Deprecated. as of 5.0, in favor of handleError(ClientHttpResponse, HttpStatus)
protected byte[]	getResponseBody(ClientHttpResponse response) Read the body of the given response (for inclusion in a status exception).
void	handleError(ClientHttpResponse response) Delegates to handleError(ClientHttpResponse, HttpStatus) with the response status code.
protected void	handleError(ClientHttpResponse response, HttpStatus statusCode) Handle the error in the given response with the given resolved status code.
boolean	hasError(ClientHttpResponse response) Delegates to hasError(HttpStatus) (for a standard status enum value) or hasError(int) (for an unknown status code) with the response status code.
protected boolean	hasError(HttpStatus statusCode) Template method called from hasError(ClientHttpResponse).
protected boolean	hasError(int unknownStatusCode) Template method called from hasError(ClientHttpResponse).

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.web.client.ResponseErrorHandler

handleError

Constructor Detail

DefaultResponseErrorHandler

public DefaultResponseErrorHandler()

Method Detail

hasError

public boolean hasError(ClientHttpResponse response)
                 throws java.io.IOException

Delegates to hasError(HttpStatus) (for a standard status enum value) or hasError(int) (for an unknown status code) with the response status code.

Specified by:

hasError in interface ResponseErrorHandler

Parameters:

response - the response to inspect

Returns:

true if the response indicates an error; false otherwise

Throws:

java.io.IOException - in case of I/O errors

See Also:

ClientHttpResponse.getRawStatusCode(), hasError(HttpStatus), hasError(int)

hasError

protected boolean hasError(HttpStatus statusCode)

Template method called from hasError(ClientHttpResponse).

The default implementation checks HttpStatus.isError(). Can be overridden in subclasses.

Parameters:

statusCode - the HTTP status code as enum value

Returns:

true if the response indicates an error; false otherwise

See Also:

HttpStatus.isError()

hasError

protected boolean hasError(int unknownStatusCode)

Template method called from hasError(ClientHttpResponse).

The default implementation checks if the given status code is HttpStatus.Series#CLIENT_ERROR CLIENT_ERROR or HttpStatus.Series#SERVER_ERROR SERVER_ERROR. Can be overridden in subclasses.

Parameters:

unknownStatusCode - the HTTP status code as raw value

Returns:

true if the response indicates an error; false otherwise

Since:

4.3.21

See Also:

HttpStatus.Series#CLIENT_ERROR, HttpStatus.Series#SERVER_ERROR

handleError

public void handleError(ClientHttpResponse response)
                 throws java.io.IOException

Delegates to handleError(ClientHttpResponse, HttpStatus) with the response status code.

Specified by:

handleError in interface ResponseErrorHandler

Parameters:

response - the response with the error

Throws:

UnknownHttpStatusCodeException - in case of an unresolvable status code

java.io.IOException - in case of I/O errors

See Also:

handleError(ClientHttpResponse, HttpStatus)

handleError

protected void handleError(ClientHttpResponse response,
                           HttpStatus statusCode)
                    throws java.io.IOException

Handle the error in the given response with the given resolved status code.

The default implementation throws an HttpClientErrorException if the status code is HttpStatus.Series#CLIENT_ERROR, an HttpServerErrorException if it is HttpStatus.Series#SERVER_ERROR, and an UnknownHttpStatusCodeException in other cases.

Throws:

java.io.IOException

Since:

5.0

See Also:

HttpClientErrorException.create(org.springframework.http.HttpStatus, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset), HttpServerErrorException.create(org.springframework.http.HttpStatus, java.lang.String, org.springframework.http.HttpHeaders, byte[], java.nio.charset.Charset)

getHttpStatusCode

@Deprecated
protected HttpStatus getHttpStatusCode(ClientHttpResponse response)
                                            throws java.io.IOException

Deprecated. as of 5.0, in favor of handleError(ClientHttpResponse, HttpStatus)

Determine the HTTP status of the given response.

Parameters:

response - the response to inspect

Returns:

the associated HTTP status

Throws:

java.io.IOException - in case of I/O errors

UnknownHttpStatusCodeException - in case of an unknown status code that cannot be represented with the HttpStatus enum

Since:

4.3.8

getResponseBody

protected byte[] getResponseBody(ClientHttpResponse response)

Read the body of the given response (for inclusion in a status exception).

Parameters:

response - the response to inspect

Returns:

the response body as a byte array, or an empty byte array if the body could not be read

Since:

4.3.8

getCharset

@Nullable
protected java.nio.charset.Charset getCharset(ClientHttpResponse response)

Determine the charset of the response (for inclusion in a status exception).

Parameters:

response - the response to inspect

Returns:

the associated charset, or null if none

Since:

4.3.8