|
|||||||||
| Home >> All >> com >> opencms >> [ file overview ] | PREV CLASS NEXT CLASS | ||||||||
SUMMARY: JAVADOC | SOURCE | DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||
com.opencms.file
Class CmsRequestContext

java.lang.Objectcom.opencms.file.CmsRequestContext
- All Implemented Interfaces:
- com.opencms.core.I_CmsConstants
- public class CmsRequestContext
- extends java.lang.Object
- implements com.opencms.core.I_CmsConstants
- extends java.lang.Object
This class provides access to the CmsRequestContext.
In the CmsRequestContext class are all methods bundled, which can inform about the
current request properties, like the url or uri of the request.
- Version:
- $Revision: 1.67 $ $Date: 2003/03/07 16:15:49 $
| Field Summary | |
private java.util.HashMap |
m_attributeMap
A map for storing (optional) request context attributes |
private CmsGroup |
m_currentGroup
The current group of the user |
private CmsProject |
m_currentProject
The current project |
private java.util.Vector |
m_dependencies
In export mode this vector is used to store all dependencies this request may have. |
private com.opencms.flex.util.CmsResourceTranslator |
m_directoryTranslator
Directroy name translator |
private com.opencms.template.cache.CmsElementCache |
m_elementCache
Starting point for element cache |
private java.lang.String |
m_encoding
Current encoding |
private boolean |
m_eventControlled
Flag to indicate that this request is event controlled |
private com.opencms.flex.util.CmsResourceTranslator |
m_fileTranslator
File name translator |
private java.util.Vector |
m_language
Current languages |
private java.util.Vector |
m_links
In export mode the links in pages will be stored in this vector for further processing. |
private I_CmsResourceBroker |
m_rb
The rb to get access to the OpenCms |
private com.opencms.core.I_CmsRequest |
m_req
The current CmsRequest |
private com.opencms.core.I_CmsResponse |
m_resp
The current CmsResponse |
private java.lang.String |
m_siteRoot
The name of the root, e.g. |
private boolean |
m_streaming
Flag to indicate if this response is streaming or not (legacy, not used by Element or Flex cache) |
private boolean |
m_updateSession
Flag to indicate that this context should not update the user session |
private java.lang.String |
m_uri
The URI for getUri() in case it is "overwritten" |
private CmsUser |
m_user
The current user |
| Constructor Summary | |
CmsRequestContext()
The default constructor. |
|
| Method Summary | |
void |
addDependency(java.lang.String rootName)
Adds a dependency. |
void |
addLink(java.lang.String link)
Adds a link for the static export. |
CmsFolder |
currentFolder()
Returns the current folder object. |
CmsGroup |
currentGroup()
Returns the current group of the current user. |
CmsProject |
currentProject()
Returns the current project of the current user. |
CmsUser |
currentUser()
Returns the current user object. |
java.util.Vector |
getAcceptedLanguages()
Get a Vector of all accepted languages for this request. |
java.lang.Object |
getAttribute(java.lang.String attributeName)
Gets the value of an attribute from the OpenCms request context attribute list. |
java.util.Vector |
getDependencies()
Returns all dependencies the templatemechanism has registered. |
com.opencms.flex.util.CmsResourceTranslator |
getDirectoryTranslator()
|
com.opencms.template.cache.CmsElementCache |
getElementCache()
Get the CmsElementCache object. |
java.lang.String |
getEncoding()
Returns the current content encoding to be used in HTTP response |
com.opencms.flex.util.CmsResourceTranslator |
getFileTranslator()
|
java.lang.String |
getFileUri()
Gets the name of the requested file without any path-information. |
java.lang.String |
getFolderUri()
Gets the name of the parent folder of the requested file |
java.util.Vector |
getLinkVector()
Returns all links that the template mechanism has registered. |
com.opencms.core.I_CmsRequest |
getRequest()
Gets the current request, if availaible. |
com.opencms.core.I_CmsResponse |
getResponse()
Gets the current response, if availaible. |
com.opencms.core.I_CmsSession |
getSession(boolean value)
Gets the Session for this request. |
java.lang.String |
getSiteName()
Returns the site name, e.g. |
java.lang.String |
getSiteRoot()
Returns the site root, e.g. |
java.lang.String |
getSiteRoot(java.lang.String resourcename)
Returns the name of the current site root, e.g. |
java.lang.String |
getUri()
Gets the uri for the requested resource. |
(package private) void |
init(I_CmsResourceBroker rb,
com.opencms.core.I_CmsRequest req,
com.opencms.core.I_CmsResponse resp,
java.lang.String user,
java.lang.String currentGroup,
int currentProjectId,
boolean streaming,
com.opencms.template.cache.CmsElementCache elementCache,
com.opencms.flex.util.CmsResourceTranslator directoryTranslator,
com.opencms.flex.util.CmsResourceTranslator fileTranslator)
Initializes this RequestContext. |
void |
initEncoding()
Detects current content encoding to be used in HTTP response based on requested resource or session state. |
boolean |
isAdmin()
Determines if the users is in the admin-group. |
boolean |
isElementCacheEnabled()
Get the current mode for element cache. |
boolean |
isEventControlled()
Check if this request context is event controlled. |
boolean |
isProjectManager()
Determines if the users current group is the projectmanager-group. |
boolean |
isStreaming()
Get the current mode for HTTP streaming. |
boolean |
isUpdateSessionEnabled()
Check if this request context will update the session. |
void |
setAttribute(java.lang.String key,
java.lang.Object value)
Sets an attribute in the request context. |
void |
setContextTo(java.lang.String name)
Sets the name of the current site root of the virtual file system |
void |
setCurrentGroup(java.lang.String groupname)
Sets the current group of the current user. |
CmsProject |
setCurrentProject(int projectId)
Sets the current project for the user. |
void |
setEncoding(java.lang.String encoding)
Sets the current content encoding to be used in HTTP response |
void |
setEncoding(java.lang.String encoding,
boolean storeInSession)
Sets the current content encoding to be used in HTTP response and store it in session if it is available |
void |
setEventControlled(boolean value)
Mark this request context as event controlled. |
void |
setStreaming(boolean b)
Set the current mode for HTTP streaming. |
void |
setUpdateSessionEnabled(boolean value)
Mark this request context to update the session or not. |
void |
setUri(java.lang.String value)
Set the value that is returned by getUri() to the provided String. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
m_rb
private I_CmsResourceBroker m_rb
- The rb to get access to the OpenCms
m_req
private com.opencms.core.I_CmsRequest m_req
- The current CmsRequest
m_resp
private com.opencms.core.I_CmsResponse m_resp
- The current CmsResponse
m_user
private CmsUser m_user
- The current user
m_currentGroup
private CmsGroup m_currentGroup
- The current group of the user
m_currentProject
private CmsProject m_currentProject
- The current project
m_streaming
private boolean m_streaming
- Flag to indicate if this response is streaming or not (legacy, not used by Element or Flex cache)
m_links
private java.util.Vector m_links
- In export mode the links in pages will be stored in this vector
for further processing.
m_eventControlled
private boolean m_eventControlled
- Flag to indicate that this request is event controlled
m_updateSession
private boolean m_updateSession
- Flag to indicate that this context should not update the user session
m_dependencies
private java.util.Vector m_dependencies
- In export mode this vector is used to store all dependencies this request
may have. It is saved to the database and if one of the dependencies changes
the request will be exported again.
m_elementCache
private com.opencms.template.cache.CmsElementCache m_elementCache
- Starting point for element cache
m_language
private java.util.Vector m_language
- Current languages
m_siteRoot
private java.lang.String m_siteRoot
- The name of the root, e.g. /site_a/vfs
m_encoding
private java.lang.String m_encoding
- Current encoding
m_uri
private java.lang.String m_uri
- The URI for getUri() in case it is "overwritten"
m_directoryTranslator
private com.opencms.flex.util.CmsResourceTranslator m_directoryTranslator
- Directroy name translator
m_fileTranslator
private com.opencms.flex.util.CmsResourceTranslator m_fileTranslator
- File name translator
m_attributeMap
private java.util.HashMap m_attributeMap
- A map for storing (optional) request context attributes
| Constructor Detail |
CmsRequestContext
public CmsRequestContext()
- The default constructor.
| Method Detail |
init
void init(I_CmsResourceBroker rb, com.opencms.core.I_CmsRequest req, com.opencms.core.I_CmsResponse resp, java.lang.String user, java.lang.String currentGroup, int currentProjectId, boolean streaming, com.opencms.template.cache.CmsElementCache elementCache, com.opencms.flex.util.CmsResourceTranslator directoryTranslator, com.opencms.flex.util.CmsResourceTranslator fileTranslator) throws com.opencms.core.CmsException
- Initializes this RequestContext.
addLink
public void addLink(java.lang.String link)
- Adds a link for the static export.
getLinkVector
public java.util.Vector getLinkVector()
- Returns all links that the template mechanism has registered.
addDependency
public void addDependency(java.lang.String rootName)
- Adds a dependency.
getDependencies
public java.util.Vector getDependencies()
- Returns all dependencies the templatemechanism has registered.
currentFolder
public CmsFolder currentFolder() throws com.opencms.core.CmsException
- Returns the current folder object.
currentGroup
public CmsGroup currentGroup()
- Returns the current group of the current user.
currentProject
public CmsProject currentProject()
- Returns the current project of the current user.
currentUser
public CmsUser currentUser()
- Returns the current user object.
getFileUri
public java.lang.String getFileUri()
- Gets the name of the requested file without any path-information.
getFolderUri
public java.lang.String getFolderUri()
- Gets the name of the parent folder of the requested file
getRequest
public com.opencms.core.I_CmsRequest getRequest()
- Gets the current request, if availaible.
getResponse
public com.opencms.core.I_CmsResponse getResponse()
- Gets the current response, if availaible.
getSession
public com.opencms.core.I_CmsSession getSession(boolean value)
- Gets the Session for this request.
This method should be used instead of the originalRequest.getSession() method.
getUri
public java.lang.String getUri()
- Gets the uri for the requested resource.
For a http request, the name of the resource is extracted as follows:
http://{servername}/{servletpath}/{path to the cms resource}
In the following example:
http://my.work.server/servlet/opencms/system/def/explorer
the requested resource is/system/def/explorer.
setUri
public void setUri(java.lang.String value)
- Set the value that is returned by getUri()
to the provided String.
This is required in a context where a cascade of included XMLTemplates are combined with JSP or other Templates that use the ResourceLoader interface. You need to fake the URI because the ElementCache always uses cms.getRequestContext().getUri() even if you called CmsXmlLauncher.generateOutput() with a differnt file name.
- Since:
- 5.0 beta 1
isAdmin
public boolean isAdmin()
throws com.opencms.core.CmsException
- Determines if the users is in the admin-group.
isProjectManager
public boolean isProjectManager()
throws com.opencms.core.CmsException
- Determines if the users current group is the projectmanager-group.
All projectmanagers can create new projects, or close their own projects.
setCurrentGroup
public void setCurrentGroup(java.lang.String groupname) throws com.opencms.core.CmsException
- Sets the current group of the current user.
setCurrentProject
public CmsProject setCurrentProject(int projectId) throws com.opencms.core.CmsException
- Sets the current project for the user.
isStreaming
public boolean isStreaming()
- Get the current mode for HTTP streaming.
setStreaming
public void setStreaming(boolean b)
throws com.opencms.core.CmsException
- Set the current mode for HTTP streaming.
Calling this method is only allowed, if the response output stream was not used before. Otherwise the streaming mode must not be changed.
isElementCacheEnabled
public boolean isElementCacheEnabled()
- Get the current mode for element cache.
getElementCache
public com.opencms.template.cache.CmsElementCache getElementCache()
- Get the CmsElementCache object. This is the starting point for the element cache area.
getAcceptedLanguages
public java.util.Vector getAcceptedLanguages()
- Get a Vector of all accepted languages for this request.
Languages are coded in international shortcuts like "en" or "de".
If the browser has sent special versions of languages (e.g. "de-ch" for Swiss-German)
these extensions will be cut off.
getSiteRoot
public java.lang.String getSiteRoot(java.lang.String resourcename)
- Returns the name of the current site root, e.g. /default/vfs
getDirectoryTranslator
public com.opencms.flex.util.CmsResourceTranslator getDirectoryTranslator()
getFileTranslator
public com.opencms.flex.util.CmsResourceTranslator getFileTranslator()
getSiteName
public java.lang.String getSiteName()
- Returns the site name, e.g.
/default
getSiteRoot
public java.lang.String getSiteRoot()
- Returns the site root, e.g.
/default/vfs* @return the site root, e.g./default/vfs
setContextTo
public void setContextTo(java.lang.String name)
- Sets the name of the current site root
of the virtual file system
initEncoding
public void initEncoding()
- Detects current content encoding to be used in HTTP response
based on requested resource or session state.
getEncoding
public java.lang.String getEncoding()
- Returns the current content encoding to be used in HTTP response
setEncoding
public void setEncoding(java.lang.String encoding)
- Sets the current content encoding to be used in HTTP response
setEncoding
public void setEncoding(java.lang.String encoding, boolean storeInSession)
- Sets the current content encoding to be used in HTTP response
and store it in session if it is available
setEventControlled
public void setEventControlled(boolean value)
- Mark this request context as event controlled.
isEventControlled
public boolean isEventControlled()
- Check if this request context is event controlled.
setUpdateSessionEnabled
public void setUpdateSessionEnabled(boolean value)
- Mark this request context to update the session or not.
isUpdateSessionEnabled
public boolean isUpdateSessionEnabled()
- Check if this request context will update the session.
getAttribute
public java.lang.Object getAttribute(java.lang.String attributeName)
- Gets the value of an attribute from the OpenCms request context attribute list.
setAttribute
public void setAttribute(java.lang.String key, java.lang.Object value)
- Sets an attribute in the request context.
|
|||||||||
| Home >> All >> com >> opencms >> [ file overview ] | PREV CLASS NEXT CLASS | ||||||||
SUMMARY: JAVADOC | SOURCE | DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||
JAVADOC
com.opencms.file.CmsRequestContext