程序包 cn.taketoday.web.reactive.function.client

类 WebClientResponseException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

cn.taketoday.core.NestedRuntimeException

cn.taketoday.web.reactive.function.client.WebClientException

cn.taketoday.web.reactive.function.client.WebClientResponseException

所有已实现的接口:

Serializable

直接已知子类:

UnknownHttpStatusCodeException, WebClientResponseException.BadGateway, WebClientResponseException.BadRequest, WebClientResponseException.Conflict, WebClientResponseException.Forbidden, WebClientResponseException.GatewayTimeout, WebClientResponseException.Gone, WebClientResponseException.InternalServerError, WebClientResponseException.MethodNotAllowed, WebClientResponseException.NotAcceptable, WebClientResponseException.NotFound, WebClientResponseException.NotImplemented, WebClientResponseException.ServiceUnavailable, WebClientResponseException.TooManyRequests, WebClientResponseException.Unauthorized, WebClientResponseException.UnprocessableEntity, WebClientResponseException.UnsupportedMediaType

public class WebClientResponseException
extends WebClientException

Exceptions that contain actual HTTP response data.

从以下版本开始:

4.0

作者:

Arjen Poutsma

另请参阅:

• 序列化表格

嵌套类概要

嵌套类

修饰符和类型	类	说明
static class	WebClientResponseException.BadGateway	WebClientResponseException for status HTTP HTTP 502 Bad Gateway.
static class	WebClientResponseException.BadRequest	WebClientResponseException for status HTTP 400 Bad Request.
static class	WebClientResponseException.Conflict	WebClientResponseException for status HTTP 409 Conflict.
static class	WebClientResponseException.Forbidden	WebClientResponseException for status HTTP 403 Forbidden.
static class	WebClientResponseException.GatewayTimeout	WebClientResponseException for status HTTP 504 Gateway Timeout.
static class	WebClientResponseException.Gone	WebClientResponseException for status HTTP 410 Gone.
static class	WebClientResponseException.InternalServerError	WebClientResponseException for status HTTP 500 Internal Server Error.
static class	WebClientResponseException.MethodNotAllowed	WebClientResponseException for status HTTP 405 Method Not Allowed.
static class	WebClientResponseException.NotAcceptable	WebClientResponseException for status HTTP 406 Not Acceptable.
static class	WebClientResponseException.NotFound	WebClientResponseException for status HTTP 404 Not Found.
static class	WebClientResponseException.NotImplemented	WebClientResponseException for status HTTP 501 Not Implemented.
static class	WebClientResponseException.ServiceUnavailable	WebClientResponseException for status HTTP 503 Service Unavailable.
static class	WebClientResponseException.TooManyRequests	WebClientResponseException for status HTTP 429 Too Many Requests.
static class	WebClientResponseException.Unauthorized	WebClientResponseException for status HTTP 401 Unauthorized.
static class	WebClientResponseException.UnprocessableEntity	WebClientResponseException for status HTTP 422 Unprocessable Entity.
static class	WebClientResponseException.UnsupportedMediaType	WebClientResponseException for status HTTP 415 Unsupported Media Type.

字段概要

字段

修饰符和类型	字段	说明
private Function<cn.taketoday.core.ResolvableType,?>	bodyDecodeFunction
private final HttpHeaders	headers
private final HttpRequest	request
private final byte[]	responseBody
private final Charset	responseCharset
private static final long	serialVersionUID
private final HttpStatusCode	statusCode
private final String	statusText

构造器概要

构造器

构造器	说明
WebClientResponseException(int statusCode, String statusText, HttpHeaders headers, byte[] body, Charset charset)	Constructor with response data only, and a default message.
WebClientResponseException(int status, String reasonPhrase, HttpHeaders headers, byte[] body, Charset charset, HttpRequest request)	Constructor with response data only, and a default message.
WebClientResponseException(HttpStatusCode statusCode, String reasonPhrase, HttpHeaders headers, byte[] body, Charset charset, HttpRequest request)	Constructor with response data only, and a default message.
WebClientResponseException(String message, int statusCode, String statusText, HttpHeaders headers, byte[] responseBody, Charset charset)	Constructor with a prepared message.
WebClientResponseException(String message, int statusCode, String statusText, HttpHeaders headers, byte[] responseBody, Charset charset, HttpRequest request)	Constructor with a prepared message.
WebClientResponseException(String message, HttpStatusCode statusCode, String statusText, HttpHeaders headers, byte[] responseBody, Charset charset, HttpRequest request)	Constructor with a prepared message.

方法概要

修饰符和类型	方法	说明
static WebClientResponseException	create(int statusCode, String statusText, HttpHeaders headers, byte[] body, Charset charset)	Create WebClientResponseException or an HTTP status specific subclass.
static WebClientResponseException	create(int statusCode, String statusText, HttpHeaders headers, byte[] body, Charset charset, HttpRequest request)	Create WebClientResponseException or an HTTP status specific subclass.
static WebClientResponseException	create(HttpStatusCode statusCode, String statusText, HttpHeaders headers, byte[] body, Charset charset, HttpRequest request)	Create WebClientResponseException or an HTTP status specific subclass.
private <E> E	decodeBody(cn.taketoday.core.ResolvableType targetType)
HttpHeaders	getHeaders()	Return the HTTP response headers.
int	getRawStatusCode()	Return the raw HTTP status code value.
HttpRequest	getRequest()	Return the corresponding request.
<E> E	getResponseBodyAs(cn.taketoday.core.ParameterizedTypeReference<E> targetType)	Variant of getResponseBodyAs(Class) with ParameterizedTypeReference.
<E> E	getResponseBodyAs(Class<E> targetType)	Decode the error content to the specified type.
byte[]	getResponseBodyAsByteArray()	Return the response body as a byte array.
String	getResponseBodyAsString()	Return the response content as a String using the charset of media type for the response, if available, or otherwise falling back on UTF-8.
String	getResponseBodyAsString(Charset defaultCharset)	Variant of getResponseBodyAsString() that allows specifying the charset to fall back on, if a charset is not available from the media type for the response.
HttpStatusCode	getStatusCode()	Return the HTTP status code value.
String	getStatusText()	Return the HTTP status text.
private static String	initMessage(HttpStatusCode status, String reasonPhrase, HttpRequest request)
void	setBodyDecodeFunction(Function<cn.taketoday.core.ResolvableType,?> decoderFunction)	Provide a function to find a decoder the given target type.

从类继承的方法 cn.taketoday.core.NestedRuntimeException

contains, getMostSpecificCause, getNestedMessage, getRootCause

从类继承的方法 java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

从类继承的方法 java.lang.Object

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

字段详细资料

serialVersionUID

private static final long serialVersionUID

另请参阅:

• 常量字段值

statusCode

private final HttpStatusCode statusCode

statusText

private final String statusText

responseBody

private final byte[] responseBody

headers

private final HttpHeaders headers

responseCharset

@Nullable
private final Charset responseCharset

request

@Nullable
private final HttpRequest request

bodyDecodeFunction

@Nullable
private Function<cn.taketoday.core.ResolvableType,?> bodyDecodeFunction

构造器详细资料

WebClientResponseException

public WebClientResponseException(int statusCode,
 String statusText,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] body,
 @Nullable
 Charset charset)

Constructor with response data only, and a default message.

WebClientResponseException

public WebClientResponseException(int status,
 String reasonPhrase,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] body,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Constructor with response data only, and a default message.

WebClientResponseException

public WebClientResponseException(HttpStatusCode statusCode,
 String reasonPhrase,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] body,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Constructor with response data only, and a default message.

WebClientResponseException

public WebClientResponseException(String message,
 int statusCode,
 String statusText,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] responseBody,
 @Nullable
 Charset charset)

Constructor with a prepared message.

WebClientResponseException

public WebClientResponseException(String message,
 int statusCode,
 String statusText,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] responseBody,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Constructor with a prepared message.

WebClientResponseException

public WebClientResponseException(String message,
 HttpStatusCode statusCode,
 String statusText,
 @Nullable
 HttpHeaders headers,
 @Nullable
 byte[] responseBody,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Constructor with a prepared message.

方法详细资料

initMessage

private static String initMessage(HttpStatusCode status,
 String reasonPhrase,
 @Nullable
 HttpRequest request)

getStatusCode

public HttpStatusCode getStatusCode()

Return the HTTP status code value.

抛出:

IllegalArgumentException - in case of an unknown HTTP status code

getRawStatusCode

public int getRawStatusCode()

Return the raw HTTP status code value.

getStatusText

public String getStatusText()

Return the HTTP status text.

getHeaders

public HttpHeaders getHeaders()

Return the HTTP response headers.

getResponseBodyAsByteArray

public byte[] getResponseBodyAsByteArray()

Return the response body as a byte array.

getResponseBodyAsString

public String getResponseBodyAsString()

Return the response content as a String using the charset of media type for the response, if available, or otherwise falling back on UTF-8. Use getResponseBodyAsString(Charset) if you want to fall back on a different, default charset.

另请参阅:

• StandardCharsets.UTF_8

getResponseBodyAsString

public String getResponseBodyAsString(Charset defaultCharset)

Variant of getResponseBodyAsString() that allows specifying the charset to fall back on, if a charset is not available from the media type for the response.

参数:

defaultCharset - the charset to use if the Content-Type of the response does not specify one.

getResponseBodyAs

@Nullable
public <E> E getResponseBodyAs(Class<E> targetType)

Decode the error content to the specified type.

类型参数:

E - the expected target type

参数:

targetType - the type to decode to

返回:

the decoded content, or null if there is no content

抛出:

IllegalStateException - if a Decoder cannot be found

cn.taketoday.core.codec.DecodingException - if decoding fails

getResponseBodyAs

@Nullable
public <E> E getResponseBodyAs(cn.taketoday.core.ParameterizedTypeReference<E> targetType)

Variant of getResponseBodyAs(Class) with ParameterizedTypeReference.

decodeBody

@Nullable
private <E> E decodeBody(cn.taketoday.core.ResolvableType targetType)

getRequest

@Nullable
public HttpRequest getRequest()

Return the corresponding request.

setBodyDecodeFunction

public void setBodyDecodeFunction(Function<cn.taketoday.core.ResolvableType,?> decoderFunction)

Provide a function to find a decoder the given target type. For use with getResponseBodyAs(Class).

参数:

decoderFunction - the function to find a decoder with

create

public static WebClientResponseException create(int statusCode,
 String statusText,
 HttpHeaders headers,
 byte[] body,
 @Nullable
 Charset charset)

Create WebClientResponseException or an HTTP status specific subclass.

create

public static WebClientResponseException create(int statusCode,
 String statusText,
 HttpHeaders headers,
 byte[] body,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Create WebClientResponseException or an HTTP status specific subclass.

create

public static WebClientResponseException create(HttpStatusCode statusCode,
 String statusText,
 HttpHeaders headers,
 byte[] body,
 @Nullable
 Charset charset,
 @Nullable
 HttpRequest request)

Create WebClientResponseException or an HTTP status specific subclass.