Java Servlet API文檔實用說明
Java Servlet API文檔在實際開發中十分重要，這份Java Servlet API文檔1998年的11月份就已定稿，其中一些與技術關系不大的部分已被略去，有興趣的讀者可以從http://java.sun.com/products/servlet/2.1/servletspec-2.1.zip下載原文閱讀。
這是一份關于2.1版Java Servlet API的說明文檔，作為對這本文檔的補充，你可以到http://java.sun.com/products/servlet/index.html下面下載Javadoc格式的文檔。
Java Servlet API文檔誰需要
這份文檔描述了Java Servlet API的最新版本2.1版。所以，這本書對于Servlet的開發者及servlet引擎的開發者同樣適用。
Java Servlet API文檔的組成
Java Servlet API由兩個軟件包組成：一個是對應HTTP的軟件包，另一個是不對應HTTP的通用的軟件包。這兩個軟件包的同時存在使得Java Servlet API能夠適應將來的其他請求-響應的協議。
這份文檔以及剛才提及的Javadoc格式的文檔都描述了這兩個軟件包，Javadoc格式的文檔還描述了你應該如何使用這兩個軟件包中的所有方法。
Java Servlet API文檔有關規范
你也許對下面的這些Internet規范感興趣，這些規范將直接影響到Servlet API的發展和執行。你可以從http://info.internet.isi.edu/7c/in-notes/rfc/.cache 找到下面提到的所有這些RFC規范。
RFC 1738 統一資源定位器(URL)
RFC 1808 相關統一資源定位器
RFC 1945 超文本傳輸協議--HTTP/1.0
RFC 2045 多用途Internet郵件擴展(多用途網際郵件擴充協議(MIME))第一部分:Internet信息體格式
RFC 2046 多用途Internet郵件擴展(多用途網際郵件擴充協議(MIME))第二部分:媒體類型
RFC 2047 多用途網際郵件擴充協議(MIME)(多用途Internet郵件擴展)第三部分:信息標題擴展用于非ASCII文本
RFC 2048 多用途Internet郵件擴展(多用途網際郵件擴充協議(MIME))第四部分: 注冊步驟
RFC 2049 多用途Internet郵件擴展(多用途網際郵件擴充協議(MIME))第五部分:一致性標準和例子
RFC 2068 超文本傳輸協議 -- HTTP/1.1
RFC 2069 一個擴展HTTP:摘要訪問鑒定
RFC 2109 HTTP狀態管理機制
RFC 2145 HTTP 版本號的使用和解釋
RFC 2324 超文本Coffee Pot控制協議 (HTCPCP/1.0)
萬維網協會（http://www.w3.org）管理著這些協議的規范和執行。
Java Servlet API文檔之Servlet的解析和載入
Servlet引擎解析并載入一個Servlet，這個過程可以發生在引擎啟動時，需要一個Servlet去響應請求時，以及在此之間的任何時候。
Servlet引擎利用Java類載入工具載入一個Servlet，Servlet引擎可以從一個本地的文件系統、一個遠程的文件系統以及網絡載入Servlet。
Java Servlet API文檔之Servlet的初始化
Servlet引擎載入Servlet后，Servlet引擎必須對Servlet進行初始化，在這一過程中，你可以讀取一些固定存儲的數據、初始化JDBC的連接以及建立與其他資源的連接。
在初始化過程中，javax.servlet.Servlet接口的init()方法提供了Servlet的初始化信息。這樣，Servlet可以對自己進行配置。
init()方法獲得了一個Servlet配置對象（ServletConfig）。這個對象在Servlet引擎中執行，并允許Servlet通過它獲處相關參數。這個對象使得Servlet能夠訪問ServletContext對象。
Java Servlet API文檔之Servlet處理請求
Servlet被初始化之后，它已經可以處理來自客戶端的請求，每一個來自客戶端的請求都被描述成一個ServletRequest對象，Servlet的響應被描述成一個ServletResponse對象。
當客戶端發出請求時，Servlet引擎傳遞給Servlet一個ServletRequest對象和一個ServletResponse對象，這兩個對象作為參數傳遞到service()方法中。
Servlet也可以執行ServletRequest接口和ServletResponse接口。ServletRequest接口使得Servlet有權使用客戶端發出的請求。Servlet可以通過ServletInputStream對象讀取請求信息。
ServletResponse接口允許Servlet建立響應頭和狀態代碼。通過執行這個接口，Servlet有權使用ServletOutputStream類來向客戶端返回數據。
Java Servlet API文檔之實現多線程和映射
在多線程的環境下，Servlet必須能處理許多同時發生的請求。例外的情況是這個Servlet執行了SingleThreadModel接口，如果是那樣的話，Servlet只能同時處理一個請求。
Servlet依照Servlet引擎的映射來響應客戶端的請求。一個映射對包括一個Servlet實例以及一個Servlet返回數據的URL，例如：HelloServlet with /hello/index.html。
然而，一個映射可能是由一個URL和許多Servlet實例組成，例如：一個分布式的Servlet引擎可能運行在不止一個的服務器中，這樣的話，每一個服務器中都可能有一個Servlet實例，以平衡進程的載入。作為一個Servlet的開發者，你不能假定一個Servlet只有一個實例。
Java Servlet API文檔之Servlet的卸載
Servlet引擎并不必需保證一個Servlet在任何時候或在服務開啟的任何時候都被載入。Servlet引擎可以自由的在任何時候使用或清除一個Servlet。因此，我們不能依賴一個類或實例來存儲重要的信息。
當Servlet引擎決定卸載一個Servlet時（例如，如果這個引擎被關閉或者需要讓資源），這個引擎必須允許Servlet釋放正在使用的資源并存儲有關資料。為了完成以上工作，引擎會調用Servlet的destroy()方法。
在卸載一個Servlet之前，Servlet引擎必須等待所有的service()方法完成或超時結束（Servlet引擎會對超時作出定義）。當一個Servlet被卸載時，引擎將不能給Servlet發送任何請求。引擎必須釋放Servlet并完成無用存儲單元的收集
Java Servlet API文檔之Servlet映射技術
作為一個Servlet引擎的開發者，你必須對于如何映射客戶端的請求到Servlet有大量的適應性。這份說明文檔不規定映射如何發生。但是，你必須能夠自由地運用下面的所有技術：
映射一個Servlet到一個URL
例如，你可以指定一個特殊的Servlet它僅被來自/feedback/index.html的請求調用。
映射一個Servlet到以一個指定的目錄名開始的所有URL
例如，你可以映射一個Servlet到/catalog，這樣來自/catalog/、 /catalog/garden和/catalog/housewares/index.html的請求都會被映射到這個Servlet。但是來自 /catalogtwo 或/catalog.html的請求沒被映射。
映射一個Servlet到所有以一個特定的字段結尾的所有URL
例如，你可以映射一個來自于所有以in.thtml結尾的請求到一個特定的Servlet。
映射一個Servlet到一個特殊的URL /servlet/servlet_name。
例如，如果你建立了一個名叫listattributes的Servlet，你可以通過使用/servlet/listattributes來訪問這個Servlet。
通過類名調用Servlet
例如，如果Servlet引擎接收了來自/servlet/com.foo.servlet.MailServlet的請求，Servlet引擎會載入這個com.foo.servlet.MailServlet類，建立實例，并通過這個Servlet來處理請求。
Java Servlet API文檔之Servlet環境
ServletContext接口定義了一個Servlet環境對象，這個對象定義了一個在Servlet引擎上的Servlet的視圖。通過使用這個對象，Servlet可以記錄事件、得到資源并得到來自Servlet引擎的類（例如RequestDispatcher對象）。一個 Servlet只能運行在一個Servlet環境中，但是不同的Servlet可以在Servlet引擎上有不同的視圖。
如果Servlet引擎支持虛擬主機，每個虛擬主機有一個Servlet環境。一個Servlet環境不能在虛擬主機之間共享。
Servlet引擎能夠允許一個Servlet環境有它自己的活動范圍。
例如，一個Servlet環境是屬于bank應用的，它將被映射到/bank目錄下。在這種情況下，一個對getContext方法的調用會返回/bank的Servlet環境。
HTTP會話
HTTP是一個沒有狀態的協議。要建立一個有效的Web服務應用，你必須能夠識別一個連續的來自遠端的客戶機的唯一的請求。隨著時間的過去，發展了許多會話跟蹤的技術，但是使用起來都比較麻煩。
Java Servlet API提供了一個簡單的接口，通過這個接口，Servlet引擎可以有效地跟蹤用戶的會話。
Java Servlet API文檔之建立Session
因為HTTP是一個請求-響應協議，一個會話在客戶機加入之前會被認為是一個新的會話。加入的意思是返回會話跟蹤信息到服務器中，指出會話已被建立。在客戶端加入之前，我們不能判斷下一個客戶端請求是目前會話的一部分。
在下面的情況下，Session會被認為是新的Session。
客戶端的Session在此之前還不知道
客戶端選擇不加入Session，例如，如果客戶端拒絕接收來自服務器的cookie
作為一個Servlet的開發者，你必須決定你的Web應用是否處理客戶機不加入或不能加入Session。服務器會在Web服務器或 Servlet規定的時間內維持一個Session對象。當Session終止時，服務器會釋放Session對象以及所有綁定在Session上的對象。
Java Servlet API文檔之綁定對象到Session中
如果有助于你處理應用的數據需求，你也許需要綁定對象到Session中，你可以通過一個唯一的名字綁定任何的對象到Session中，這時，你需要使用HttpSession對象。任何綁定到Session上的對象都可以被處理同一會話的Servlet調用。
有些對象可能需要你知道什么時候會被放置到Session中或從Session中移開。你可以通過使用 HttpSessionBindingListener接口獲得這些信息。當你的應用存儲數據到Session中，或從Session中清除數據，Servlet都會通過HttpSessionBindingListener檢杳什么類被綁定或被取消綁定。這個接口的方法會通報被綁定或被取消綁定的對象。
Java Servlet API文檔是很龐大的一個知識庫，那么其實常用的一些文檔內容我們要在平時積極總結。
【編輯推薦】
