org.eclipse.jetty.client.api

Interface Response

All Known Subinterfaces:

ContentResponse

All Known Implementing Classes:

HttpContentResponse, HttpResponse

public interface Response

Response represents a HTTP response and offers methods to retrieve status code, HTTP version and headers.

Response objects are passed as parameters to Response.Listener callbacks, or as future result of Request.send().

Response objects do not contain getters for the response content, because it may be too large to fit into memory. The response content should be retrieved via content events, or via utility classes such as BufferingResponseListener.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Response.AsyncContentListener
static interface	Response.BeginListener Listener for the response begin event.
static interface	Response.CompleteListener Listener for the request and response completed event.
static interface	Response.ContentListener Listener for the response content events.
static interface	Response.FailureListener Listener for the response failure event.
static interface	Response.HeaderListener Listener for a response header event.
static interface	Response.HeadersListener Listener for the response headers event.
static interface	Response.Listener Listener for all response events.
static interface	Response.ResponseListener Common, empty, super-interface for response listeners
static interface	Response.SuccessListener Listener for the response succeeded event.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	abort(Throwable cause) Attempts to abort the receive of this response.
HttpFields	getHeaders()
<T extends Response.ResponseListener> List<T>	getListeners(Class<T> listenerClass)
String	getReason()
Request	getRequest()
int	getStatus()
HttpVersion	getVersion()

Method Detail

getRequest

Request getRequest()

Returns:

the request associated with this response

getListeners

<T extends Response.ResponseListener> List<T> getListeners(Class<T> listenerClass)

Returns:

the response listener passed to Request#send(CompleteListener)

getVersion

HttpVersion getVersion()

Returns:

the HTTP version of this response, such as "HTTP/1.1"

getStatus

int getStatus()

Returns:

the HTTP status code of this response, such as 200 or 404

getReason

String getReason()

Returns:

the HTTP reason associated to the getStatus()

getHeaders

HttpFields getHeaders()

Returns:

the headers of this response

abort

boolean abort(Throwable cause)

Attempts to abort the receive of this response.

Parameters:

cause - the abort cause, must not be null

Returns:

whether the abort succeeded