com.sun.jersey.spi.container
Class ContainerRequest

java.lang.Object  extended by com.sun.jersey.spi.container.ContainerRequest
All Implemented Interfaces:
HttpRequestContext, Traceable, HttpHeaders, Request, SecurityContext
Direct Known Subclasses:
AdaptingContainerRequest

public class ContainerRequest
extends java.lang.Object
implements HttpRequestContext

An in-bound HTTP request to be processed by the web application.

Containers instantiate, or inherit, and provide an instance to the WebApplication.

By default the implementation of SecurityContext will throw UnsupportedOperationException if the methods are invoked. Containers SHOULD use the method setSecurityContext(javax.ws.rs.core.SecurityContext) to define security context behaviour rather than extending from this class and overriding the methods.

Author:
Paul.Sandoz@Sun.Com, pavel.bucek@oracle.com


Field Summary
static java.lang.StringVARY_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
ContainerRequest(WebApplication wa, java.lang.String method, java.net.URI baseUri, java.net.URI requestUri, InBoundHeaders headers, java.io.InputStream entity)
          Create a new container request.
 
Method Summary
 Response.ResponseBuilderevaluatePreconditions()
           
 Response.ResponseBuilderevaluatePreconditions(java.util.Date lastModified)
           
 Response.ResponseBuilderevaluatePreconditions(java.util.Date lastModified, EntityTag eTag)
           
 Response.ResponseBuilderevaluatePreconditions(EntityTag eTag)
           
 java.net.URIgetAbsolutePath()
          Get the absolute path of the request.
 UriBuildergetAbsolutePathBuilder()
          Get the absolute path of the request in the form of a UriBuilder.
 java.util.List<java.util.Locale>getAcceptableLanguages()
           
 MediaTypegetAcceptableMediaType(java.util.List<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<MediaType>getAcceptableMediaTypes()
           
 java.util.List<MediaType>getAcceptableMediaTypes(java.util.List<QualitySourceMediaType> priorityMediaTypes)
          Get a list of media types that are acceptable for the response.
 java.lang.StringgetAuthenticationScheme()
           
 java.net.URIgetBaseUri()
          Get the base URI of the application.
 UriBuildergetBaseUriBuilder()
          Get the base URI of the application in the form of a UriBuilder.
 MultivaluedMap<java.lang.String,java.lang.String>getCookieNameValueMap()
          Get the cookie name value map.
 java.util.Map<java.lang.String,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.InputStreamgetEntityInputStream()
          Get the input stream of the entity.
 FormgetFormParameters()
          Get the form parameters of the request entity.
 java.lang.StringgetHeaderValue(java.lang.String name)
          Get a HTTP header value.
 java.util.LocalegetLanguage()
           
 MediaTypegetMediaType()
           
 MessageBodyWorkersgetMessageBodyWorkers()
          Get the message body workers.
 java.lang.StringgetMethod()
           
 java.lang.StringgetPath()
          Get the path of the current request relative to the base URI as a string.
 java.lang.StringgetPath(boolean decode)
          Get the path of the current request relative to the base URI as a string.
 java.util.List<PathSegment>getPathSegments()
          Get the path of the current request relative to the base URI as a list of PathSegment.
 java.util.List<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.
 MultivaluedMap<java.lang.String,java.lang.String>getQueryParameters()
          Get the URI query parameters of the current request.
 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)
           
 MultivaluedMap<java.lang.String,java.lang.String>getRequestHeaders()
           
 java.net.URIgetRequestUri()
          Get the absolute request URI.
 UriBuildergetRequestUriBuilder()
          Get the absolute request URI in the form of a UriBuilder.
 SecurityContextgetSecurityContext()
          Get the security context.
 java.security.PrincipalgetUserPrincipal()
           
 booleanisSecure()
           
 booleanisTracingEnabled()
          Check if tracing is enabled.
 booleanisUserInRole(java.lang.String role)
           
 VariantselectVariant(java.util.List<Variant> variants)
           
<T> void
setEntity(java.lang.Class<T> type, java.lang.reflect.Type genericType, java.lang.annotation.Annotation[] annotations, MediaType mediaType, MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders, T entity)
          Set the request entity.
 voidsetEntityInputStream(java.io.InputStream entity)
          Set the input stream of the entity.
 voidsetHeaders(InBoundHeaders headers)
          Set the request headers.
 voidsetMethod(java.lang.String method)
          Set the HTTP method.
 voidsetSecurityContext(SecurityContext securityContext)
          Set the security context.
 voidsetUris(java.net.URI baseUri, java.net.URI requestUri)
          Set the base and request URI.
 voidtrace(java.lang.String message)
          Add a trace message.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

VARY_HEADER

public static final java.lang.String VARY_HEADER
See Also:
Constant Field Values
Constructor Detail

ContainerRequest

public ContainerRequest(WebApplication wa,                        java.lang.String method,                        java.net.URI baseUri,                        java.net.URI requestUri,                        InBoundHeaders headers,                        java.io.InputStream entity)
Create a new container request.

The base URI and the request URI must contain the same scheme, user info, host and port components.

The base URI must not contain the query and fragment components. The encoded path component of the request URI must start with the encoded path component of the base URI. The encoded path component of the base URI must end in a '/' character.

Parameters:
wa - the web application
method - the HTTP method
baseUri - the base URI of the request
requestUri - the request URI
headers - the request headers
entity - the InputStream of the request entity

Method Detail

getProperties

public java.util.Map<java.lang.String,java.lang.Object> getProperties()
Get the mutable properties.

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

Returns:
the properties.

setMethod

public void setMethod(java.lang.String method)
Set the HTTP method.

Parameters:
method - the method.

setUris

public void setUris(java.net.URI baseUri,                    java.net.URI requestUri)
Set the base and request URI.

Parameters:
baseUri - the base URI.
requestUri - the (complete) request URI.

getEntityInputStream

public java.io.InputStream getEntityInputStream()
Get the input stream of the entity.

Returns:
the input stream of the entity.

setEntityInputStream

public void setEntityInputStream(java.io.InputStream entity)
Set the input stream of the entity.

Parameters:
entity - the input stream of the entity.

setHeaders

public void setHeaders(InBoundHeaders headers)
Set the request headers.

Parameters:
headers - the request headers.

setSecurityContext

public void setSecurityContext(SecurityContext securityContext)
Set the security context.

Parameters:
securityContext - the security context.

getSecurityContext

public SecurityContext getSecurityContext()
Get the security context.

Returns:
the security context.

getMessageBodyWorkers

public MessageBodyWorkers getMessageBodyWorkers()
Get the message body workers.

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
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
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
Returns:
the base URI of the application

getBaseUriBuilder

public 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
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
Returns:
the absolute request URI

getRequestUriBuilder

public UriBuilder getRequestUriBuilder()
Description copied from interface: HttpRequestContext
Get the absolute request URI in the form of a UriBuilder.

Specified by:
getRequestUriBuilder in interface HttpRequestContext
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
Returns:
the absolute path of the request

getAbsolutePathBuilder

public 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
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
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
Parameters:
decode - controls whether sequences of escaped octets are decoded (true) or not (false).
Returns:
the relative URI path

getPathSegments

public java.util.List<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
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<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
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 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
Returns:
an unmodifiable map of query parameter names and values

getQueryParameters

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

getEntity

public <T> T getEntity(java.lang.Class<T> type,                       java.lang.reflect.Type genericType,                       java.lang.annotation.Annotation[] as)
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
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

setEntity

public <T> void setEntity(java.lang.Class<T> type,                          java.lang.reflect.Type genericType,                          java.lang.annotation.Annotation[] annotations,                          MediaType mediaType,                          MultivaluedMap<java.lang.String,java.lang.Object> httpHeaders,                          T entity)
Set the request entity.

Parameters:
type - the class of object that is to be written.
genericType - the type of object to be written, obtained either by reflection of a resource method return type or by inspection of the returned instance. GenericEntity provides a way to specify this information at runtime.
annotations - an array of the annotations on the resource method that returns the object.
mediaType - the media type of the HTTP entity.
httpHeaders - a mutable map of the HTTP response headers.
entity - the entity instance to write.
Throws:
MappableContainerException - encapsulates exceptions thrown while serializing the entity.

getEntity

public <T> T getEntity(java.lang.Class<T> type)
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
Parameters:
type - the type of entity
Returns:
the request entity or null

getAcceptableMediaType

public MediaType getAcceptableMediaType(java.util.List<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
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<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
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 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
Returns:
the cookie name value map.

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

getRequestHeaders

public MultivaluedMap<java.lang.String,java.lang.String> getRequestHeaders()
Specified by:
getRequestHeaders in interface HttpHeaders

getRequestHeader

public java.util.List<java.lang.String> getRequestHeader(java.lang.String name)
Specified by:
getRequestHeader in interface HttpHeaders

getAcceptableMediaTypes

public java.util.List<MediaType> getAcceptableMediaTypes()
Specified by:
getAcceptableMediaTypes in interface HttpHeaders

getAcceptableLanguages

public java.util.List<java.util.Locale> getAcceptableLanguages()
Specified by:
getAcceptableLanguages in interface HttpHeaders

getMediaType

public MediaType getMediaType()
Specified by:
getMediaType in interface HttpHeaders

getLanguage

public java.util.Locale getLanguage()
Specified by:
getLanguage in interface HttpHeaders

getCookies

public java.util.Map<java.lang.String,Cookie> getCookies()
Specified by:
getCookies in interface HttpHeaders

getMethod

public java.lang.String getMethod()
Specified by:
getMethod in interface Request

selectVariant

public Variant selectVariant(java.util.List<Variant> variants)
Specified by:
selectVariant in interface Request

evaluatePreconditions

public Response.ResponseBuilder evaluatePreconditions()
Specified by:
evaluatePreconditions in interface Request

evaluatePreconditions

public Response.ResponseBuilder evaluatePreconditions(EntityTag eTag)
Specified by:
evaluatePreconditions in interface Request

evaluatePreconditions

public Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified)
Specified by:
evaluatePreconditions in interface Request

evaluatePreconditions

public Response.ResponseBuilder evaluatePreconditions(java.util.Date lastModified,                                                      EntityTag eTag)
Specified by:
evaluatePreconditions in interface Request

getUserPrincipal

public java.security.Principal getUserPrincipal()
Specified by:
getUserPrincipal in interface SecurityContext

isUserInRole

public boolean isUserInRole(java.lang.String role)
Specified by:
isUserInRole in interface SecurityContext

isSecure

public boolean isSecure()
Specified by:
isSecure in interface SecurityContext

getAuthenticationScheme

public java.lang.String getAuthenticationScheme()
Specified by:
getAuthenticationScheme in interface SecurityContext


Copyright © 2013
Oracle Corporation. All Rights Reserved.


NOTHING
NOTHING
Add the Maven Dependecy to your project: maven dependecy for com.amazonaws : aws-java-sdk : 1.3.14