httpservletrequest

公共接口类HttpServletRequest继承自ServletRequest.客户端浏览器发出的请求被封装成为一个HttpServletRequest对象。全部的信息包括请求的地址，请求的参数，提交的数据，上传的文件客户端的ip甚至客户端操做系统都包含在其内。HttpServletResponse继承了ServletResponse接口，并提供了与Http协议有关的方法，这些方法的主要功能是设置HTTP状态码和管理Cookie。

　　1、HttpServletRequest接口

　　定义

　　public interface HttpServletRequest extends ServletRequest;

　　用来处理一个对Servlet的HTTP格式的请求信息。

　　方法

　　一、getAuthType

　　public String getAuthType();

　　返回这个请求的身份验证模式。

　　二、getCookies

　　public Cookie[] getCookies();

　　返回一个 数组 ，该数组包含这个请求中当前的全部cookie。若是这个请求中没有cookie，返回一个 空数组 。

　　三、getDateHeader

　　public long getDateHeader(String name);

　　返回指定的请求头域的值，这个值被转换成一个反映自1970-1-1日（GMT）以来的精确到毫秒的长整数。

　　若是头域不能转换，抛出一个IllegalArgumentException。若是这个请求头域不存在，这个方法返回-1。

　　四、getHeader

　　public String getHeader(String name);

　　返回一个请求头域的值。（译者注：与上一个方法不一样的是，该方法返回一个字符串）

　　若是这个请求头域不存在，这个方法返回-1。

　　五、getHeaderNames

　　public Enumeration getHeaderNames();

　　该方法返回一个String对象的列表，该列表反映请求的全部头域名。

　　有的引擎可能不容许经过这种方法访问头域，在这种状况下，这个方法返回一个空的列表。

　　六、getIntHeader

　　public int getIntHeader(String name);

　　返回指定的请求头域的值，这个值被转换成一个整数。

　　若是头域不能转换，抛出一个IllegalArgumentException。若是这个请求头域不存在，这个方法返回-1。

　　七、getMethod

　　public String getMethod();

　　返回这个请求使用的HTTP方法（例如：GET、POST、PUT）

　　八、getPathInfo

　　public String getPathInfo();

　　这个方法返回在这个请求的URL的Servlet路径以后的请求URL的额外的路径信息。若是这个请求URL包括一个查询字符串，在返回值内将不包括这个查询字符串。这个路径在返回以前必须通过URL解码。若是在这个请求的URL的Servlet路径以后没有路径信息。这个方法返回 空值 。

　　九、getPathTranslated

　　public String getPathTranslated();

　　这个方法得到这个请求的URL的Servlet路径以后的额外的路径信息，并将它转换成一个真实的路径。在进行转换前，这个请求的URL必须通过URL解码。若是在这个URL的Servlet路径以后没有附加路径信息。这个方法返回空值。

　　十、getQueryString

　　public String getQueryString();

　　返回这个请求URL所包含的查询字符串。一个查询字串符在一个URL中由一个“？”引出。若是没有查询字符串，这个方法返回空值。

　　十一、getRemoteUser

　　public String getRemoteUser

　　返回做了请求的用户名，这个信息用来做HTTP用户论证。

　　若是在请求中没有用户名信息，这个方法返回空值。

　　十二、getRequestedSessionId

　　public String getRequestedSessionId();

　　返回这个请求相应的session id。若是因为某种缘由 客户端 提供的session id是无效的，这个session id将与在当前session中的session id不一样，与此同时，将创建一个新的session。

　　若是这个请求没与一个session关联，这个方法返回空值。

　　1三、getRequestURI

　　public String getRequestURI();

　　从 HTTP请求 的第一行返回请求的URL中定义被请求的资源的部分。若是有一个查询字符串存在，这个查询字符串将不包括在返回值当中。例如，一个请求经过/catalog/books?id=1这样的URL路径访问，这个方法将返回/catalog/books。这个方法的返回值包括了Servlet路径和路径信息。

　　若是这个URL路径中的的一部分通过了URL编码，这个方法的返回值在返回以前必须通过解码。

　　1四、getServletPath

　　public String getServletPath();

　　这个方法返回请求URL反映调用Servlet的部分。例如，一个Servlet被映射到/catalog/summer这个URL路径，而一个请求使用了/catalog/summer/casual这样的路径。所谓的反映调用Servlet的部分就是指/catalog/summer。

　　若是这个Servlet不是经过 路径 匹配来调用。这个方法将返回一个空值。

　　1五、getSession

　　public HttpSession getSession();

　　public HttpSession getSession(boolean create);

　　返回与这个请求关联的当前的有效的session。若是调用这个方法时没带参数，那么在没有session与这个请求关联的状况下，将会新建一个session。若是调用这个方法时带入了一个布尔型的参数，只有当这个参数为真时，session才会被创建。

　　为了确保session可以被彻底维持。Servlet开发者必须在响应被提交以前调用该方法。

　　若是带入的参数为假，并且没有session与这个请求关联。这个方法会返回空值。

　　1六、isRequestedSessionIdValid

　　public boolean isRequestedSessionIdValid();

　　这个方法检查与此请求关联的session当前是否是有效。若是当前请求中使用的session无效，它将不能经过getSession方法返回。

　　1七、isRequestedSessionIdFromCookie

　　public boolean isRequestedSessionIdFromCookie();

　　若是这个请求的session id是经过客户端的一个cookie提供的，该方法返回真，不然返回假。

　　1八、isRequestedSessionIdFromURL

　　public boolean isRequestedSessionIdFromURL();

　　若是这个请求的session id是经过客户端的URL的一部分提供的，该方法返回真，不然返回假。请注意此方法与isRequestedSessionIdFromUrl在URL的拼写上不一样。

　　如下方法将被取消

　　1九、isRequestedSessionIdFromUrl

　　public boolean isRequestedSessionIdFromUrl();

　　该方法被isRequestedSessionIdFromURL代替。