public interface ResponsePredicate extends java.util.function.Function<HttpResponse<Void>,ResponsePredicateResult>
HttpResponse
.
By default, a Vert.x Web Client request ends with an error only if something wrong happens at the network level.
In other words, a 404 Not Found
response, or a response with the wrong content type, are NOT considered as failures.
Response predicates
can fail a request when the response does not match some criteria.
Custom predicate instances can be used with HttpRequest.expect(Function)
.
As a convenience, a few predicates for common uses cases are predefined. For example:
SC_SUCCESS
to verify that the response has a 2xx
code, orJSON
to verify that the response body contains JSON data.
However, you can create a new ResponsePredicate
instance from an existing one using create(Function)
or
create(Function, ErrorConverter)
when the body is required to build the validation failure.
Modifier and Type | Field and Description |
---|---|
static ResponsePredicate |
JSON
Creates a predicate validating the response
content-type is application/json . |
static ResponsePredicate |
SC_ACCEPTED
202 Accepted
|
static ResponsePredicate |
SC_BAD_GATEWAY
502 Bad Gateway
|
static ResponsePredicate |
SC_BAD_REQUEST
400 Bad Request
|
static ResponsePredicate |
SC_CLIENT_ERRORS
Any 4XX client error
|
static ResponsePredicate |
SC_CONFLICT
409 Conflict
|
static ResponsePredicate |
SC_CONTINUE
100 Continue
|
static ResponsePredicate |
SC_CREATED
201 Created
|
static ResponsePredicate |
SC_EARLY_HINTS
103 Early Hints
|
static ResponsePredicate |
SC_EXPECTATION_FAILED
417 Expectation Failed
|
static ResponsePredicate |
SC_FAILED_DEPENDENCY
424 Failed Dependency (WebDAV, RFC4918)
|
static ResponsePredicate |
SC_FORBIDDEN
403 Forbidden
|
static ResponsePredicate |
SC_FOUND
302 Found
|
static ResponsePredicate |
SC_GATEWAY_TIMEOUT
504 Gateway Timeout
|
static ResponsePredicate |
SC_GONE
410 Gone
|
static ResponsePredicate |
SC_HTTP_VERSION_NOT_SUPPORTED
505 HTTP Version Not Supported
|
static ResponsePredicate |
SC_INFORMATIONAL_RESPONSE
Any 1XX informational response
|
static ResponsePredicate |
SC_INSUFFICIENT_STORAGE
507 Insufficient Storage (WebDAV, RFC4918)
|
static ResponsePredicate |
SC_INTERNAL_SERVER_ERROR
500 Internal Server Error
|
static ResponsePredicate |
SC_LENGTH_REQUIRED
411 Length Required
|
static ResponsePredicate |
SC_LOCKED
423 Locked (WebDAV, RFC4918)
|
static ResponsePredicate |
SC_METHOD_NOT_ALLOWED
405 Method Not Allowed
|
static ResponsePredicate |
SC_MISDIRECTED_REQUEST
421 Misdirected Request
|
static ResponsePredicate |
SC_MOVED_PERMANENTLY
301 Moved Permanently
|
static ResponsePredicate |
SC_MULTI_STATUS
207 Multi-Status (WebDAV, RFC2518)
|
static ResponsePredicate |
SC_MULTIPLE_CHOICES
300 Multiple Choices
|
static ResponsePredicate |
SC_NETWORK_AUTHENTICATION_REQUIRED
511 Network Authentication Required (RFC6585)
|
static ResponsePredicate |
SC_NO_CONTENT
204 No Content
|
static ResponsePredicate |
SC_NON_AUTHORITATIVE_INFORMATION
203 Non-Authoritative Information (since HTTP/1.1)
|
static ResponsePredicate |
SC_NOT_ACCEPTABLE
406 Not Acceptable
|
static ResponsePredicate |
SC_NOT_EXTENDED
510 Not Extended (RFC2774)
|
static ResponsePredicate |
SC_NOT_FOUND
404 Not Found
|
static ResponsePredicate |
SC_NOT_IMPLEMENTED
501 Not Implemented
|
static ResponsePredicate |
SC_NOT_MODIFIED
304 Not Modified
|
static ResponsePredicate |
SC_OK
200 OK
|
static ResponsePredicate |
SC_PARTIAL_CONTENT
206 Partial Content
|
static ResponsePredicate |
SC_PAYMENT_REQUIRED
402 Payment Required
|
static ResponsePredicate |
SC_PERMANENT_REDIRECT
308 Permanent Redirect (RFC7538)
|
static ResponsePredicate |
SC_PRECONDITION_FAILED
412 Precondition Failed
|
static ResponsePredicate |
SC_PRECONDITION_REQUIRED
428 Precondition Required (RFC6585)
|
static ResponsePredicate |
SC_PROCESSING
102 Processing (WebDAV, RFC2518)
|
static ResponsePredicate |
SC_PROXY_AUTHENTICATION_REQUIRED
407 Proxy Authentication Required
|
static ResponsePredicate |
SC_REDIRECTION
Any 3XX redirection
|
static ResponsePredicate |
SC_REQUEST_ENTITY_TOO_LARGE
413 Request Entity Too Large
|
static ResponsePredicate |
SC_REQUEST_HEADER_FIELDS_TOO_LARGE
431 Request Header Fields Too Large (RFC6585)
|
static ResponsePredicate |
SC_REQUEST_TIMEOUT
408 Request Timeout
|
static ResponsePredicate |
SC_REQUEST_URI_TOO_LONG
414 Request-URI Too Long
|
static ResponsePredicate |
SC_REQUESTED_RANGE_NOT_SATISFIABLE
416 Requested Range Not Satisfiable
|
static ResponsePredicate |
SC_RESET_CONTENT
205 Reset Content
|
static ResponsePredicate |
SC_SEE_OTHER
303 See Other (since HTTP/1.1)
|
static ResponsePredicate |
SC_SERVER_ERRORS
Any 5XX server error
|
static ResponsePredicate |
SC_SERVICE_UNAVAILABLE
503 Service Unavailable
|
static ResponsePredicate |
SC_SUCCESS
Any 2XX success
|
static ResponsePredicate |
SC_SWITCHING_PROTOCOLS
101 Switching Protocols
|
static ResponsePredicate |
SC_TEMPORARY_REDIRECT
307 Temporary Redirect (since HTTP/1.1)
|
static ResponsePredicate |
SC_TOO_MANY_REQUESTS
429 Too Many Requests (RFC6585)
|
static ResponsePredicate |
SC_UNAUTHORIZED
401 Unauthorized
|
static ResponsePredicate |
SC_UNORDERED_COLLECTION
425 Unordered Collection (WebDAV, RFC3648)
|
static ResponsePredicate |
SC_UNPROCESSABLE_ENTITY
422 Unprocessable Entity (WebDAV, RFC4918)
|
static ResponsePredicate |
SC_UNSUPPORTED_MEDIA_TYPE
415 Unsupported Media Type
|
static ResponsePredicate |
SC_UPGRADE_REQUIRED
426 Upgrade Required (RFC2817)
|
static ResponsePredicate |
SC_USE_PROXY
305 Use Proxy (since HTTP/1.1)
|
static ResponsePredicate |
SC_VARIANT_ALSO_NEGOTIATES
506 Variant Also Negotiates (RFC2295)
|
Modifier and Type | Method and Description |
---|---|
static ResponsePredicate |
contentType(List<String> mimeTypes)
Creates a predicate validating the response has a
content-type header matching one of the mimeTypes . |
static ResponsePredicate |
contentType(String mimeType)
Creates a predicate validating the response has a
content-type header matching the mimeType . |
static ResponsePredicate |
create(java.util.function.Function<HttpResponse<Void>,ResponsePredicateResult> test)
Creates a new
ResponsePredicate . |
static ResponsePredicate |
create(java.util.function.Function<HttpResponse<Void>,ResponsePredicateResult> test,
ErrorConverter errorConverter)
Creates a new
ResponsePredicate , using a custom errorConverter . |
default ErrorConverter |
errorConverter() |
static ResponsePredicate |
status(int statusCode)
Creates a predicate asserting that the status response code is equal to
statusCode . |
static ResponsePredicate |
status(int min,
int max)
Creates a predicate asserting that the status response code is in the
[min,max[ range. |
andThen, apply, compose, identity
static final ResponsePredicate SC_INFORMATIONAL_RESPONSE
static final ResponsePredicate SC_CONTINUE
static final ResponsePredicate SC_SWITCHING_PROTOCOLS
static final ResponsePredicate SC_PROCESSING
static final ResponsePredicate SC_EARLY_HINTS
static final ResponsePredicate SC_SUCCESS
static final ResponsePredicate SC_OK
static final ResponsePredicate SC_CREATED
static final ResponsePredicate SC_ACCEPTED
static final ResponsePredicate SC_NON_AUTHORITATIVE_INFORMATION
static final ResponsePredicate SC_NO_CONTENT
static final ResponsePredicate SC_RESET_CONTENT
static final ResponsePredicate SC_PARTIAL_CONTENT
static final ResponsePredicate SC_MULTI_STATUS
static final ResponsePredicate SC_REDIRECTION
static final ResponsePredicate SC_MULTIPLE_CHOICES
static final ResponsePredicate SC_MOVED_PERMANENTLY
static final ResponsePredicate SC_FOUND
static final ResponsePredicate SC_SEE_OTHER
static final ResponsePredicate SC_NOT_MODIFIED
static final ResponsePredicate SC_USE_PROXY
static final ResponsePredicate SC_TEMPORARY_REDIRECT
static final ResponsePredicate SC_PERMANENT_REDIRECT
static final ResponsePredicate SC_CLIENT_ERRORS
static final ResponsePredicate SC_BAD_REQUEST
static final ResponsePredicate SC_UNAUTHORIZED
static final ResponsePredicate SC_PAYMENT_REQUIRED
static final ResponsePredicate SC_FORBIDDEN
static final ResponsePredicate SC_NOT_FOUND
static final ResponsePredicate SC_METHOD_NOT_ALLOWED
static final ResponsePredicate SC_NOT_ACCEPTABLE
static final ResponsePredicate SC_PROXY_AUTHENTICATION_REQUIRED
static final ResponsePredicate SC_REQUEST_TIMEOUT
static final ResponsePredicate SC_CONFLICT
static final ResponsePredicate SC_GONE
static final ResponsePredicate SC_LENGTH_REQUIRED
static final ResponsePredicate SC_PRECONDITION_FAILED
static final ResponsePredicate SC_REQUEST_ENTITY_TOO_LARGE
static final ResponsePredicate SC_REQUEST_URI_TOO_LONG
static final ResponsePredicate SC_UNSUPPORTED_MEDIA_TYPE
static final ResponsePredicate SC_REQUESTED_RANGE_NOT_SATISFIABLE
static final ResponsePredicate SC_EXPECTATION_FAILED
static final ResponsePredicate SC_MISDIRECTED_REQUEST
static final ResponsePredicate SC_UNPROCESSABLE_ENTITY
static final ResponsePredicate SC_LOCKED
static final ResponsePredicate SC_FAILED_DEPENDENCY
static final ResponsePredicate SC_UNORDERED_COLLECTION
static final ResponsePredicate SC_UPGRADE_REQUIRED
static final ResponsePredicate SC_PRECONDITION_REQUIRED
static final ResponsePredicate SC_TOO_MANY_REQUESTS
static final ResponsePredicate SC_REQUEST_HEADER_FIELDS_TOO_LARGE
static final ResponsePredicate SC_SERVER_ERRORS
static final ResponsePredicate SC_INTERNAL_SERVER_ERROR
static final ResponsePredicate SC_NOT_IMPLEMENTED
static final ResponsePredicate SC_BAD_GATEWAY
static final ResponsePredicate SC_SERVICE_UNAVAILABLE
static final ResponsePredicate SC_GATEWAY_TIMEOUT
static final ResponsePredicate SC_HTTP_VERSION_NOT_SUPPORTED
static final ResponsePredicate SC_VARIANT_ALSO_NEGOTIATES
static final ResponsePredicate SC_INSUFFICIENT_STORAGE
static final ResponsePredicate SC_NOT_EXTENDED
static final ResponsePredicate SC_NETWORK_AUTHENTICATION_REQUIRED
static final ResponsePredicate JSON
content-type
is application/json
.static ResponsePredicate status(int statusCode)
statusCode
.statusCode
- the expected status codestatic ResponsePredicate status(int min, int max)
[min,max[
range.min
- the lower (inclusive) accepted status codemax
- the highest (exclusive) accepted status codestatic ResponsePredicate contentType(String mimeType)
content-type
header matching the mimeType
.mimeType
- the mime typestatic ResponsePredicate contentType(List<String> mimeTypes)
content-type
header matching one of the mimeTypes
.mimeTypes
- the list of mime typesstatic ResponsePredicate create(java.util.function.Function<HttpResponse<Void>,ResponsePredicateResult> test)
ResponsePredicate
. The default error converter will be used (discarding the body).test
- the function to invoke when the response is receivedstatic ResponsePredicate create(java.util.function.Function<HttpResponse<Void>,ResponsePredicateResult> test, ErrorConverter errorConverter)
ResponsePredicate
, using a custom errorConverter
.test
- the function to invoke when the response is receivederrorConverter
- converts the result of the test
function to a Throwable
default ErrorConverter errorConverter()
Copyright © 2022 Eclipse. All rights reserved.