Class RestRequest

java.lang.Object

org.refcodes.web.AbstractHttpRequest

org.refcodes.web.HttpClientRequest

org.refcodes.rest.RestRequest

All Implemented Interfaces:

HeaderFieldsAccessor<RequestHeaderFields>, HeaderFieldsAccessor.HeaderFieldsMutator<RequestHeaderFields>, HeaderFieldsAccessor.HeaderFieldsProperty<RequestHeaderFields>, HttpBodyAccessor.HttpBodyProvider<BadRequestException>, HttpMethodAccessor, HttpRequest, RedirectDepthAccessor, RedirectDepthAccessor.RedirectDepthMutator, RedirectDepthAccessor.RedirectDepthProperty, UrlAccessor

Direct Known Subclasses:

RestRequestBuilder

public class RestRequest
extends HttpClientRequest
implements HeaderFieldsAccessor.HeaderFieldsProperty<RequestHeaderFields>

A RestRequest describes a REST request and the RestResponse providing the response. The RestRequest describes the HttpMethod to be used, the targeted URL, the HeaderFields as well as the Query-Fields and the request Object or InputStream.

Nested Class Summary

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 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

Modifier	Constructor	Description
protected	RestRequest(RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, int aRedirectDepth, RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, Object aRequest, int aRedirectDepth, RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, Object aRequest, RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aHeaderFields, Object aRequest, int aRedirectDepth, RestClient aRestClient)	Instantiates a new rest request builder impl.
protected	RestRequest(HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aHeaderFields, Object aRequest, RestClient aRestClient)	Instantiates a new rest request builder impl.

Method Summary

Modifier and Type	Method	Description
RestRequest	build(RestClient aRestClient)	This is a convenience method for easily instantiating the according builder.
HttpMethod	getHttpMethod()
UrlBuilder	getUrl()
void	setHeaderFields(RequestHeaderFields aHeaderFields)
RestResponse	toRestResponse()	Sends the request and returns synchronously the according RestResponse.
String	toString()

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 HeaderFieldsAccessor

getHeaderFields

Methods inherited from interface HeaderFieldsAccessor.HeaderFieldsProperty

letHeaderFields

Methods inherited from interface RedirectDepthAccessor.RedirectDepthProperty

letRedirectDepth

Constructor Details

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aHeaderFields,
 Object aRequest,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

Parameters:

aHttpMethod - the http method

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

aHeaderFields - the Header-Fields

aRequest - the request

aRestClient - the rest client

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

Parameters:

aHttpMethod - the http method

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

aRestClient - the rest client

RestRequest

protected RestRequest(RestClient aRestClient)

Instantiates a new rest request builder impl.

Parameters:

aRestClient - the rest client

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 Object aRequest,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

Parameters:

aHttpMethod - the http method

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

aRequest - the request

aRestClient - the rest client

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 int aRedirectDepth,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

Parameters:

aHttpMethod - the http method

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

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.

aRestClient - the rest client

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 Object aRequest,
 int aRedirectDepth,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

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.

aRestClient - the rest client

RestRequest

protected RestRequest(HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aHeaderFields,
 Object aRequest,
 int aRedirectDepth,
 RestClient aRestClient)

Instantiates a new rest request builder impl.

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.

aRestClient - the rest client

Method Details

build

public RestRequest build(RestClient aRestClient)

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

Parameters:

aRestClient - the rest client

Returns:

an instance (using a public implementation) of this builder

getUrl

public UrlBuilder getUrl()

Specified by:

getUrl in interface UrlAccessor

Overrides:

getUrl in class AbstractHttpRequest

getHttpMethod

public HttpMethod getHttpMethod()

Specified by:

getHttpMethod in interface HttpMethodAccessor

Overrides:

getHttpMethod in class AbstractHttpRequest

toString

public String toString()

Overrides:

toString in class HttpClientRequest

setHeaderFields

public void setHeaderFields(RequestHeaderFields aHeaderFields)

Specified by:

setHeaderFields in interface HeaderFieldsAccessor.HeaderFieldsMutator<RequestHeaderFields>

toRestResponse

public RestResponse toRestResponse()
                            throws HttpResponseException

Sends the request and returns synchronously the according RestResponse.

Returns:

the rest response

Throws:

HttpResponseException - the http response exception