org.apache.jetspeed.request
Interface RequestContext

All Known Implementing Classes:

MockRequestContext

public interface RequestContext

Portal Request Context is associated with each request

Version:

$Id: RequestContext.java,v 1.14 2005/04/29 14:00:48 weaver Exp $

Author:

David Sean Taylor

Field Summary

static String

REQUEST_PORTALENV

Method Summary

org.apache.pluto.om.window.PortletWindow	getActionWindow() Get the target Action Window
Object	getAttribute(String key) Get a request attribute associated with this single request.
CapabilityMap	getCapabilityMap() Get the Capability Map
String	getCharacterEncoding() get the character encoding
javax.servlet.ServletConfig	getConfig() Gets the HTTP Servlet Config
ContentDispatcher	getContentDispatcher() Gets the content dispatcher for this request
Locale	getLocale() Gets the locale associated with this request.
String	getMediaType() get the Media Type
String	getMimeType() Get the mimeType for the request
Map	getObjects() Return a map of Jetspeed Request Context objects configured via Spring Map
ContentPage	getPage() Gets the target page for this request
Map	getParameterMap() Use this method to get a map of request parameters on the generalized request, decoupling request parameter manipulation from servlet API.
String	getPath() Returns any extra path information associated with the URL the client sent when it made this request.
Pipeline	getPipeline() Get the current executing pipeline
PortalURL	getPortalURL() Gets the Portal URL for the current request.
org.apache.pluto.om.common.Language	getPreferedLanguage(org.apache.pluto.om.portlet.PortletDefinition portlet) getPreferedLanguage
Map	getProfileLocators() Gets the profile locators for this request
javax.servlet.http.HttpServletRequest	getRequest() Gets the HTTP Servlet Request.
javax.servlet.http.HttpServletRequest	getRequestForWindow(org.apache.pluto.om.window.PortletWindow window) getRequestForWindow
String	getRequestParameter(String key) Use this method to get a request parameter on the generalized request, decoupling request parameter manipulation from servlet API.
javax.servlet.http.HttpServletResponse	getResponse() Gets the HTTP Servlet Response.
javax.servlet.http.HttpServletResponse	getResponseForWindow(org.apache.pluto.om.window.PortletWindow window) getResponseForWindow
Object	getSessionAttribute(String key) Gets an attribute from the session.
Subject	getSubject() Gets the subject associated with the authorized entity.
Map	getUserInfoMap(org.apache.pluto.om.common.ObjectID oid) Returns the user info map of user attributes for a given portlet application.
Principal	getUserPrincipal() Gets the Jetspeed primary user principal associated with the authorized entity.
ContentPage	locatePage(Profiler profiler, String nonProfiledPath) Locates a specific page using the profiler and site manager location algorithms from a generalized non-profiled path to the first page matching the path
Throwable	popActionFailure(org.apache.pluto.om.window.PortletWindow window)
void	setActionFailure(org.apache.pluto.om.window.PortletWindow window, Throwable actionFailure)
void	setActionWindow(org.apache.pluto.om.window.PortletWindow window) Sets the target Portlet Window
void	setAttribute(String key, Object value) Sets an attribute into the request.
void	setCapabilityMap(CapabilityMap map) Set the capabilityMap.
void	setCharacterEncoding(String enc) set character encoding
void	setContentDispatcher(ContentDispatcher dispatcher) Sets the content dispatcher for this request
void	setLocale(Locale locale) Sets the locale associated with this request.
void	setMediaType(String mediaType) Set the mediaType.
void	setMimeType(String mimeType) Set the Mimetype.
void	setPage(ContentPage page) Sets the target page for this request
void	setPath(String path) setPath
void	setPipeline(Pipeline pipeline) Set the current pipeline
void	setPortalURL(PortalURL portalUrl) Sets the Portal URL for the current request.
void	setProfileLocators(Map locators) Sets the target page profile locators for this request
void	setRequest(javax.servlet.http.HttpServletRequest request) Sets the HTTP Servlet Request.
void	setResponse(javax.servlet.http.HttpServletResponse response) Sets the HTTP Servlet Response.
void	setSessionAttribute(String key, Object value) Sets an attribute into the session.
void	setSubject(Subject subject) Sets the subject associated with the authorized entity.

Field Detail

REQUEST_PORTALENV

static final String REQUEST_PORTALENV

See Also:

Constant Field Values

Method Detail

getRequest

javax.servlet.http.HttpServletRequest getRequest()

Gets the HTTP Servlet Request. This is the Servlet containers raw request object. This request should be wrapped using getPortletRequestForWindow() before being processed by the portlet container.

Returns:

HttpServletRequest

setRequest

void setRequest(javax.servlet.http.HttpServletRequest request)

Sets the HTTP Servlet Request. This is the Servlet containers raw request object. This request should be wrapped using getPortletRequestForWindow() before being processed by the portlet container.

getResponse

javax.servlet.http.HttpServletResponse getResponse()

Gets the HTTP Servlet Response. This is the Servlet containers raw response object. This response should be wrapped using getPortletResponseForWindow() before being processed by the portlet container.

Returns:

HttpServletResponse

setResponse

void setResponse(javax.servlet.http.HttpServletResponse response)

Sets the HTTP Servlet Response. This is the Servlet containers raw response object. This response should be wrapped using getPortletResponseForWindow() before being processed by the portlet container.

getConfig

javax.servlet.ServletConfig getConfig()

Gets the HTTP Servlet Config

Returns:

ServletConfig

getProfileLocators

Map getProfileLocators()

Gets the profile locators for this request

Returns:

Profile locators by locator name

setProfileLocators

void setProfileLocators(Map locators)

Sets the target page profile locators for this request

Parameters:

locators - The target profile locators by locator name

getPage

ContentPage getPage()

Gets the target page for this request

Returns:

Page

setPage

void setPage(ContentPage page)

Sets the target page for this request

Parameters:

page - The target page

getContentDispatcher

ContentDispatcher getContentDispatcher()

Gets the content dispatcher for this request

Returns:

ContentDispatcher

setContentDispatcher

void setContentDispatcher(ContentDispatcher dispatcher)

Sets the content dispatcher for this request

Parameters:

dispatcher - The ContentDispatcher to use for this request

setCapabilityMap

void setCapabilityMap(CapabilityMap map)

Set the capabilityMap. Used by the CapabilityValve

Parameters:

capabilityMap -

getCapabilityMap

CapabilityMap getCapabilityMap()

Get the Capability Map

setMimeType

void setMimeType(String mimeType)

Set the Mimetype. Set by the CapabilityValve

Parameters:

mimeType -

getMimeType

String getMimeType()

Get the mimeType for the request

setMediaType

void setMediaType(String mediaType)

Set the mediaType. Set by the CapabilityValve

Parameters:

mediaType -

getMediaType

String getMediaType()

get the Media Type

getPortalURL

PortalURL getPortalURL()

Gets the Portal URL for the current request.

Returns:

The Portal URL object for the current request. This method will never return a null value.

Throws:

IllegalStateException - if portalUrl if has not been set.

setPortalURL

void setPortalURL(PortalURL portalUrl)

Sets the Portal URL for the current request.

Throws:

IllegalStateException - if portalUrl has been set already.

IllegalArgumentException - if a null value is passed in.

getActionWindow

org.apache.pluto.om.window.PortletWindow getActionWindow()

Get the target Action Window

Returns:

PortletWindow The target portlet action window

setActionWindow

void setActionWindow(org.apache.pluto.om.window.PortletWindow window)

Sets the target Portlet Window

Parameters:

window -

getCharacterEncoding

String getCharacterEncoding()

get the character encoding

setCharacterEncoding

void setCharacterEncoding(String enc)

set character encoding

Parameters:

enc -

getRequestForWindow

javax.servlet.http.HttpServletRequest getRequestForWindow(org.apache.pluto.om.window.PortletWindow window)

getRequestForWindow

Takes a PortletWindow and generates a HttpServletRequest that accurately represents that PortletWindow's request parameters

Parameters:

window - PortletWindow that we are build a request for

Returns:

HttpServletRequest that wraps the existing servlet container's request that can interpret encoded portlet information for this PortletWindow

getResponseForWindow

javax.servlet.http.HttpServletResponse getResponseForWindow(org.apache.pluto.om.window.PortletWindow window)

getResponseForWindow

Takes a PortletWindow and generates a HttpServletResponse that accurately represents that PortletWindow's request parameters.

Parameters:

window - PortletWindow that we are build a response for

Returns:

HttpServletRequest that wraps the existing servlet container's request that can interpret encoded portlet information for this PortletWindow

getSubject

Subject getSubject()

Gets the subject associated with the authorized entity. This subject can be used to provide credentials and principals.

Returns:

The JAAS subject on this request.

setSubject

void setSubject(Subject subject)

Sets the subject associated with the authorized entity. This subject can be used to provide credentials and principals.

Parameters:

subject - The JAAS subject on this request.

getLocale

Locale getLocale()

Gets the locale associated with this request.

Returns:

The locale associated with this request.

setLocale

void setLocale(Locale locale)

Sets the locale associated with this request.

Parameters:

The - locale associated with this request.

getRequestParameter

String getRequestParameter(String key)

Use this method to get a request parameter on the generalized request, decoupling request parameter manipulation from servlet API. This parameter could be on the Http Servlet request, in that case it simply passes through to the servlet request.

Parameters:

key - The parameter unique key

Returns:

The object associated with the uniqu

getParameterMap

Map getParameterMap()

Use this method to get a map of request parameters on the generalized request, decoupling request parameter manipulation from servlet API. The parameters returned could be on the Http Servlet request, in that case it simply passes through to the servlet request.

Returns:

getSessionAttribute

Object getSessionAttribute(String key)

Gets an attribute from the session. This method is decoupled from the servlet api request to facilitate abstractions for testing and other programs not connected to a servlet application.

Parameters:

key - The key of the attribute

Returns:

The value of the attribute

setSessionAttribute

void setSessionAttribute(String key,
                         Object value)

Sets an attribute into the session. This method is decoupled from the servlet api request to facilitate abstractions for testing and other programs not connected to a servlet application.

Parameters:

key - The key of the session attribute

value - The value of the session attribute

getAttribute

Object getAttribute(String key)

Get a request attribute associated with this single request.

Parameters:

key - The key of the request attribute

Returns:

The value of the request attribute

setAttribute

void setAttribute(String key,
                  Object value)

Sets an attribute into the request. This method is decoupled from the servlet api request to facilitate abstractions for testing and other programs not connected to a servlet application.

Parameters:

key - The key of the request attribute

value - The value of the request attribute

getPath

String getPath()

Returns any extra path information associated with the URL the client sent when it made this request. The extra path information follows the servlet path but precedes the query string. This method returns null if there was no extra path information.

This method should function identically to HttpServletRequest.getPathInfo() except for that it removes ALL portal/portlet navigational state information from the path info string.

Returns:

the path

setPath

void setPath(String path)

setPath

Allows the manual overriding of path Jetspeed 2 will look to resolves pages and folders.

Parameters:

path -

getUserInfoMap

Map getUserInfoMap(org.apache.pluto.om.common.ObjectID oid)

Returns the user info map of user attributes for a given portlet application.

Parameters:

oid - The portlet application object id.

Returns:

The PortletRequest.USER_INFO map.

getPreferedLanguage

org.apache.pluto.om.common.Language getPreferedLanguage(org.apache.pluto.om.portlet.PortletDefinition portlet)

getPreferedLanguage

Returns the Language object for the portlet which most closely matches the prefences of the currently requesting client.

Parameters:

portlet -

Returns:

Language that matches, as closely as possible, that of the requesting client.

popActionFailure

Throwable popActionFailure(org.apache.pluto.om.window.PortletWindow window)

Returns:

setActionFailure

void setActionFailure(org.apache.pluto.om.window.PortletWindow window,
                      Throwable actionFailure)

Parameters:

actionFailed - The actionFailed to set.

getPipeline

Pipeline getPipeline()

Get the current executing pipeline

Returns:

Pipeline

setPipeline

void setPipeline(Pipeline pipeline)

Set the current pipeline

Parameters:

pipeline -

getUserPrincipal

Principal getUserPrincipal()

Gets the Jetspeed primary user principal associated with the authorized entity.

Returns:

The primary principal on this request.

locatePage

ContentPage locatePage(Profiler profiler,
                       String nonProfiledPath)

Locates a specific page using the profiler and site manager location algorithms from a generalized non-profiled path to the first page matching the path

Parameters:

profiler - The profiler component to use in the search

Returns:

A Content Page located by the profiler, or null if not found

getObjects

Map getObjects()

Return a map of Jetspeed Request Context objects configured via Spring Map

Returns:

a Map of request context objects

Since:

2.1.2