rwsf::ServletContext
Package: Servlet
rwsf::ServletContextrwsf::HandleBase
- Local Index
- Header File
- Description
- Public Constructors
- Public Destructor
- Public Member Operators
- Public Member Functions
- See Also
Local Index
Members
Header File
#include <rwsf/servlet/ServletContext.h>
Description
rwsf::ServletContext represents the web application context. The Agent constructs a single context object for each web application. Each context object contains application-wide initialization parameters, information about the deployment environment, and a collection of attributes. A context also provides factory methods for creating request dispatchers to redirect requests. A context can retrieve other context objects held by the server so objects in different applications can cooperate.
Table 7 lists methods that are either non-standard or not supported at this release.
Table 7: rwsf::ServletContext deviation from Servlet Specification
| Member | Description of Difference from Servlet Specification |
getRequestDispatcher() | Accepts an HTTP URL. This is an extension to the specification. |
getResource() | Not included in this implementation. Use getResourceData() from rwsf::ServletContext instead. |
getResourceData() | HydraExpress added this method as a safer alternative for C++ than the getResourceAsStream() method. |
getResourceAsStream() | Not included in this implementation. Use getResourceData() from rwsf::ServletContext instead. |
Public Constructors
ServletContext();
Creates an empty servlet context. Use the copy constructor or assignment operator to create a valid servlet context.
ServletContext(const rwsf::ServletContext& second);
Attaches to and increments the reference count on second's body.
Public Destructor
~ServletContext();
Detaches from the current body (if any), decrements its reference count, deletes it if there are no other references.
Public Member Operators
rwsf::ServletContext& operator=(const rwsf::ServletContext& second);
Detaches from the current body (if any), decrements its reference count, deletes it if there are no other references, and then attaches to second 's body and increments its reference count.
Public Member Functions
rwsf::Attribute getAttribute(const std::string& name) const;
Returns the specified attribute. Attribute name comparisons are case sensitive. If the named attribute is not found, returns an empty attribute.
rwsf::Enumeration<std::string> getAttributeNames() const;
Returns an enumeration of all attribute names in this context. If there are no attributes, returns an empty enumeration.
rwsf::ServletContext getContext(const std::string& uriPath) const;
Returns the servlet context associated with the given URI.
std::string getContextPath() const;
Returns the local path to the context directory.
std::string getInitParameter(const std::string& name) const;
Returns the named servlet context init parameter. Servlet context init parameters are defined in the deployment descriptor. If the named parameter cannot be found returns the empty string.
rwsf::Enumeration<std::string> getInitParameterNames() const;
Returns an enumeration of all context level initialization parameter names. If there are no initialization parameters, the enumeration will be empty.
int getMajorVersion() const;
Returns 2, the major version of the servlet API that the Agent supports.
std::string getMimeType(const std::string& fileName) const;
Returns the appropriate MIME type for the named file. MIME types are configured in the global configuration file and also in the individual context configuration files.
int getMinorVersion() const;
Returns 3, the minor version of the servlet API that the Agent supports.
rwsf::RequestDispatcher getNamedDispatcher(const std::string& name) const;
Returns a request dispatcher object for the named servlet. If the named servlet does not exist, returns an invalid rwsf::RequestDispatcher object.
std::string getRealPath(const std::string& path) const;
Returns the full operating system specific path to the resource specified in path.
rwsf::RequestDispatcher getRequestDispatcher(const std::string& path) const;
Returns a request dispatcher object for the path specified. The path can indicate either a local path to a servlet within the same context, a local path to a static page within the same context, or a complete HTTP URL.
std::string getResourceData(const std::string& path) const;
Returns the named resource as a string. This method takes care to clean up any resources that may have been allocated when loading the named resource.
rwsf::Enumeration<std::string> getResourcePaths() const;
Returns a set of all paths in the web application.
std::string getServerInfo() const;
Returns the server identification string.
std::string getServletContextName() const;
Returns the name of this servlet context as defined by the directory in which the context has been deployed.
void log(const std::string& msg) const;
Writes msg to a servlet log file.
void log(const std::string& msg, const rwsf::Exception& e) const;
Writes msg and the string returned by e.why() to a servlet log file.
rwsf::Attribute removeAttribute(const std::string& name);
Removes the named attribute from the servlet context. Returns the previous value. If the named attribute cannot be found, returns an empty attribute. Attribute names are case-sensitive. If there are any rwsf::ServletContextAttributeListener objects defined in the context web.xml file, the Agent notifies those listeners of this change.
void
setAttribute(const std::string& name,
const rwsf::Attribute& value);
Sets the named attribute to the given value. If there are any rwsf::ServletContextAttributeListener objects defined in the context web.xml file, the Agent notifies those listeners of the change.
void setSessionTimeout(long timeout);
Sets the session timeout to timeout minutes. The Agent invalidates any sessions that have been inactive for longer than the session timeout value. A negative value indicates that sessions should never time out.
See Also
rwsf::ServletContextAttributeListener
©2004-2007 Copyright Quovadx, Inc. All Rights Reserved.
Quovadx and Rogue Wave are registered trademarks of Quovadx, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.