Getting Information from Requests

A request contains data passed between a client and the servlet. All requests implement the ServletRequest interface. This interface defines methods for accessing the following information:

• Parameters, which are typically used to convey information between clients and servlets

• Object-valued attributes, which are typically used to pass information between the servlet container and a servlet or between collaborating servlets

• Information about the protocol used to communicate the request and about the client and server involved in the request

• Information relevant to localization

You can also retrieve an input stream from the request and manually parse the data. To read character data, use the BufferedReader object returned by the request’s getReader method. To read binary data, use the ServletInputStream returned by getInputStream.

HTTP servlets are passed an HTTP request object, HttpServletRequest, which contains the request URL, HTTP headers, query string, and so on. An HTTP request URL contains the following parts:

http://[host]:[port][request-path]?[query-string]

The request path is further composed of the following elements:

• Context path: A concatenation of a forward slash (/) with the context root of the servlet’s web application.

• Servlet path: The path section that corresponds to the component alias that activated this request. This path starts with a forward slash (/).

• Path info: The part of the request path that is not part of the context path or the servlet path.

You can use the getContextPath, getServletPath, and getPathInfo methods of the HttpServletRequest interface to access this information. Except for URL encoding differences between the request URI and the path parts, the request URI is always comprised of the context path plus the servlet path plus the path info.

Query strings are composed of a set of parameters and values. Individual parameters are retrieved from a request by using the getParameter method. There are two ways to generate query strings.

• A query string can explicitly appear in a web page.

• A query string is appended to a URL when a form with a GET HTTP method is submitted.