com.sun.jersey.server.impl.application

Class WebApplicationContext

java.lang.Object

com.sun.jersey.server.impl.application.WebApplicationContext

All Implemented Interfaces:

ExtendedUriInfo, HttpContext, Traceable, UriMatchResultContext, UriRuleContext, javax.ws.rs.core.UriInfo

public final class WebApplicationContext
extends Object
implements UriRuleContext, ExtendedUriInfo

Author:

Paul.Sandoz@Sun.Com

Field Summary

Fields

Modifier and Type	Field and Description
static String	HTTP_METHOD_MATCH_RESOURCE

Constructor Summary

Constructors

Constructor and Description
WebApplicationContext(WebApplicationImpl app, ContainerRequest request, ContainerResponse response)

Method Summary

Modifier and Type	Method and Description
WebApplicationContext	createMatchResourceContext(URI u)
URI	getAbsolutePath()
javax.ws.rs.core.UriBuilder	getAbsolutePathBuilder()
URI	getBaseUri()
javax.ws.rs.core.UriBuilder	getBaseUriBuilder()
ContainerRequest	getContainerRequest() Get the container request.
ContainerResponse	getContainerResponse() Get the container response.
Throwable	getMappedThrowable() Get the throwable that was mapped to a response.
AbstractResourceMethod	getMatchedMethod() Get get matched resource method that was invoked.
List<Object>	getMatchedResources()
List<MatchResult>	getMatchedResults() Get a read-only list of MatchResult for matched resources.
List<UriTemplate>	getMatchedTemplates() Get a read-only list of UriTemplate for matched resources.
List<String>	getMatchedURIs()
List<String>	getMatchedURIs(boolean decode)
MatchResult	getMatchResult() Get the match result
String	getPath()
String	getPath(boolean decode)
javax.ws.rs.core.MultivaluedMap<String,String>	getPathParameters()
javax.ws.rs.core.MultivaluedMap<String,String>	getPathParameters(boolean decode)
List<javax.ws.rs.core.PathSegment>	getPathSegments()
List<javax.ws.rs.core.PathSegment>	getPathSegments(boolean decode)
List<javax.ws.rs.core.PathSegment>	getPathSegments(String name) Get the path segments that contains a template variable.
List<javax.ws.rs.core.PathSegment>	getPathSegments(String name, boolean decode) Get the path segments that contains a template variable.
Map<String,Object>	getProperties() Get the mutable properties.
javax.ws.rs.core.MultivaluedMap<String,String>	getQueryParameters()
javax.ws.rs.core.MultivaluedMap<String,String>	getQueryParameters(boolean decode)
HttpRequestContext	getRequest() Get the HTTP request information.
URI	getRequestUri()
javax.ws.rs.core.UriBuilder	getRequestUriBuilder()
Object	getResource(Class resourceClass) Get the resource instance from a resource class.
HttpResponseContext	getResponse() Get the HTTP response information.
List<ContainerResponseFilter>	getResponseFilters()
UriRules<UriRule>	getRules(Class resourceClass) Get the rules for a resource class.
ExtendedUriInfo	getUriInfo() Get the extended URI information.
boolean	isTracingEnabled() Check if tracing is enabled.
void	pushContainerResponseFilters(List<ContainerResponseFilter> filters) Push a list of container response filters to apply after the container response has been produced.
void	pushMatch(UriTemplate template, List<String> names) Push a match.
void	pushMethod(AbstractResourceMethod arm) Push the matching resource method.
void	pushResource(Object resource) Push a matching resource.
void	pushRightHandPathLength(int rhpathlen) Push the right hand path length to calculate the entry for the list of matching (ancestor) URI paths.
void	setContainerRequest(ContainerRequest request) Set the container request.
void	setContainerResponse(ContainerResponse response) Set the container response.
void	setMatchResult(MatchResult matchResult) Set the match result
void	trace(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

HTTP_METHOD_MATCH_RESOURCE

public static final String HTTP_METHOD_MATCH_RESOURCE

See Also:

Constant Field Values

Constructor Detail

WebApplicationContext

public WebApplicationContext(WebApplicationImpl app,
                             ContainerRequest request,
                             ContainerResponse response)

Method Detail

createMatchResourceContext

public WebApplicationContext createMatchResourceContext(URI u)

getResponseFilters

public List<ContainerResponseFilter> getResponseFilters()

getRequest

public HttpRequestContext getRequest()

Description copied from interface: HttpContext

Get the HTTP request information.

Specified by:

getRequest in interface HttpContext

Returns:

the HTTP request information

getResponse

public HttpResponseContext getResponse()

Description copied from interface: HttpContext

Get the HTTP response information.

Specified by:

getResponse in interface HttpContext

Returns:

the HTTP response information

getUriInfo

public ExtendedUriInfo getUriInfo()

Description copied from interface: HttpContext

Get the extended URI information.

Specified by:

getUriInfo in interface HttpContext

Returns:

the extended URI information.

getProperties

public Map<String,Object> getProperties()

Description copied from interface: HttpContext

Get the mutable properties.

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

Specified by:

getProperties in interface HttpContext

Returns:

the properties.

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

getMatchResult

public MatchResult getMatchResult()

Description copied from interface: UriMatchResultContext

Get the match result

Specified by:

getMatchResult in interface UriMatchResultContext

Returns:

the match result.

setMatchResult

public void setMatchResult(MatchResult matchResult)

Description copied from interface: UriMatchResultContext

Set the match result

Specified by:

setMatchResult in interface UriMatchResultContext

Parameters:

matchResult - the match result.

getContainerRequest

public ContainerRequest getContainerRequest()

Description copied from interface: UriRuleContext

Get the container request.

Specified by:

getContainerRequest in interface UriRuleContext

Returns:

the container request.

setContainerRequest

public void setContainerRequest(ContainerRequest request)

Description copied from interface: UriRuleContext

Set the container request.

Specified by:

setContainerRequest in interface UriRuleContext

Parameters:

request - the container request.

getContainerResponse

public ContainerResponse getContainerResponse()

Description copied from interface: UriRuleContext

Get the container response.

Specified by:

getContainerResponse in interface UriRuleContext

Returns:

the container response.

setContainerResponse

public void setContainerResponse(ContainerResponse response)

Description copied from interface: UriRuleContext

Set the container response.

Specified by:

setContainerResponse in interface UriRuleContext

Parameters:

response - the container response.

pushContainerResponseFilters

public void pushContainerResponseFilters(List<ContainerResponseFilter> filters)

Description copied from interface: UriRuleContext

Push a list of container response filters to apply after the container response has been produced.

The list of response filters is processed in reverse order of last to first.

Specified by:

pushContainerResponseFilters in interface UriRuleContext

Parameters:

filters - the list container response filters

getResource

public Object getResource(Class resourceClass)

Description copied from interface: UriRuleContext

Get the resource instance from a resource class.

Specified by:

getResource in interface UriRuleContext

Parameters:

resourceClass - the resource class

Returns:

the resource instance

getRules

public UriRules<UriRule> getRules(Class resourceClass)

Description copied from interface: UriRuleContext

Get the rules for a resource class.

Specified by:

getRules in interface UriRuleContext

Parameters:

resourceClass - the resource class that has rules

Returns:

the rules

pushMatch

public void pushMatch(UriTemplate template,
                      List<String> names)

Description copied from interface: UriRuleContext

Push a match.

Specified by:

pushMatch in interface UriRuleContext

Parameters:

template - the matching URI template.

names - the parameter names associated with the capturing group values.

pushResource

public void pushResource(Object resource)

Description copied from interface: UriRuleContext

Push a matching resource.

Specified by:

pushResource in interface UriRuleContext

Parameters:

resource - the matching resource

pushMethod

public void pushMethod(AbstractResourceMethod arm)

Description copied from interface: UriRuleContext

Push the matching resource method.

Specified by:

pushMethod in interface UriRuleContext

Parameters:

arm - the matching resource method.

pushRightHandPathLength

public void pushRightHandPathLength(int rhpathlen)

Description copied from interface: UriRuleContext

Push the right hand path length to calculate the entry for the list of matching (ancestor) URI paths.

Specified by:

pushRightHandPathLength in interface UriRuleContext

Parameters:

rhpathlen - the right hand length

getBaseUri

public URI getBaseUri()

Specified by:

getBaseUri in interface javax.ws.rs.core.UriInfo

getBaseUriBuilder

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

Specified by:

getBaseUriBuilder in interface javax.ws.rs.core.UriInfo

getAbsolutePath

public URI getAbsolutePath()

Specified by:

getAbsolutePath in interface javax.ws.rs.core.UriInfo

getAbsolutePathBuilder

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

Specified by:

getAbsolutePathBuilder in interface javax.ws.rs.core.UriInfo

getRequestUri

public URI getRequestUri()

Specified by:

getRequestUri in interface javax.ws.rs.core.UriInfo

getRequestUriBuilder

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

Specified by:

getRequestUriBuilder in interface javax.ws.rs.core.UriInfo

getPath

public String getPath()

Specified by:

getPath in interface javax.ws.rs.core.UriInfo

getPath

public String getPath(boolean decode)

Specified by:

getPath in interface javax.ws.rs.core.UriInfo

getPathSegments

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

Specified by:

getPathSegments in interface javax.ws.rs.core.UriInfo

getPathSegments

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

Specified by:

getPathSegments in interface javax.ws.rs.core.UriInfo

getQueryParameters

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

Specified by:

getQueryParameters in interface javax.ws.rs.core.UriInfo

getQueryParameters

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

Specified by:

getQueryParameters in interface javax.ws.rs.core.UriInfo

getPathParameters

public javax.ws.rs.core.MultivaluedMap<String,String> getPathParameters()

Specified by:

getPathParameters in interface javax.ws.rs.core.UriInfo

getPathParameters

public javax.ws.rs.core.MultivaluedMap<String,String> getPathParameters(boolean decode)

Specified by:

getPathParameters in interface javax.ws.rs.core.UriInfo

getMatchedURIs

public List<String> getMatchedURIs()

Specified by:

getMatchedURIs in interface javax.ws.rs.core.UriInfo

getMatchedURIs

public List<String> getMatchedURIs(boolean decode)

Specified by:

getMatchedURIs in interface javax.ws.rs.core.UriInfo

getMatchedResources

public List<Object> getMatchedResources()

Specified by:

getMatchedResources in interface javax.ws.rs.core.UriInfo

getMatchedMethod

public AbstractResourceMethod getMatchedMethod()

Description copied from interface: ExtendedUriInfo

Get get matched resource method that was invoked.

Specified by:

getMatchedMethod in interface ExtendedUriInfo

Returns:

the matched resource method, otherwise null if no resource method was invoked.

getMappedThrowable

public Throwable getMappedThrowable()

Description copied from interface: ExtendedUriInfo

Get the throwable that was mapped to a response.

A response filter or a message body writer may utilize this method to determine if a resource method was invoked but did not return a response because an exception was thrown from the resource method, or the resource method returned but a response filter threw an exception.

Specified by:

getMappedThrowable in interface ExtendedUriInfo

Returns:

the throwable that was mapped to a response, otherwise null if no throwable was mapped to a response.

See Also:

ContainerResponse.getMappedThrowable()

getMatchedResults

public List<MatchResult> getMatchedResults()

Description copied from interface: ExtendedUriInfo

Get a read-only list of MatchResult for matched resources. Entries are ordered in reverse request URI matching order, with the root resource match result last.

Specified by:

getMatchedResults in interface ExtendedUriInfo

Returns:

a read-only list of match results for matched resources.

getMatchedTemplates

public List<UriTemplate> getMatchedTemplates()

Description copied from interface: ExtendedUriInfo

Get a read-only list of UriTemplate for matched resources. Each entry is a URI template that is the value of the Path that is a partial path that matched a resource class, a sub-resource method or a sub-resource locator. Entries are ordered in reverse request URI matching order, with the root resource URI template last.

Specified by:

getMatchedTemplates in interface ExtendedUriInfo

Returns:

a read-only list of URI templates for matched resources.

getPathSegments

public List<javax.ws.rs.core.PathSegment> getPathSegments(String name)

Description copied from interface: ExtendedUriInfo

Get the path segments that contains a template variable. All sequences of escaped octets are decoded, equivalent to getPathSegments(true).

Specified by:

getPathSegments in interface ExtendedUriInfo

Parameters:

name - the template variable name

Returns:

the path segments, the list will be empty the matching path does not contain the template

getPathSegments

public List<javax.ws.rs.core.PathSegment> getPathSegments(String name,
                                                          boolean decode)

Description copied from interface: ExtendedUriInfo

Get the path segments that contains a template variable.

Specified by:

getPathSegments in interface ExtendedUriInfo

Parameters:

name - the template variable name

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

Returns:

the path segments, the list will be empty the matching path does not contain the template