com.sun.jersey.spi.container

Class AdaptingContainerRequest

java.lang.Object

com.sun.jersey.spi.container.ContainerRequest

com.sun.jersey.spi.container.AdaptingContainerRequest

All Implemented Interfaces:

HttpRequestContext, Traceable, javax.ws.rs.core.HttpHeaders, javax.ws.rs.core.Request, javax.ws.rs.core.SecurityContext

Direct Known Subclasses:

CachedEntityContainerRequest

public class AdaptingContainerRequest
extends ContainerRequest

An adapting in-bound HTTP request that may override the behaviour of ContainerRequest.

Author:

Paul.Sandoz@Sun.Com

Field Summary

Fields

Modifier and Type	Field and Description
protected ContainerRequest	acr The adapted container request.

Fields inherited from class com.sun.jersey.spi.container.ContainerRequest

VARY_HEADER

Fields inherited from interface javax.ws.rs.core.HttpHeaders

ACCEPT, ACCEPT_CHARSET, ACCEPT_ENCODING, ACCEPT_LANGUAGE, AUTHORIZATION, CACHE_CONTROL, CONTENT_ENCODING, CONTENT_LANGUAGE, CONTENT_LENGTH, CONTENT_LOCATION, CONTENT_TYPE, COOKIE, DATE, ETAG, EXPIRES, HOST, IF_MATCH, IF_MODIFIED_SINCE, IF_NONE_MATCH, IF_UNMODIFIED_SINCE, LAST_MODIFIED, LOCATION, SET_COOKIE, USER_AGENT, VARY, WWW_AUTHENTICATE

Fields inherited from interface javax.ws.rs.core.SecurityContext

BASIC_AUTH, CLIENT_CERT_AUTH, DIGEST_AUTH, FORM_AUTH

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AdaptingContainerRequest(ContainerRequest acr) Create the adapting container request.

Method Summary

Methods

Modifier and Type	Method and Description
javax.ws.rs.core.Response.ResponseBuilder	evaluatePreconditions()
javax.ws.rs.core.Response.ResponseBuilder	evaluatePreconditions(java.util.Date lastModified)
javax.ws.rs.core.Response.ResponseBuilder	evaluatePreconditions(java.util.Date lastModified, javax.ws.rs.core.EntityTag eTag)
javax.ws.rs.core.Response.ResponseBuilder	evaluatePreconditions(javax.ws.rs.core.EntityTag eTag)
java.net.URI	getAbsolutePath() Get the absolute path of the request.
javax.ws.rs.core.UriBuilder	getAbsolutePathBuilder() Get the absolute path of the request in the form of a UriBuilder.
java.util.List<java.util.Locale>	getAcceptableLanguages()
javax.ws.rs.core.MediaType	getAcceptableMediaType(java.util.List<javax.ws.rs.core.MediaType> mediaTypes) Select the first media type, from a list of media types, that is most acceptable according to the requested acceptable media types.
java.util.List<javax.ws.rs.core.MediaType>	getAcceptableMediaTypes()
java.util.List<javax.ws.rs.core.MediaType>	getAcceptableMediaTypes(java.util.List<QualitySourceMediaType> priorityMediaTypes) Get a list of media types that are acceptable for the response.
java.lang.String	getAuthenticationScheme()
java.net.URI	getBaseUri() Get the base URI of the application.
javax.ws.rs.core.UriBuilder	getBaseUriBuilder() Get the base URI of the application in the form of a UriBuilder.
javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String>	getCookieNameValueMap() Get the cookie name value map.
java.util.Map<java.lang.String,javax.ws.rs.core.Cookie>	getCookies()
<T> T	getEntity(java.lang.Class<T> type) Get the request entity, returns null if the request does not contain an entity body.
<T> T	getEntity(java.lang.Class<T> type, java.lang.reflect.Type genericType, java.lang.annotation.Annotation[] as) Get the request entity, returns null if the request does not contain an entity body.
java.io.InputStream	getEntityInputStream() Get the input stream of the entity.
Form	getFormParameters() Get the form parameters of the request entity.
java.lang.String	getHeaderValue(java.lang.String name) Get a HTTP header value.
java.util.Locale	getLanguage()
javax.ws.rs.core.MediaType	getMediaType()
MessageBodyWorkers	getMessageBodyWorkers() Get the message body workers.
java.lang.String	getMethod()
java.lang.String	getPath() Get the path of the current request relative to the base URI as a string.
java.lang.String	getPath(boolean decode) Get the path of the current request relative to the base URI as a string.
java.util.List<javax.ws.rs.core.PathSegment>	getPathSegments() Get the path of the current request relative to the base URI as a list of PathSegment.
java.util.List<javax.ws.rs.core.PathSegment>	getPathSegments(boolean decode) Get the path of the current request relative to the base URI as a list of PathSegment.
java.util.Map<java.lang.String,java.lang.Object>	getProperties() Get the mutable properties.
javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String>	getQueryParameters() Get the URI query parameters of the current request.
javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String>	getQueryParameters(boolean decode) Get the URI query parameters of the current request.
java.util.List<java.lang.String>	getRequestHeader(java.lang.String name)
javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String>	getRequestHeaders()
java.net.URI	getRequestUri() Get the absolute request URI.
javax.ws.rs.core.UriBuilder	getRequestUriBuilder() Get the absolute request URI in the form of a UriBuilder.
javax.ws.rs.core.SecurityContext	getSecurityContext() Get the security context.
java.security.Principal	getUserPrincipal()
boolean	isSecure()
boolean	isTracingEnabled() Check if tracing is enabled.
boolean	isUserInRole(java.lang.String role)
javax.ws.rs.core.Variant	selectVariant(java.util.List<javax.ws.rs.core.Variant> variants)
void	setEntityInputStream(java.io.InputStream entity) Set the input stream of the entity.
void	setHeaders(InBoundHeaders headers) Set the request headers.
void	setMethod(java.lang.String method) Set the HTTP method.
void	setSecurityContext(javax.ws.rs.core.SecurityContext securityContext) Set the security context.
void	setUris(java.net.URI baseUri, java.net.URI requestUri) Set the base and request URI.
void	trace(java.lang.String message) Add a trace message.

Methods inherited from class com.sun.jersey.spi.container.ContainerRequest

setEntity

Methods inherited from class java.lang.Object

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

Field Detail

acr

protected final ContainerRequest acr

The adapted container request.

Constructor Detail

AdaptingContainerRequest

protected AdaptingContainerRequest(ContainerRequest acr)

Create the adapting container request.

Parameters:

acr - the container request to adapt.

Method Detail

getProperties

public java.util.Map<java.lang.String,java.lang.Object> getProperties()

Description copied from class: ContainerRequest

Get the mutable properties.

Care should be taken not to clear the properties or remove properties that are unknown otherwise unspecified behaviour may result.

Overrides:

getProperties in class ContainerRequest

Returns:

the properties.

setMethod

public void setMethod(java.lang.String method)

Description copied from class: ContainerRequest

Set the HTTP method.

Overrides:

setMethod in class ContainerRequest

Parameters:

method - the method.

setUris

public void setUris(java.net.URI baseUri,
           java.net.URI requestUri)

Description copied from class: ContainerRequest

Set the base and request URI.

Overrides:

setUris in class ContainerRequest

Parameters:

baseUri - the base URI.

requestUri - the (complete) request URI.

getEntityInputStream

public java.io.InputStream getEntityInputStream()

Description copied from class: ContainerRequest

Get the input stream of the entity.

Overrides:

getEntityInputStream in class ContainerRequest

Returns:

the input stream of the entity.

setEntityInputStream

public void setEntityInputStream(java.io.InputStream entity)

Description copied from class: ContainerRequest

Set the input stream of the entity.

Overrides:

setEntityInputStream in class ContainerRequest

Parameters:

entity - the input stream of the entity.

setHeaders

public void setHeaders(InBoundHeaders headers)

Description copied from class: ContainerRequest

Set the request headers.

Overrides:

setHeaders in class ContainerRequest

Parameters:

headers - the request headers.

setSecurityContext

public void setSecurityContext(javax.ws.rs.core.SecurityContext securityContext)

Description copied from class: ContainerRequest

Set the security context.

Overrides:

setSecurityContext in class ContainerRequest

Parameters:

securityContext - the security context.

getSecurityContext

public javax.ws.rs.core.SecurityContext getSecurityContext()

Description copied from class: ContainerRequest

Get the security context.

Overrides:

getSecurityContext in class ContainerRequest

Returns:

the security context.

getMessageBodyWorkers

public MessageBodyWorkers getMessageBodyWorkers()

Description copied from class: ContainerRequest

Get the message body workers.

Overrides:

getMessageBodyWorkers in class ContainerRequest

Returns:

the message body workers.

isTracingEnabled

public boolean isTracingEnabled()

Description copied from interface: Traceable

Check if tracing is enabled.

Specified by:

isTracingEnabled in interface Traceable

Overrides:

isTracingEnabled in class ContainerRequest

Returns:

true if tracing is enabled, otherwise false.

trace

public void trace(java.lang.String message)

Description copied from interface: Traceable

Add a trace message.

A trace message will be added if Traceable.isTracingEnabled() returns true and tracing contraints are satisfied.

Specified by:

trace in interface Traceable

Overrides:

trace in class ContainerRequest

Parameters:

message - the trace message to add.

getBaseUri

public java.net.URI getBaseUri()

Description copied from interface: HttpRequestContext

Get the base URI of the application. URIs of root resource classes are all relative to this base URI.

Specified by:

getBaseUri in interface HttpRequestContext

Overrides:

getBaseUri in class ContainerRequest

Returns:

the base URI of the application

getBaseUriBuilder

public javax.ws.rs.core.UriBuilder getBaseUriBuilder()

Description copied from interface: HttpRequestContext

Get the base URI of the application in the form of a UriBuilder.

Specified by:

getBaseUriBuilder in interface HttpRequestContext

Overrides:

getBaseUriBuilder in class ContainerRequest

Returns:

a UriBuilder initialized with the base URI of the application.

getRequestUri

public java.net.URI getRequestUri()

Description copied from interface: HttpRequestContext

Get the absolute request URI. This includes query parameters and any supplied fragment.

Specified by:

getRequestUri in interface HttpRequestContext

Overrides:

getRequestUri in class ContainerRequest

Returns:

the absolute request URI

getRequestUriBuilder

public javax.ws.rs.core.UriBuilder getRequestUriBuilder()

Description copied from interface: HttpRequestContext

Get the absolute request URI in the form of a UriBuilder.

Specified by:

getRequestUriBuilder in interface HttpRequestContext

Overrides:

getRequestUriBuilder in class ContainerRequest

Returns:

a UriBuilder initialized with the absolute request URI

getAbsolutePath

public java.net.URI getAbsolutePath()

Description copied from interface: HttpRequestContext

Get the absolute path of the request. This includes everything preceding the path (host, port etc) but excludes query parameters and fragment. This is a shortcut for uriInfo.getBase().resolve(uriInfo.getPath()).

Specified by:

getAbsolutePath in interface HttpRequestContext

Overrides:

getAbsolutePath in class ContainerRequest

Returns:

the absolute path of the request

getAbsolutePathBuilder

public javax.ws.rs.core.UriBuilder getAbsolutePathBuilder()

Description copied from interface: HttpRequestContext

Get the absolute path of the request in the form of a UriBuilder. This includes everything preceding the path (host, port etc) but excludes query parameters and fragment.

Specified by:

getAbsolutePathBuilder in interface HttpRequestContext

Overrides:

getAbsolutePathBuilder in class ContainerRequest

Returns:

a UriBuilder initialized with the absolute path of the request

getPath

public java.lang.String getPath()

Description copied from interface: HttpRequestContext

Get the path of the current request relative to the base URI as a string. All sequences of escaped octets are decoded, equivalent to getPath(true).

Specified by:

getPath in interface HttpRequestContext

Overrides:

getPath in class ContainerRequest

Returns:

the relative URI path

getPath

public java.lang.String getPath(boolean decode)

Description copied from interface: HttpRequestContext

Get the path of the current request relative to the base URI as a string.

Specified by:

getPath in interface HttpRequestContext

Overrides:

getPath in class ContainerRequest

Parameters:

decode - controls whether sequences of escaped octets are decoded (true) or not (false).

Returns:

the relative URI path

getPathSegments

public java.util.List<javax.ws.rs.core.PathSegment> getPathSegments()

Description copied from interface: HttpRequestContext

Get the path of the current request relative to the base URI as a list of PathSegment. This method is useful when the path needs to be parsed, particularly when matrix parameters may be present in the path. All sequences of escaped octets in path segments and matrix parameter names and values are decoded, equivalent to getPathSegments(true).

Specified by:

getPathSegments in interface HttpRequestContext

Overrides:

getPathSegments in class ContainerRequest

Returns:

an unmodifiable list of PathSegment. The matrix parameter map of each path segment is also unmodifiable.

See Also:

PathSegment, Matrix URIs

getPathSegments

public java.util.List<javax.ws.rs.core.PathSegment> getPathSegments(boolean decode)

Description copied from interface: HttpRequestContext

Get the path of the current request relative to the base URI as a list of PathSegment. This method is useful when the path needs to be parsed, particularly when matrix parameters may be present in the path.

Specified by:

getPathSegments in interface HttpRequestContext

Overrides:

getPathSegments in class ContainerRequest

Parameters:

decode - controls whether sequences of escaped octets in path segments and matrix parameter names and values are decoded (true) or not (false).

Returns:

an unmodifiable list of PathSegment. The matrix parameter map of each path segment is also unmodifiable.

See Also:

PathSegment, Matrix URIs

getQueryParameters

public javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String> getQueryParameters()

Description copied from interface: HttpRequestContext

Get the URI query parameters of the current request. All sequences of escaped octets in parameter names and values are decoded, equivalent to getQueryParameters(true).

Specified by:

getQueryParameters in interface HttpRequestContext

Overrides:

getQueryParameters in class ContainerRequest

Returns:

an unmodifiable map of query parameter names and values

getQueryParameters

public javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String> getQueryParameters(boolean decode)

Description copied from interface: HttpRequestContext

Get the URI query parameters of the current request.

Specified by:

getQueryParameters in interface HttpRequestContext

Overrides:

getQueryParameters in class ContainerRequest

Parameters:

decode - controls whether sequences of escaped octets in parameter names and values are decoded (true) or not (false).

Returns:

an unmodifiable map of query parameter names and values

getHeaderValue

public java.lang.String getHeaderValue(java.lang.String name)

Description copied from interface: HttpRequestContext

Get a HTTP header value.

Specified by:

getHeaderValue in interface HttpRequestContext

Overrides:

getHeaderValue in class ContainerRequest

Parameters:

name - the HTTP header

Returns:

the HTTP header value. If the HTTP header is not present then null is returned. If the HTTP header is present but has no value then the empty string is returned. If the HTTP header is present more than once then the values of joined together and separated by a ',' character.

getAcceptableMediaType

public javax.ws.rs.core.MediaType getAcceptableMediaType(java.util.List<javax.ws.rs.core.MediaType> mediaTypes)

Description copied from interface: HttpRequestContext

Select the first media type, from a list of media types, that is most acceptable according to the requested acceptable media types.

Specified by:

getAcceptableMediaType in interface HttpRequestContext

Overrides:

getAcceptableMediaType in class ContainerRequest

Parameters:

mediaTypes - the list of media types

Returns:

the most acceptable media type, or null if no media type was found to be acceptable.

getAcceptableMediaTypes

public java.util.List<javax.ws.rs.core.MediaType> getAcceptableMediaTypes(java.util.List<QualitySourceMediaType> priorityMediaTypes)

Description copied from interface: HttpRequestContext

Get a list of media types that are acceptable for the response.

Specified by:

getAcceptableMediaTypes in interface HttpRequestContext

Overrides:

getAcceptableMediaTypes in class ContainerRequest

Parameters:

priorityMediaTypes - the list of media types that take priority, ordered according to the quality source parameter, "qs" as the primary key.

Returns:

a list of requested response media types sorted according to highest relative quality value, which is product of the quality parameter, q, of an acceptable media type, and the quality source parameter, qs, of matching media type.

getCookieNameValueMap

public javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String> getCookieNameValueMap()

Description copied from interface: HttpRequestContext

Get the cookie name value map.

Specified by:

getCookieNameValueMap in interface HttpRequestContext

Overrides:

getCookieNameValueMap in class ContainerRequest

Returns:

the cookie name value map.

getEntity

public <T> T getEntity(java.lang.Class<T> type)
            throws javax.ws.rs.WebApplicationException

Description copied from interface: HttpRequestContext

Get the request entity, returns null if the request does not contain an entity body.

Specified by:

getEntity in interface HttpRequestContext

Overrides:

getEntity in class ContainerRequest

Parameters:

type - the type of entity

Returns:

the request entity or null

Throws:

javax.ws.rs.WebApplicationException - if the content of the request cannot be mapped to an entity of the requested type

getEntity

public <T> T getEntity(java.lang.Class<T> type,
              java.lang.reflect.Type genericType,
              java.lang.annotation.Annotation[] as)
            throws javax.ws.rs.WebApplicationException

Description copied from interface: HttpRequestContext

Get the request entity, returns null if the request does not contain an entity body.

Specified by:

getEntity in interface HttpRequestContext

Overrides:

getEntity in class ContainerRequest

Parameters:

type - the type of entity

genericType - type the generic type of entity, it is the responsibility of the callee to ensure that the type and generic type are consistent otherwise the behaviour of this method is undefined.

as - the annotations associated with the type

Returns:

the request entity or null

Throws:

javax.ws.rs.WebApplicationException - if the content of the request cannot be mapped to an entity of the requested type

getFormParameters

public Form getFormParameters()

Description copied from interface: HttpRequestContext

Get the form parameters of the request entity.

This method will ensure that the request entity is buffered such that it may be consumed by the application.

Specified by:

getFormParameters in interface HttpRequestContext

Overrides:

getFormParameters in class ContainerRequest

Returns:

the form parameters, if there is a request entity and the content type is "application/x-www-form-urlencoded", otherwise an instance containing no parameters will be returned.

getRequestHeader

public java.util.List<java.lang.String> getRequestHeader(java.lang.String name)

Specified by:

getRequestHeader in interface javax.ws.rs.core.HttpHeaders

Overrides:

getRequestHeader in class ContainerRequest

getRequestHeaders

public javax.ws.rs.core.MultivaluedMap<java.lang.String,java.lang.String> getRequestHeaders()

Specified by:

getRequestHeaders in interface javax.ws.rs.core.HttpHeaders

Overrides:

getRequestHeaders in class ContainerRequest

getAcceptableMediaTypes

public java.util.List<javax.ws.rs.core.MediaType> getAcceptableMediaTypes()

Specified by:

getAcceptableMediaTypes in interface javax.ws.rs.core.HttpHeaders

Overrides:

getAcceptableMediaTypes in class ContainerRequest

getAcceptableLanguages

public java.util.List<java.util.Locale> getAcceptableLanguages()

Specified by:

getAcceptableLanguages in interface javax.ws.rs.core.HttpHeaders

Overrides:

getAcceptableLanguages in class ContainerRequest

getMediaType

public javax.ws.rs.core.MediaType getMediaType()

Specified by:

getMediaType in interface javax.ws.rs.core.HttpHeaders

Overrides:

getMediaType in class ContainerRequest

getLanguage

public java.util.Locale getLanguage()

Specified by:

getLanguage in interface javax.ws.rs.core.HttpHeaders

Overrides:

getLanguage in class ContainerRequest

getCookies

public java.util.Map<java.lang.String,javax.ws.rs.core.Cookie> getCookies()

Specified by:

getCookies in interface javax.ws.rs.core.HttpHeaders

Overrides:

getCookies in class ContainerRequest

getMethod

public java.lang.String getMethod()

Specified by:

getMethod in interface javax.ws.rs.core.Request

Overrides:

getMethod in class ContainerRequest

selectVariant

public javax.ws.rs.core.Variant selectVariant(java.util.List<javax.ws.rs.core.Variant> variants)
                                       throws java.lang.IllegalArgumentException

Specified by:

selectVariant in interface javax.ws.rs.core.Request

Overrides:

selectVariant in class ContainerRequest

Throws:

java.lang.IllegalArgumentException

evaluatePreconditions

public javax.ws.rs.core.Response.ResponseBuilder evaluatePreconditions(javax.ws.rs.core.EntityTag eTag)

Specified by:

evaluatePreconditions in interface javax.ws.rs.core.Request

Overrides:

evaluatePreconditions in class ContainerRequest

evaluatePreconditions

public javax.ws.rs.core.Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified)

Specified by:

evaluatePreconditions in interface javax.ws.rs.core.Request

Overrides:

evaluatePreconditions in class ContainerRequest

evaluatePreconditions

public javax.ws.rs.core.Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified,
                                                              javax.ws.rs.core.EntityTag eTag)

Specified by:

evaluatePreconditions in interface javax.ws.rs.core.Request

Overrides:

evaluatePreconditions in class ContainerRequest

evaluatePreconditions

public javax.ws.rs.core.Response.ResponseBuilder evaluatePreconditions()

Specified by:

evaluatePreconditions in interface javax.ws.rs.core.Request

Overrides:

evaluatePreconditions in class ContainerRequest

getUserPrincipal

public java.security.Principal getUserPrincipal()

Specified by:

getUserPrincipal in interface javax.ws.rs.core.SecurityContext

Overrides:

getUserPrincipal in class ContainerRequest

isUserInRole

public boolean isUserInRole(java.lang.String role)

Specified by:

isUserInRole in interface javax.ws.rs.core.SecurityContext

Overrides:

isUserInRole in class ContainerRequest

isSecure

public boolean isSecure()

Specified by:

isSecure in interface javax.ws.rs.core.SecurityContext

Overrides:

isSecure in class ContainerRequest

getAuthenticationScheme

public java.lang.String getAuthenticationScheme()

Specified by:

getAuthenticationScheme in interface javax.ws.rs.core.SecurityContext

Overrides:

getAuthenticationScheme in class ContainerRequest