Java Doc for Request.java in  » Sevlet-Container » jetty-modules » org » mortbay » jetty » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Implements javax.servlet.HttpServletRequest from the javax.servlet package.

The standard interface of mostly getters, is extended with setters so that the request is mutable by the handlers that it is passed to. This allows the request object to be as lightweight as possible and not actually implement any significant behaviour. For example

• The getContextPath method will return null, until the requeset has been passed to a ContextHandler which matches the getPathInfo with a context path and calls setContextPath as a result.
• the HTTP session methods will all return null sessions until such time as a request has been passed to a org.mortbay.jetty.servlet.SessionHandler which checks for session cookies and enables the ability to create new sessions.
• The getServletPath method will return null until the request has been passed to a org.mortbay.jetty.servlet.ServletHandler and the pathInfo matched against the servlet URL patterns and setServletPath called as a result.

Because this method returns a StringBuffer, not a string, you can modify the URL easily, for example, to append path and query parameters. This method is useful for creating redirect messages and for reporting errors. "scheme://host:port"