Java Servlet API中文說明文檔二(2)

　　11、setMaxInactiveInterval

　　public int setMaxInactiveInterval(int interval);

　　設置一個秒數,這個秒數表示客戶端在不發出請求時,session被Servlet引擎維持的最長時間.

　　以下這個方法將被取消

　　12、getSessionContext

　　public HttpSessionContext getSessionContext();

　　返回session在其中得以保持的環境變數.這個方法和其他所有HttpSessionContext的方法一樣被取消了.

　　四、HttpSessionBindingListener介面

　　定義

　　public interface HttpSessionBindingListener

　　這個對象被加入到HTTP的session中,執行這個介面會通告有沒有什麼對象被綁定到這個HTTP session中或被從這個HTTP session中取消綁定.

　　方法

　　1、valueBound

　　public void valueBound(HttpSessionBindingEvent event);

　　當一個對象被綁定到session中,調用此方法.HttpSession.putValue方法被調用時,Servlet引擎應該調用此方法.

　　2、valueUnbound

　　public void valueUnbound(HttpSessionBindingEvent event);

　　當一個對象被從session中取消綁定,調用此方法.HttpSession.removeValue方法被調用時,Servlet引擎應該調用此方法.

　　五、HttpSessionContext介面

　　定義

　　此介面將被取消

　　public interface HttpSessionContext

　　這個對象是與一組HTTP session關聯的單一的實體.

　　這個介面由於安全的原因被取消,它出現在目前的版本中僅僅是為了兼容性的原因.這個介面的方法將模擬以前的版本的定義返回相應的值.

　　方法

　　1、getSession

　　public HttpSession getSession(String sessionId);

　　當初用來返回與這個session id相關的session.現在返回空值.

　　2、getIds

　　public Enumeration getIds();

　　當初用來返回這個環境下所有session id的列表.現在返回空的列表.

　　六、Cookie類

　　定義

　　public class Cookie implements Cloneable

　　這個類描述了一個cookie,有關cookie的定義你可以參照Netscape Communications Corporation的說明,也可以參照RFC 2109.

　　構造函數

　　public Cookie(String name, String value);

　　用一個name-value對定義一個cookie.這個name必須能被HTTP/1.1所接受.

　　以字元$開頭的name被RFC 2109保留.

　　給定的name如果不能被HTTP/1.1所接受,該方法拋出一個IllegalArgumentException.

　　方法

　　1、getComment

　　public String getComment();

　　返回描述這個cookie目的的說明,如果未定義這個說明,返回空值.

　　2、getDomain

　　public String getDomain();

　　返回這個cookie可以出現的區域,如果未定義區域,返回空值.

　　3、getMaxAge

　　public int getMaxAge();

　　這個方法返回這個cookie指定的最長存活時期.如果未定義這個最長存活時期,該方法返回-1.

　　4、getName

　　public String getName();

　　該方法返回cookie名.

　　5、getPath

　　public String getPath();

　　返回這個cookie有效的所有URL路徑的前綴,如果未定義,返回空值.

　　6、getSecure

　　public boolean getSecure();

　　如果這個cookie只通過安全通道傳輸返回真,否則返回假.

　　7、getValue

　　public String getValue();

　　該方法返回cookie的值.

　　8、getVersion

　　public int getVersion();

　　返回cookie的版本.版本1由RFC 2109解釋.版本0由Netscape Communications Corporation的說明解釋.新構造的cookie默認使用版本0.

　　9、setComment

　　public void setComment(String purpose);

　　如果一個用戶將這個cookie提交給另一個用戶,必須通過這個說明描述這個cookie的目的.版本0不支持這個屬性.

　　10、setDomain

　　public void setDomain(String pattern);

　　這個方法設置cookie的有效域的屬性.這個屬性指定了cookie可以出現的區域.一個有效域以一個點開頭（.foo.com）,這意味著在指定的域名解析系統的區域中（可能是www.foo.com但不是a.b.foo.com）的主機可以看到這個cookie.默認情況是,cookie只能返回保存它的主機.

　　11、setMaxAge

　　public void setMaxAge(int expiry);

　　這個方法設定這個cookie的最長存活時期.在該存活時期之後,cookie會被終目.負數表示這個cookie不會生效,0將從客戶端刪除這個cookie.

　　12、setPath

　　public void setPath(String uri);

　　這個方法設置cookie的路徑屬性.客戶端只能向以這個給定的路徑String開頭的路徑返回cookie.

　　13、setSecure

　　public void setSecure(boolean flag);

　　指出這個cookie只能通過安全通道（例如HTTPS）發送.只有當產生這個cookie的伺服器使用安全協議發送這個cookie值時才能這樣設置.

　　14、setValue

　　public void setValue(String newValue);

　　設置這個cookie的值,對於二進位數據採用BASE64編碼.

　　版本0不能使用空格、{}、()、=、,、「」、/、?、@、：以及；.

　　15、setVersion

　　public void setVersion(int v);

　　設置cookie的版本號

　　七、HttpServlet類

　　定義

　　public class HttpServlet extends GenericServlet implements

　　Serializable

　　這是一個抽象類,用來簡化HTTP Servlet寫作的過程.它是GenericServlet類的擴充,提供了一個處理HTTP協議的框架.

　　在這個類中的service方法支持例如GET、POST這樣的標準的HTTP方法.這一支持過程是通過分配他們到適當的方法（例如doGet、doPost）來實現的.

　　方法

　　1、doDelete

　　protected void doDelete(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP DELETE操作.這個操作允許客戶端請求從伺服器上刪除URL.這一操作可能有負面影響,對此用戶就負起責任.

　　這一方法的默認執行結果是返回一個HTTP BAD_REQUEST錯誤.當你要處理DELETE請求時,你必須重載這一方法.

　　2、doGet

　　protected void doGet(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP GET操作.這個操作允許客戶端簡單地從一個HTTP伺服器「獲得」資源.對這個方法的重載將自動地支持HEAD方法.

　　GET操作應該是安全沒有負面影響的.這個操作也應該可以安全地重複.

　　這一方法的默認執行結果是返回一個HTTP BAD_REQUEST錯誤.

　　3、doHead

　　protected void doHead(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP HEAD操作.默認的情況是,這個操作會按照一個無條件的GET方法來執行,該操作不向客戶端返回任何數據,而僅僅是返回包含內容長度的頭信息.

　　與GET操作一樣,這個操作應該是安全沒有負面影響的.這個操作也應該可以安全地重複.

　　這個方法的默認執行結果是自動處理HTTP HEAD操作,這個方法不需要被一個子類執行.

　　4、doOptions

　　protected void doOptions(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP OPTION操作.這個操作自動地決定支持哪一種HTTP方法.例如,一個Servlet寫了一個HttpServlet的子類並重載了doGet方法,doOption會返回下面的頭：

　　Allow: GET,HEAD,TRACE,OPTIONS

　　你一般不需要重載這個方法.

　　5、doPost

　　protected void doPost(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP POST操作.這個操作包含請求體的數據,Servlet應該按照他行事.

　　這個操作可能有負面影響.例如更新存儲的數據或在線購物.

　　這一方法的默認執行結果是返回一個HTTP BAD_REQUEST錯誤.當你要處理POST操作時,你必須在HttpServlet的子類中重載這一方法.

　　6、doPut

　　protected void doPut(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP PUT操作.這個操作類似於通過FTP發送文件.

　　這個操作可能有負面影響.例如更新存儲的數據或在線購物.

　　這一方法的默認執行結果是返回一個HTTP BAD_REQUEST錯誤.當你要處理PUT操作時,你必須在HttpServlet的子類中重載這一方法.

　　7、doTrace

　　protected void doTrace(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　被這個類的service方法調用,用來處理一個HTTP TRACE操作.這個操作的默認執行結果是產生一個響應,這個響應包含一個反映trace請求中發送的所有頭域的信息.

　　當你開發Servlet時,在多數情況下你需要重載這個方法.

　　8、getLastModified

　　protected long getLastModified(HttpServletRequest request);

　　返回這個請求實體的修改時間.為了支持GET操作,你必須重載這一方法,以精確地反映修改的時間.這將有助於瀏覽器和代理伺服器減少裝載伺服器和網路資源,從而更加有效地工作.返回的數值是自1970-1-1日（GMT）以來的毫秒數.

　　默認的執行結果是返回一個負數,這標誌著修改時間未知,它也不能被一個有條件的GET操作使用.

　　9、service

　　protected void service(HttpServletRequest request,

　　HttpServletResponse response) throws ServletException,

　　IOException;

　　public void service(ServletRequest request, ServletResponse response)

　　throws ServletException, IOException;

　　這是一個Servlet的HTTP-specific方案,它分配請求到這個類的支持這個請求的其他方法.

　　當你開發Servlet時,在多數情況下你不必重載這個方法.

　　八、HttpSessionBindingEvent類

　　定義

　　public class HttpSessionBindingEvent extends EventObject

　　這個事件是在監聽到HttpSession發生綁定和取消綁定的情況時連通HttpSessionBindingListener的.這可能是一個session被終止或被認定無效的結果.

　　事件源是HttpSession.putValue或HttpSession.removeValue.

　　構造函數

　　public HttpSessionBindingEvent(HttpSession session, String name);

　　通過引起這個事件的Session和發生綁定或取消綁定的對象名構造一個新的HttpSessionBindingEvent.

　　方法

　　1、getName

　　public String getName();

　　返回發生綁定和取消綁定的對象的名字.

　　2、getSession

　　public HttpSession getSession();

　　返回發生綁定和取消綁定的session的名字.

　　九、HttpUtils類

　　定義

　　public class HttpUtils

　　收集HTTP Servlet使用的靜態的有效的方法.

　　方法

　　1、getRequestURL

　　public static StringBuffer getRequestURL(HttpServletRequest

　　request);

　　在伺服器上重建客戶端用來建立請求的URL.這個方法反映了不同的協議（例如http和https）和埠,但不包含查詢字元串.

　　這個方法返回一個StringBuffer而不是一個String,這樣URL可以被Servlet開發者有效地修改.

　　2、parsePostData

　　public static Hashtable parsePostData(int len,

　　ServletInputstream in);

　　解析一個包含MIME類型application/x-www-form-urlencoded的數據的流,並創建一個具有關鍵值-數據對的 hash table.這裡的關鍵值是字元串,數據是該字元串所對應的值的列表.一個關鍵值可以在POST的數據中出現一次或多次.這個關鍵值每出現一次,它的相應的值就被加入到hash table中的字元串所對應的值的列表中.

　　從POST數據讀出的數據將經過URL解碼, 將被轉換為空格以十六進位傳送的數據（例如%xx）將被轉換成字元.

　　當POST數據無效時,該方法拋出一個IllegalArgumentException.

　　3、parseQueryString

　　public static Hashtable parseQueryString(String s);

　　解析一個查詢字元串,並創建一個具有關鍵值-數據對的hash table.這裡的數據是該字元串所對應的值的列表.一個關鍵值可以出現一次或多次.這個關鍵值每出現一次,它的相應的值就被加入到hash table中的字元串所對應的值的列表中.

　　從查詢字元串讀出的數據將經過URL解碼, 將被轉換為空格以十六進位傳送的數據（例如%xx）將被轉換成字元.

　　當查詢字元串無效時,該方法拋出一個IllegalArgumentException.

　　術語表

　　bytecode

　　位元組碼：由Java編譯器和Java解釋程序生成的機器代碼.

　　cookie

　　由Web伺服器建立的數據,該數據存儲在用戶的計算機上,提供了一個Web站點跟蹤用戶的參數並存儲在用戶自己硬碟上的方法.

　　HTTP

　　超文本傳輸協議.一個請求響應協議用來連接WWW伺服器向客戶端瀏覽器傳輸HTML頁面.

　　輸入流對象

　　一個對象,由ServletInputStream類定義,被Servlet用來從客戶端讀取請求.

　　映射

　　由Servlet實例和Servlet返回數據的URL組成的一對,例如,HelloServlet和/hello/index.html.

　　輸出流對象

　　一個對象,由ServletOutputStream class類定義,被Servlet用來向客戶端返回數據.

　　request dispatcher object

　　由RequestDispatcher介面定義的一個對象,用來從客戶端接收請求,並將其發送到Web伺服器上可用的其他資源（例如Servlet、CGI、HTML文件或JSP文件）.

　　sandboxed servlet

　　在一個安全性約束下運行的Servlet.

　　servlet

　　一個小的,具有平台無關性的,沒有圖形用戶界面的Java程序.它可以在許多方面擴充Web服務的功能.

　　servlet configuration object

　　ServletConfig介面定義的一個對象,用來配置一個Servlet.

　　servlet context object

　　ServletContext介面定義的一個對象.給予Servlet有關Servlet引擎的信息.

　　servlet引擎

　　由Web伺服器提供商製作的一個環境,可以允許Servlet在具體的Web伺服器上運行.

　　servlet請求對象

　　由ServletRequest介面定義的一個對象,允許Servlet獲得用關客戶端請求的數據.

　　servlet response object

　　由ServletResponse介面定義的一個對象,允許Servlet作出響應.

　　servlet runner

　　Java Servlet Developer』s Kit (JSDK)中的sun.servlet.http.HttpServer過程,它是的Servlet得以運行.

　　會話跟蹤

　　在一個Web應用程序中,識別一個從同一個客戶端發出的連續的唯一的請求的能力.

　　SSL

　　加密套接字協議層.一個安全協議,用來在Iternet上的客戶端瀏覽器和伺服器交換密鑰和加密數據.

　　URI

　　統一資源標識.定義一個Internet地址,它是一個URL的超集.

　　URL

　　統一資源路徑.這個地址定義了到達一個WWW上的文件的路線,通常由協議前綴、域名、目錄名和文件名組成.

Tags: