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代替。