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 HeaderFieldsAccessor

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

Nested classes/interfaces inherited from interface HttpBodyAccessor

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

Nested classes/interfaces inherited from interface HttpInputStreamAccessor

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

Nested classes/interfaces inherited from interface HttpMethodAccessor

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

Nested classes/interfaces inherited from interface UrlAccessor

UrlAccessor.UrlBuilder, UrlAccessor.UrlMutator, UrlAccessor.UrlProperty

Field Summary

Fields

Modifier and Type	Field	Description
protected MediaTypeFactoryLookup	_mediaTypeFactoryLookup

Fields inherited from class 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 AbstractHttpRequest

getHeaderFields, getHttpMethod, getUrl

Methods inherited from class 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