rwsf::HttpServletRequest Class Reference

Extends rwsf::ServletRequest to provide request information for HTTP servlets. More...

#include <rwsf/servlet/http/HttpServletRequest.h>

Inheritance diagram for rwsf::HttpServletRequest:

Public Member Functions
virtual	~HttpServletRequest ()
std::string	getAuthType () const
int	getContentLength () const
std::string	getContentType () const
std::string	getContextPath () const
bool	getCookie (const std::string &name, rwsf::Cookie &cookie) const
std::list< rwsf::Cookie >	getCookies () const
rwsf::DateTime	getDateHeader (const std::string &name) const
std::string	getHeader (const std::string &name) const
rwsf::Enumeration< std::string >	getHeaderNames () const
rwsf::Enumeration< std::string >	getHeaders (const std::string &name) const
int	getIntHeader (const std::string &name) const
std::string	getMethod () const
std::string	getPathInfo () const
std::string	getPathTranslated () const
std::string	getQueryString () const
std::string	getRemoteUser () const
std::string	getRequestedSessionId () const
std::string	getRequestURI () const
std::string	getRequestURL () const
std::string	getServletPath () const
rwsf::HttpSession	getSession (bool create, rwsf::HttpSession::Lifetime l=rwsf::HttpSession::Transient) const
rwsf::HttpSession	getSession (rwsf::HttpSession::Lifetime l=rwsf::HttpSession::Transient) const
bool	isRequestedSessionIdFromCookie () const
bool	isRequestedSessionIdFromURL () const
bool	isRequestedSessionIdValid () const
bool	isUserInRole (const std::string &role) const
rwsf::DateTime	parseDate (const std::string &value) const
Public Member Functions inherited from rwsf::ServletRequest
virtual	~ServletRequest ()
rwsf::Attribute	getAttribute (const std::string &name) const
rwsf::Enumeration< std::string >	getAttributeNames () const
std::string	getCharacterEncoding () const
int	getContentLength () const
std::string	getContentType () const
std::string	getParameter (const std::string &name) const
rwsf::Enumeration< std::string >	getParameterNames () const
std::list< std::string >	getParameterValues (const std::string &name) const
std::string	getPayload () const
std::string	getProtocol () const
std::string	getRemoteAddr () const
std::string	getRemoteHost () const
rwsf::RequestDispatcher	getRequestDispatcher (const std::string &path)
std::string	getScheme () const
std::string	getServerName () const
int	getServerPort () const
bool	isSecure () const
rwsf::Attribute	removeAttribute (const std::string &name)
void	setAttribute (const std::string &name, const rwsf::Attribute &value)

Detailed Description

An HTTP servlet receives an rwsf::HttpServletRequest object for each request from a client. The request object contains the complete information in the request as well as any rwsf::HttpSession object associated with the request.

The behavior of the following functions are inconsistent with or not defined in the Java Servlet Specification v2.3.

getAuthType()	Returns an empty string
getContentLength()	Added method, overrides ServletRequest::getContentLength()
getRemoteUser()	Returns an empty string
getRequestURI()	Returns http://foo.bar/a.html for the request URL http://foo.bar/a.html. It should return /a.html.
getUserPrincipal()	Not included in this implementation
isUserInRole()	Returns false
parseDate()	Added method, but deprecated

Constructor & Destructor Documentation

virtual rwsf::HttpServletRequest::~HttpServletRequest ( )

virtual

Destructor.

Member Function Documentation

std::string rwsf::HttpServletRequest::getAuthType

(

)

const

This method currently returns an empty string.

int rwsf::HttpServletRequest::getContentLength

(

)

const

Returns the value of the Content-Length header of the request, or -1 if the request contains no such header.

std::string rwsf::HttpServletRequest::getContentType

(

)

const

Returns the Content-Type of the request. When the request has no content type, returns the empty string.

std::string rwsf::HttpServletRequest::getContextPath

(

)

const

Returns the path for the context from the request URI. For example, in the URL /examples/HelloWorld, the context path is /examples.

bool rwsf::HttpServletRequest::getCookie	(	const std::string &	name,
		rwsf::Cookie &	cookie
	)		const

Locates the cookie named name in this request. If such a cookie exists, the function copies the located cookie to cookie and returns true. Otherwise, the function returns false and cookie is unchanged. Name comparisons are case-sensitive.

std::list<rwsf::Cookie> rwsf::HttpServletRequest::getCookies

(

)

const

Returns a list of the cookies in this request. Returns an empty list if this request has no cookies.

rwsf::DateTime rwsf::HttpServletRequest::getDateHeader

(

const std::string &

name

)

const

Returns the value of the named HTTP header as an rwsf::DateTime. Returns a null date if the header does not exist. Returns an invalid date if the header value is not a valid HTTP/1.1 date string. Header name comparisons are case-insensitive.

std::string rwsf::HttpServletRequest::getHeader

(

const std::string &

name

)

const

Returns the value of the HTTP header in this request with a name matching name. If this request contains no such header, returns the empty string. Header name comparisons are case-insensitive.

rwsf::Enumeration<std::string> rwsf::HttpServletRequest::getHeaderNames

(

)

const

Returns an enumeration of the names of the headers contained in the request. Use this method with caution. The contents of the enumeration and the order of the values may vary from request to request.

rwsf::Enumeration<std::string> rwsf::HttpServletRequest::getHeaders

(

const std::string &

name

)

const

Returns an enumeration for all values for the HTTP header named name. This is useful for HTTP headers that can have multiple values. For headers that contain a single value, this function returns an enumeration that contains that value. If the request contains no matching HTTP header, this function returns an empty enumeration. Header name comparisons are case-insensitive.

int rwsf::HttpServletRequest::getIntHeader

(

const std::string &

name

)

const

Returns the value of the HTTP header named name as an int. If the header cannot be found, returns -1. If the value cannot be converted to an int, returns 0.

std::string rwsf::HttpServletRequest::getMethod

(

)

const

Returns the HTTP method that was used to invoke this request. The value will be a non-standard HTTP method or one of the following: POST, GET, PUT, DELETE, OPTIONS, or HEAD.

std::string rwsf::HttpServletRequest::getPathInfo

(

)

const

This method returns any extra path information from the request. If there is no extra path information, returns the empty string.

Extra path information is information that follows the servlet path but precedes the query string.

For example, if the servlet is located at /examples/hello, this function returns /extra/path for the request URI /examples/hello/extra/path?val=10. For the request URI /examples/hello, this function returns the empty string.

std::string rwsf::HttpServletRequest::getPathTranslated

(

)

const

Returns the full path on the underlying operating system that corresponds to the path in the HTTP request. This method returns the empty string if the path info is empty.

std::string rwsf::HttpServletRequest::getQueryString

(

)

const

Returns the query string portion of the request URI. This method returns the empty string if there is no query string. The query string for a URI such as /rwsf/Hello?val=10 would be val=10.

std::string rwsf::HttpServletRequest::getRemoteUser

(

)

const

Returns the login name of the user who made this request. If the user is not known, returns the empty string. This method is currently unimplemented. All calls to this function return the empty string.

std::string rwsf::HttpServletRequest::getRequestedSessionId

(

)

const

Returns the session ID for the current session. If there is no current session, returns the empty string.

std::string rwsf::HttpServletRequest::getRequestURI

(

)

const

Returns the URI for this request minus the query string. The web container does not decode this string. The following table shows the return value for some example URIs:

First Line of HTTP Request	Returned Value
POST /some/path.html HTTP/1.1	/some/path.html
GET http://foo.bar/a.html HTTP/1.1	http://foo.bar/a.html
HEAD /xyz?a=b HTTP/1.1	/xyz

std::string rwsf::HttpServletRequest::getRequestURL

(

)

const

Reconstructs the URL the client used to make the request. The returned URL contains a protocol, server name, port number, and server path, but does not include query string parameters.

This method is useful for creating redirect messages and for reporting errors.

std::string rwsf::HttpServletRequest::getServletPath

(

)

const

Returns the path for this servlet from the request URI. The servlet path is the portion of the path between the servlet context and the extra path info or query string. For example, the URI /rwsf/HelloWorld?val=10 has a servlet path of /HelloWorld.

rwsf::HttpSession rwsf::HttpServletRequest::getSession	(	bool	create,
		rwsf::HttpSession::Lifetime	l = rwsf::HttpSession::Transient
	)		const

Returns the current session. If there is no current session, or if the current session is invalid, returns a new session if create is true; returns an invalid session if create is false.

rwsf::HttpSession rwsf::HttpServletRequest::getSession

(

rwsf::HttpSession::Lifetime

l = rwsf::HttpSession::Transient

)

const

Returns the current session. If there is no current session, or if the current session is invalid, returns a new session.

bool rwsf::HttpServletRequest::isRequestedSessionIdFromCookie

(

)

const

Returns true if the current session was created from a cookie. The Agent uses JSESSIONID as the cookie to store the session id.

bool rwsf::HttpServletRequest::isRequestedSessionIdFromURL

(

)

const

Returns true if the current session was found in the URL. The Agent uses a query string parameter name of JSESSIONID to store the session id.

bool rwsf::HttpServletRequest::isRequestedSessionIdValid

(

)

const

Returns true if the current session is valid, false otherwise.

bool rwsf::HttpServletRequest::isUserInRole

(

const std::string &

role

)

const

This method is currently unimplemented. It always returns false.

rwsf::DateTime rwsf::HttpServletRequest::parseDate

(

const std::string &

value

)

const

Deprecated:

As of version 4.6, replaced by getDateHeader().

This method can be used with the getHeader() method to convert an HTTP header representing a date object to an rwsf::DateTime object.