Module org.refcodes.web

Package org.refcodes.web

Class HttpServerRequest

java.lang.Object

org.refcodes.web.AbstractHttpRequest

org.refcodes.web.HttpServerRequest

All Implemented Interfaces:

HeaderFieldsAccessor<RequestHeaderFields>, HttpBodyAccessor, HttpInputStreamAccessor, HttpMethodAccessor, HttpRequest, UrlAccessor

public class HttpServerRequest
extends AbstractHttpRequest
implements HttpBodyAccessor, HttpInputStreamAccessor

Defines a HttpServerRequest being the request as consumed by the server.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.web.HeaderFieldsAccessor

HeaderFieldsAccessor.HeaderFieldsBuilder<T extends HeaderFields<?,?>,B extends HeaderFieldsAccessor.HeaderFieldsBuilder<T,B>>, HeaderFieldsAccessor.HeaderFieldsMutator<T extends HeaderFields<?,?>>, HeaderFieldsAccessor.HeaderFieldsProperty<T extends HeaderFields<?,?>>

Nested classes/interfaces inherited from interface org.refcodes.web.HttpBodyAccessor

HttpBodyAccessor.HttpBodyBuilder<B extends HttpBodyAccessor.HttpBodyBuilder<B>>, HttpBodyAccessor.HttpBodyMutator, HttpBodyAccessor.HttpBodyProperty, HttpBodyAccessor.HttpBodyProvider<EXC extends Exception>

Nested classes/interfaces inherited from interface org.refcodes.web.HttpInputStreamAccessor

HttpInputStreamAccessor.HttpInputStreamBuilder<B extends HttpInputStreamAccessor.HttpInputStreamBuilder<B>>, HttpInputStreamAccessor.HttpInputStreamMutator, HttpInputStreamAccessor.HttpInputStreamProperty, HttpInputStreamAccessor.HttpInputStreamProvider<EXC extends Exception>

Nested classes/interfaces inherited from interface org.refcodes.web.HttpMethodAccessor

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

Nested classes/interfaces inherited from interface org.refcodes.web.UrlAccessor

UrlAccessor.UrlBuilder, UrlAccessor.UrlMutator, UrlAccessor.UrlProperty

Field Summary

Fields

Modifier and Type	Field	Description
protected MediaTypeFactoryLookup	_mediaTypeFactoryLookup

Fields inherited from class org.refcodes.web.AbstractHttpRequest

_headerFields, _httpMethod, _url

Constructor Summary

Constructors

Constructor	Description
HttpServerRequest(HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aHeaderFields, InputStream aHttpInputStream, MediaTypeFactoryLookup aMediaTypeFactoryLookup)	Constructs a HttpServerRequest with all required attributes.

Method Summary

Modifier and Type	Method	Description
String	getHttpBody()	Retrieves the HTTP body from the HTTP body property.
InputStream	getHttpInputStream()	Retrieves the InputStream from the HTTP InputStream property.
HttpBodyMap	getRequest()	Retrieves the HttpBodyMap representing the request body.
<REQ> REQ	getRequest(Class<REQ> aRequestType)	This method's implementation supports the HttpBodyMap to unmarshal an HTTP Request-Body into an HttpBodyMap when providing the HttpBodyMap as request type.
String	toString()

Methods inherited from class org.refcodes.web.AbstractHttpRequest

getHeaderFields, getHttpMethod, getUrl

Methods inherited from class java.lang.Object

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

Field Details

_mediaTypeFactoryLookup

protected MediaTypeFactoryLookup _mediaTypeFactoryLookup

Constructor Details

HttpServerRequest

public HttpServerRequest(HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aHeaderFields,
 InputStream aHttpInputStream,
 MediaTypeFactoryLookup aMediaTypeFactoryLookup)

Constructs a HttpServerRequest with all required attributes.

Parameters:

aHttpMethod - The HttpMethod with which the request has been sent.

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

aHeaderFields - The RequestHeaderFields sent by the request.

aHttpInputStream - The InputStream representing the request's HTTP body.

aMediaTypeFactoryLookup - The lookup factory for retrieving the required MediaType factories.

Method Details

getRequest

public HttpBodyMap getRequest()
                       throws BadRequestException

Retrieves the HttpBodyMap representing the request body.

Returns:

An instance of the HttpBodyMap representing the request.

Throws:

BadRequestException - thrown when unmarshaling / deserializing an object fails.

getRequest

public <REQ> REQ getRequest(Class<REQ> aRequestType)
                     throws BadRequestException

This method's implementation supports the HttpBodyMap to unmarshal an HTTP Request-Body into an HttpBodyMap when providing the HttpBodyMap as request type.

Type Parameters:

REQ - the generic type

Parameters:

aRequestType - the request type

Returns:

the request

Throws:

BadRequestException - the bad request exception

getHttpInputStream

public InputStream getHttpInputStream()

Retrieves the InputStream from the HTTP InputStream property.

Specified by:

getHttpInputStream in interface HttpInputStreamAccessor

Returns:

The InputStream stored by the InputStream property.

getHttpBody

public String getHttpBody()

Retrieves the HTTP body from the HTTP body property.

Specified by:

getHttpBody in interface HttpBodyAccessor

Returns:

The HTTP body stored by the HTTP body property.

toString

public String toString()

Overrides:

toString in class Object