Class RestResponseHandler

java.lang.Object

org.refcodes.web.AbstractHttpRequest

org.refcodes.web.HttpClientRequest

org.refcodes.rest.RestResponseHandler

All Implemented Interfaces:

Closable, Closable.CloseBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>, ConnectionStatusAccessor, LinkComponent, LinkComponent.LinkComponentBuilder<RestResponseHandler>, Openable, Openable.OpenBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>, OpenedAccessor, RestResponseConsumer, HeaderFieldsAccessor<RequestHeaderFields>, HeaderFieldsAccessor.HeaderFieldsBuilder<RequestHeaderFields, RestResponseHandler>, HeaderFieldsAccessor.HeaderFieldsMutator<RequestHeaderFields>, HeaderFieldsAccessor.HeaderFieldsProperty<RequestHeaderFields>, HttpBodyAccessor.HttpBodyProvider<BadRequestException>, HttpMethodAccessor, HttpMethodAccessor.HttpMethodBuilder<RestResponseHandler>, HttpMethodAccessor.HttpMethodMutator, HttpMethodAccessor.HttpMethodProperty, HttpRequest, HttpRequestBuilder<RestResponseHandler>, QueryFieldsAccessor, QueryFieldsAccessor.QueryFieldsMutator, QueryFieldsAccessor.QueryFieldsProperty, RedirectDepthAccessor, RedirectDepthAccessor.RedirectDepthBuilder<RestResponseHandler>, RedirectDepthAccessor.RedirectDepthMutator, RedirectDepthAccessor.RedirectDepthProperty, UrlAccessor, UrlAccessor.UrlBuilder, UrlAccessor.UrlMutator

public class RestResponseHandler
extends HttpClientRequest
implements RestResponseConsumer, QueryFieldsAccessor.QueryFieldsProperty, HeaderFieldsAccessor.HeaderFieldsProperty<RequestHeaderFields>, RedirectDepthAccessor.RedirectDepthBuilder<RestResponseHandler>, HttpRequestBuilder<RestResponseHandler>, HttpMethodAccessor.HttpMethodProperty, HttpMethodAccessor.HttpMethodBuilder<RestResponseHandler>, LinkComponent.LinkComponentBuilder<RestResponseHandler>, ConnectionStatusAccessor, HeaderFieldsAccessor.HeaderFieldsBuilder<RequestHeaderFields, RestResponseHandler>

A RestResponseHandler describes a REST request and the RestResponseConsumer in charge for handling a REST response. The RestResponseHandler describes the HttpMethod to be used, the targeted URL, the HeaderFields as well as the Query-Fields and the request Object or InputStream. It provides builder functionality and lambda support for handling the responses addressed to this RestResponseHandler. The lambda defined as RestResponseConsumer acts as the single listener to this RestResponseHandler responsible for handling the responses for which this RestResponseHandler is responsible. The locator to which a RestResponseHandler targets for is defined by the getUrl() property.

Nested Class Summary

Nested classes/interfaces inherited from interface Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B>

Nested classes/interfaces inherited from interface ConnectionStatusAccessor

ConnectionStatusAccessor.ConnectionStatusMutator, ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface HeaderFieldsAccessor

HeaderFieldsAccessor.HeaderFieldsBuilder<T,B>, HeaderFieldsAccessor.HeaderFieldsMutator<T>, HeaderFieldsAccessor.HeaderFieldsProperty<T>

Nested classes/interfaces inherited from interface HttpMethodAccessor

HttpMethodAccessor.HttpMethodBuilder<B>, HttpMethodAccessor.HttpMethodMutator, HttpMethodAccessor.HttpMethodProperty

Nested classes/interfaces inherited from interface LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B>

Nested classes/interfaces inherited from interface Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B>

Nested classes/interfaces inherited from interface OpenedAccessor

OpenedAccessor.OpenedMutator, OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface QueryFieldsAccessor

QueryFieldsAccessor.QueryFieldsBuilder<B>, QueryFieldsAccessor.QueryFieldsMutator, QueryFieldsAccessor.QueryFieldsProperty

Nested classes/interfaces inherited from interface RedirectDepthAccessor

RedirectDepthAccessor.RedirectDepthBuilder<B>, RedirectDepthAccessor.RedirectDepthMutator, RedirectDepthAccessor.RedirectDepthProperty

Nested classes/interfaces inherited from interface UrlAccessor

UrlAccessor.UrlBuilder, UrlAccessor.UrlMutator, UrlAccessor.UrlProperty

Field Summary

Fields inherited from class HttpClientRequest

_mediaTypeFactoryLookup, DEFAULT_REDIRECT_DEPTH

Fields inherited from class AbstractHttpRequest

_headerFields, _httpMethod, _url

Constructor Summary

Constructors

Constructor	Description
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, Object aRequest, int aRedirectDepth, RestResponseConsumer aResponseConsumer, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, Object aRequest, RestResponseConsumer aResponseConsumer, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, RestResponseConsumer aResponseConsumer, int aRedirectDepth, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, RestResponseConsumer aResponseConsumer, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aHeaderFields, Object aRequest, int aRedirectDepth, RestResponseConsumer aResponseConsumer, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aHeaderFields, Object aRequest, RestResponseConsumer aResponseConsumer, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.
RestResponseHandler(MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Instantiates a new RestResponseHandler.

Method Summary

Modifier and Type	Method	Description
static RestResponseHandler	build(RestClient aRestClient)	This is a convenience method for easily instantiating the according builder.
void	close()
ConnectionStatus	getConnectionStatus()
HttpMethod	getHttpMethod()
FormFields	getQueryFields()
RestResponseConsumer	getResponseObserver()	Retrieves the RestResponseConsumer to which any responses are delegated upon invocation of the onResponse(RestResponseEvent) method.
Url	getUrl()
void	onResponse(RestResponseEvent aResponse)	The invoker provides a response context being a RestResponseEvent describing the response being processed upon by your lambda's code.
void	open()
void	setHeaderFields(RequestHeaderFields aHeaderFields)
void	setHttpMethod(HttpMethod aHttpMethod)
void	setQueryFields(FormFields aQueryFields)
void	setResponseObserver(RestResponseConsumer aLambda)	Sets the RestResponseConsumer to which any responses are delegated upon invocation of the onResponse(RestResponseEvent) method.
void	setUrl(Url aUrl)
String	toString()
RestResponseHandler	withClose()
RestResponseHandler	withCloseIn(int aCloseMillis)
RestResponseHandler	withCloseQuietly()
RestResponseHandler	withHeaderFields(RequestHeaderFields aRequestHeaderFields)
RestResponseHandler	withHttpMethod(HttpMethod aHttpMethod)
RestResponseHandler	withOpen()
RestResponseHandler	withRedirectDepth(int aRedirectDepth)
<REQ> RestResponseHandler	withRequest(REQ aRequest)	Sets the request for the request property.
RestResponseHandler	withResponseObserver(RestResponseConsumer aLambda)	Builder method for setting the RestResponseConsumer.
RestResponseHandler	withUrl(Url aUrl)

Methods inherited from class HttpClientRequest

getRedirectDepth, getRequest, setRedirectDepth, setRequest, toHttpBody

Methods inherited from class AbstractHttpRequest

getHeaderFields

Methods inherited from class Object

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

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface Closable.CloseBuilder

withCloseUnchecked

Methods inherited from interface ConnectionStatusAccessor

isOpened

Methods inherited from interface HeaderFieldsAccessor

getHeaderFields

Methods inherited from interface HeaderFieldsAccessor.HeaderFieldsProperty

letHeaderFields

Methods inherited from interface HttpMethodAccessor.HttpMethodProperty

letHttpMethod

Methods inherited from interface HttpRequestBuilder

withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToHeaderFields, withAddToQueryFields, withAddToQueryFields, withAddToQueryFields

Methods inherited from interface Openable

openUnchecked

Methods inherited from interface Openable.OpenBuilder

withOpenUnchecked

Methods inherited from interface QueryFieldsAccessor.QueryFieldsProperty

letQueryFields

Methods inherited from interface RedirectDepthAccessor.RedirectDepthProperty

letRedirectDepth

Constructor Details

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aHeaderFields,
 Object aRequest,
 RestResponseConsumer aResponseConsumer,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aHeaderFields - the Header-Fields

aRequest - the request

aResponseConsumer - the response observer

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 RestResponseConsumer aResponseConsumer,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aResponseConsumer - the response observer

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 Object aRequest,
 RestResponseConsumer aResponseConsumer,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aRequest - the request

aResponseConsumer - the response observer

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 RestResponseConsumer aResponseConsumer,
 int aRedirectDepth,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aResponseConsumer - the response observer

aRedirectDepth - The redirect depth provides the count of HTTP-Request and HTTP-Response cycles where the response represents a redirect as of HttpStatusCode.isRedirectStatus(). A value of -1 represents the default behavior, e.g. using HttpURLConnection's redirection means.

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 Object aRequest,
 int aRedirectDepth,
 RestResponseConsumer aResponseConsumer,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aRequest - the request

aRedirectDepth - The redirect depth provides the count of HTTP-Request and HTTP-Response cycles where the response represents a redirect as of HttpStatusCode.isRedirectStatus(). A value of -1 represents the default behavior, e.g. using HttpURLConnection's redirection means.

aResponseConsumer - the response observer

aMediaTypeFactoryLookup - the media type factory lookup

RestResponseHandler

public RestResponseHandler(HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aHeaderFields,
 Object aRequest,
 int aRedirectDepth,
 RestResponseConsumer aResponseConsumer,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Instantiates a new RestResponseHandler.

Parameters:

aHttpMethod - the http method

aUrl - The Url from which to take the URL specific data.

aHeaderFields - the Header-Fields

aRequest - the request

aRedirectDepth - The redirect depth provides the count of HTTP-Request and HTTP-Response cycles where the response represents a redirect as of HttpStatusCode.isRedirectStatus(). A value of -1 represents the default behavior, e.g. using HttpURLConnection's redirection means.

aResponseConsumer - the response observer

aMediaTypeFactoryLookup - the media type factory lookup

Method Details

withRedirectDepth

public RestResponseHandler withRedirectDepth(int aRedirectDepth)

Specified by:

withRedirectDepth in interface RedirectDepthAccessor.RedirectDepthBuilder<RestResponseHandler>

setQueryFields

public void setQueryFields(FormFields aQueryFields)

Specified by:

setQueryFields in interface QueryFieldsAccessor.QueryFieldsMutator

getQueryFields

public FormFields getQueryFields()

Specified by:

getQueryFields in interface QueryFieldsAccessor

withUrl

public RestResponseHandler withUrl(Url aUrl)

Specified by:

withUrl in interface UrlAccessor.UrlBuilder

withHttpMethod

public RestResponseHandler withHttpMethod(HttpMethod aHttpMethod)

Specified by:

withHttpMethod in interface HttpMethodAccessor.HttpMethodBuilder<RestResponseHandler>

withRequest

public <REQ> RestResponseHandler withRequest(REQ aRequest)

Sets the request for the request property.

Type Parameters:

REQ - the generic type

Parameters:

aRequest - The request to be stored by the request property.

Returns:

The builder for applying multiple build operations.

onResponse

public void onResponse(RestResponseEvent aResponse)
                throws HttpResponseException

The invoker provides a response context being a RestResponseEvent describing the response being processed upon by your lambda's code. The method works synchronously and waits (blocks the caller's thread) till it finishes execution.

Specified by:

onResponse in interface RestResponseConsumer

Parameters:

aResponse - The response of type RestResponseEvent describing the response context. Use HttpClientResponse.getResponse(Class) to retrieve the server's response body or AbstractHttpResponse.getHttpStatusCode() to retrieve the respone's HTTP Status-Code.

Throws:

HttpResponseException - thrown by a HTTP-Response handling system in case of some unexpected response.

getHttpMethod

public HttpMethod getHttpMethod()

Specified by:

getHttpMethod in interface HttpMethodAccessor

Overrides:

getHttpMethod in class AbstractHttpRequest

setHttpMethod

public void setHttpMethod(HttpMethod aHttpMethod)

Specified by:

setHttpMethod in interface HttpMethodAccessor.HttpMethodMutator

getResponseObserver

public RestResponseConsumer getResponseObserver()

Retrieves the RestResponseConsumer to which any responses are delegated upon invocation of the onResponse(RestResponseEvent) method.

Returns:

The (user defined) RestResponseConsumer to handle responses.

setResponseObserver

public void setResponseObserver(RestResponseConsumer aLambda)

Sets the RestResponseConsumer to which any responses are delegated upon invocation of the onResponse(RestResponseEvent) method.

Parameters:

aLambda - The (user defined) RestResponseConsumer to handle responses, feel free to code it as lambda expression!

open

public void open()
          throws IOException

Specified by:

open in interface Openable

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closable

Throws:

IOException

getConnectionStatus

public ConnectionStatus getConnectionStatus()

Specified by:

getConnectionStatus in interface ConnectionStatusAccessor

setHeaderFields

public void setHeaderFields(RequestHeaderFields aHeaderFields)

Specified by:

setHeaderFields in interface HeaderFieldsAccessor.HeaderFieldsMutator<RequestHeaderFields>

getUrl

public Url getUrl()

Specified by:

getUrl in interface UrlAccessor

Overrides:

getUrl in class AbstractHttpRequest

setUrl

public void setUrl(Url aUrl)

Specified by:

setUrl in interface UrlAccessor.UrlMutator

withResponseObserver

public RestResponseHandler withResponseObserver(RestResponseConsumer aLambda)

Builder method for setting the RestResponseConsumer.

Parameters:

aLambda - The (user defined) RestResponseConsumer to handle responses, feel free to code it as lambda expression

Returns:

The RestResponseHandler for the sake of a fluent API.

withHeaderFields

public RestResponseHandler withHeaderFields(RequestHeaderFields aRequestHeaderFields)

Specified by:

withHeaderFields in interface HeaderFieldsAccessor.HeaderFieldsBuilder<RequestHeaderFields, RestResponseHandler>

withOpen

public RestResponseHandler withOpen()
                             throws IOException

Specified by:

withOpen in interface Openable.OpenBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>

Throws:

IOException

withClose

public RestResponseHandler withClose()
                              throws IOException

Specified by:

withClose in interface Closable.CloseBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>

Throws:

IOException

withCloseQuietly

public RestResponseHandler withCloseQuietly()

Specified by:

withCloseQuietly in interface Closable.CloseBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>

withCloseIn

public RestResponseHandler withCloseIn(int aCloseMillis)

Specified by:

withCloseIn in interface Closable.CloseBuilder<LinkComponent.LinkComponentBuilder<RestResponseHandler>>

toString

public String toString()

Overrides:

toString in class HttpClientRequest

build

public static RestResponseHandler build(RestClient aRestClient)

This is a convenience method for easily instantiating the according builder.

Parameters:

aRestClient - the rest client to take care of the caller.

Returns:

an instance (using a public implementation) of this builder