public interface httpservletrequest extends servletrequest;
用來處理一個對servlet的http格式的請求資訊。
public string getauthtype();
傳回這個請求的身份驗證模式。
public cookie[] getcookies();
傳回一個數組,該數組包含這個請求中目前的所有cookie。如果這個請求中沒有cookie,傳回一個空數組。
public long getdateheader(string name);
傳回指定的請求頭域的值,這個值被轉換成一個反映自1970-1-1日(gmt)以來的精确到毫秒的長整數。
如果頭域不能轉換,抛出一個illegalargumentexception。如果這個請求頭域不存在,這個方法傳回-1。
public string getheader(string name);
傳回一個請求頭域的值。(譯者注:與上一個方法不同的是,該方法傳回一個字元串)
如果這個請求頭域不存在,這個方法傳回-1。
public enumeration getheadernames();
該方法傳回一個string對象的清單,該清單反映請求的所有頭域名。
有的引擎可能不允許通過這種方法通路頭域,在這種情況下,這個方法傳回一個空的清單。
public int getintheader(string name);
傳回指定的請求頭域的值,這個值被轉換成一個整數。
public string getmethod();
傳回這個請求使用的http方法(例如:get、post、put)
public string getpathinfo();
這個方法傳回在這個請求的url的servlet路徑之後的請求url的額外的路徑資訊。如果這個請求url包括一個查詢字元串,在傳回值内将不包括這個查詢字元串。這個路徑在傳回之前必須經過url解碼。如果在這個請求的url的servlet路徑之後沒有路徑資訊。這個方法傳回空值。
public string getpathtranslated();
這個方法獲得這個請求的url的servlet路徑之後的額外的路徑資訊,并将它轉換成一個真實的路徑。在進行轉換前,這個請求的url必須經過url解碼。如果在這個url的servlet路徑之後沒有附加路徑資訊。這個方法傳回空值。
public string getquerystring();
傳回這個請求url所包含的查詢字元串。一個查詢字串符在一個url中由一個“?”引出。如果沒有查詢字元串,這個方法傳回空值。
public string getremoteuser
傳回作了請求的使用者名,這個資訊用來作http使用者論證。
如果在請求中沒有使用者名資訊,這個方法傳回空值。
public string getrequestedsessionid();
傳回這個請求相應的session id。如果由于某種原因用戶端提供的session id是無效的,這個session id将與在目前session中的session id不同,與此同時,将建立一個新的session。
如果這個請求沒與一個session關聯,這個方法傳回空值。
public string getrequesturl();
從http請求的第一行傳回請求的url中定義被請求的資源的部分。如果有一個查詢字元串存在,這個查詢字元串将不包括在傳回值當中。例如,一個請求通過/catalog/books?id=1這樣的url路徑通路,這個方法将傳回/catalog/books。這個方法的傳回值包括了servlet路徑和路徑資訊。
如果這個url路徑中的的一部分經過了url編碼,這個方法的傳回值在傳回之前必須經過解碼。
public string getservletpath();
這個方法傳回請求url反映調用servlet的部分。例如,一個servlet被映射到/catalog/summer這個url路徑,而一個請求使用了/catalog/summer/casual這樣的路徑。所謂的反映調用servlet的部分就是指/catalog/summer。
如果這個servlet不是通過路徑比對來調用。這個方法将傳回一個空值。
public httpsession getsession();
public httpsession getsession(boolean create);
傳回與這個請求關聯的目前的有效的session。如果調用這個方法時沒帶參數,那麼在沒有session與這個請求關聯的情況下,将會建立一個session。如果調用這個方法時帶入了一個布爾型的參數,隻有當這個參數為真時,session才會被建立。
為了確定session能夠被完全維持。servlet開發者必須在響應被送出之前調用該方法。
如果帶入的參數為假,而且沒有session與這個請求關聯。這個方法會傳回空值。
public boolean isrequestedsessionidvalid();
這個方法檢查與此請求關聯的session目前是不是有效。如果目前請求中使用的session無效,它将不能通過getsession方法傳回。
isrequestedsessionidfromcookie
public boolean isrequestedsessionidfromcookie();
如果這個請求的session id是通過用戶端的一個cookie提供的,該方法傳回真,否則傳回假。
isrequestedsessionidfromurl
public boolean isrequestedsessionidfromurl();
如果這個請求的session id是通過用戶端的url的一部分提供的,該方法傳回真,否則傳回假。請注意此方法與isrequestedsessionidfromurl在url的拼寫上不同。
以下方法将被取消
該方法被isrequestedsessionidfromurl代替。