緒言
這是一份關(guān)于2.1版Java Servlet API的說(shuō)明文檔，作為對(duì)這本文檔的補(bǔ)充，你可以到http://java.sun.com/products/servlet/index.html下面下載Javadoc格式的文檔。

誰(shuí)需要讀這份文檔
這份文檔描述了Java Servlet API的最新版本2.1版。所以，這本書對(duì)于Servlet的開(kāi)發(fā)者及servlet引擎的開(kāi)發(fā)者同樣適用。

Java Servlet API的組成
Java Servlet API由兩個(gè)軟件包組成：一個(gè)是對(duì)應(yīng)HTTP的軟件包，另一個(gè)是不對(duì)應(yīng)HTTP的通用的軟件包。這兩個(gè)軟件包的同時(shí)存在使得Java Servlet API能夠適應(yīng)將來(lái)的其他請(qǐng)求-響應(yīng)的協(xié)議。
這份文檔以及剛才提及的Javadoc格式的文檔都描述了這兩個(gè)軟件包，Javadoc格式的文檔還描述了你應(yīng)該如何使用這兩個(gè)軟件包中的所有方法。

有關(guān)規(guī)范
你也許對(duì)下面的這些Internet規(guī)范感興趣，這些規(guī)范將直接影響到Servlet API的發(fā)展和執(zhí)行。你可以從http://info.internet.isi.edu/7c/in-notes/rfc/.cache 找到下面提到的所有這些RFC規(guī)范。
RFC 1738 統(tǒng)一資源定位器(URL)
RFC 1808 相關(guān)統(tǒng)一資源定位器
RFC 1945 超文本傳輸協(xié)議--HTTP/1.0
RFC 2045 多用途Internet郵件擴(kuò)展(多用途網(wǎng)際郵件擴(kuò)充協(xié)議(MIME))第一部分:Internet信息體格式
RFC 2046 多用途Internet郵件擴(kuò)展(多用途網(wǎng)際郵件擴(kuò)充協(xié)議(MIME))第二部分:媒體類型
RFC 2047 多用途網(wǎng)際郵件擴(kuò)充協(xié)議(MIME)(多用途Internet郵件擴(kuò)展)第三部分:信息標(biāo)題擴(kuò)展用于非ASCII文本
RFC 2048 多用途Internet郵件擴(kuò)展(多用途網(wǎng)際郵件擴(kuò)充協(xié)議(MIME))第四部分: 注冊(cè)步驟
RFC 2049 多用途Internet郵件擴(kuò)展(多用途網(wǎng)際郵件擴(kuò)充協(xié)議(MIME))第五部分:一致性標(biāo)準(zhǔn)和例子
RFC 2068 超文本傳輸協(xié)議 -- HTTP/1.1
RFC 2069 一個(gè)擴(kuò)展HTTP:摘要訪問(wèn)鑒定
RFC 2109 HTTP狀態(tài)管理機(jī)制
RFC 2145 HTTP 版本號(hào)的使用和解釋
RFC 2324 超文本Coffee Pot控制協(xié)議 (HTCPCP/1.0)
萬(wàn)維網(wǎng)協(xié)會(huì)（http://www.w3.org）管理著這些協(xié)議的規(guī)范和執(zhí)行。


有關(guān)Java Servlets
JavaTM servlets是一個(gè)不受平臺(tái)約束的Java小程序，它可以被用來(lái)通過(guò)多種方法擴(kuò)充一個(gè)Web服務(wù)器的功能。你可以把Servlet理解成Server上的applets，它被編譯成字節(jié)碼，這樣它就可以被動(dòng)態(tài)地載入并用效地?cái)U(kuò)展主機(jī)的處理能力。
Servlet與applets不同的地方是，它不運(yùn)行在Web瀏覽器或其他圖形化的用戶界面上。Servlet通過(guò)servlet引擎運(yùn)行在Web服務(wù)器中，以執(zhí)行請(qǐng)求和響應(yīng)，請(qǐng)求、響應(yīng)的典型范例是HTTP協(xié)議。
一個(gè)客戶端程序，可以是一個(gè)Web瀏覽器，或者是非其他的可以連接上Internet的程序，它會(huì)訪問(wèn)Web服務(wù)器并發(fā)出請(qǐng)求。這個(gè)請(qǐng)求被運(yùn)行在Web服務(wù)器上的Servlet引擎處理，并返回響應(yīng)到Servlet。Servlet通過(guò)HTTP將這個(gè)響應(yīng)轉(zhuǎn)發(fā)到客戶端。
在功能上，Servlet與CGI、NSAPI有點(diǎn)類似，但是，與他們不同的是：Servlet具有平臺(tái)無(wú)關(guān)性。

Java Servlet概論
Servlet與其他普通的server擴(kuò)展機(jī)制有以下進(jìn)步：
因?yàn)樗�采用了不同的進(jìn)程處理模式，所以它比CGI更快。
它使用了許多Web服務(wù)器都支持的標(biāo)準(zhǔn)的API。
它繼承了Java的所有優(yōu)勢(shì)，包括易升級(jí)以及平臺(tái)無(wú)關(guān)性。
它可以調(diào)用Java所提供的大量的API的功能模塊。
這份文檔說(shuō)明了Java Servlet API的類和接口的方法。有關(guān)更多的信息，請(qǐng)參看下面的API說(shuō)明。

Servlet的生命周期
一個(gè)Java servlet具有一個(gè)生命周期，這個(gè)生命周期定義了一個(gè)Servlet如何被載入并被初始化，如何接收請(qǐng)求并作出對(duì)請(qǐng)求的響應(yīng)，如何被從服務(wù)中清除。Servlet的生命周期被javax.servlet.Servlet這個(gè)接口所定義。
所有的Java Servlet都會(huì)直接地或間接地執(zhí)行javax.servlet.Servlet接口，這樣它才能在一個(gè)Servlet引擎中運(yùn)行。Servlet引擎是Web 服務(wù)器按照J(rèn)ava Servlet API定制的擴(kuò)展。Servlet引擎提供網(wǎng)絡(luò)服務(wù)，能夠理解MIME請(qǐng)求，并提供一個(gè)運(yùn)行Servlet的容器。
javax.servlet.Servlet接口定義了在Servlet的生命周期中特定時(shí)間以及特定順序被調(diào)用的方法。

Servlet的解析和載入\r
Servlet引擎解析并載入一個(gè)Servlet，這個(gè)過(guò)程可以發(fā)生在引擎啟動(dòng)時(shí)，需要一個(gè)Servlet去響應(yīng)請(qǐng)求時(shí)，以及在此之間的任何時(shí)候。
Servlet引擎利用Java類載入工具載入一個(gè)Servlet，Servlet引擎可以從一個(gè)本地的文件系統(tǒng)、一個(gè)遠(yuǎn)程的文件系統(tǒng)以及網(wǎng)絡(luò)載入Servlet。

Servlet的初始化
Servlet引擎載入Servlet后，Servlet引擎必須對(duì)Servlet進(jìn)行初始化，在這一過(guò)程中，你可以讀取一些固定存儲(chǔ)的數(shù)據(jù)、初始化JDBC的連接以及建立與其他資源的連接。
在初始化過(guò)程中，javax.servlet.Servlet接口的init()方法提供了Servlet的初始化信息。這樣，Servlet可以對(duì)自己進(jìn)行配置。
init()方法獲得了一個(gè)Servlet配置對(duì)象（ServletConfig）。這個(gè)對(duì)象在Servlet引擎中執(zhí)行，并允許Servlet通過(guò)它獲處相關(guān)參數(shù)。這個(gè)對(duì)象使得Servlet能夠訪問(wèn)ServletContext對(duì)象。

Servlet處理請(qǐng)求\r
Servlet被初始化之后，它已經(jīng)可以處理來(lái)自客戶端的請(qǐng)求，每一個(gè)來(lái)自客戶端的請(qǐng)求都被描述成一個(gè)ServletRequest對(duì)象，Servlet的響應(yīng)被描述成一個(gè)ServletResponse對(duì)象。
當(dāng)客戶端發(fā)出請(qǐng)求時(shí)，Servlet引擎?zhèn)鬟f給Servlet一個(gè)ServletRequest對(duì)象和一個(gè)ServletResponse對(duì)象，這兩個(gè)對(duì)象作為參數(shù)傳遞到service()方法中。
Servlet也可以執(zhí)行ServletRequest接口和ServletResponse接口。ServletRequest接口使得Servlet有權(quán)使用客戶端發(fā)出的請(qǐng)求。Servlet可以通過(guò)ServletInputStream對(duì)象讀取請(qǐng)求信息。
ServletResponse接口允許Servlet建立響應(yīng)頭和狀態(tài)代碼。通過(guò)執(zhí)行這個(gè)接口，Servlet有權(quán)使用ServletOutputStream類來(lái)向客戶端返回?cái)?shù)據(jù)。

多線程和映射\r
在多線程的環(huán)境下，Servlet必須能處理許多同時(shí)發(fā)生的請(qǐng)求。例外的情況是這個(gè)Servlet執(zhí)行了SingleThreadModel接口，如果是那樣的話，Servlet只能同時(shí)處理一個(gè)請(qǐng)求。
Servlet依照Servlet引擎的映射來(lái)響應(yīng)客戶端的請(qǐng)求。一個(gè)映射對(duì)包括一個(gè)Servlet實(shí)例以及一個(gè)Servlet返回?cái)?shù)據(jù)的URL，例如：HelloServlet with /hello/index.html。
然而，一個(gè)映射可能是由一個(gè)URL和許多Servlet實(shí)例組成，例如：一個(gè)分布式的Servlet引擎可能運(yùn)行在不止一個(gè)的服務(wù)器中，這樣的話，每一個(gè)服務(wù)器中都可能有一個(gè)Servlet實(shí)例，以平衡進(jìn)程的載入。作為一個(gè)Servlet的開(kāi)發(fā)者，你不能假定一個(gè)Servlet只有一個(gè)實(shí)例。

Servlet的卸載
Servlet引擎并不必需保證一個(gè)Servlet在任何時(shí)候或在服務(wù)開(kāi)啟的任何時(shí)候都被載入。Servlet引擎可以自由的在任何時(shí)候使用或清除一個(gè)Servlet。因此，我們不能依賴一個(gè)類或?qū)嵗齺?lái)存儲(chǔ)重要的信息。
當(dāng)Servlet引擎決定卸載一個(gè)Servlet時(shí)（例如，如果這個(gè)引擎被關(guān)閉或者需要讓資源），這個(gè)引擎必須允許Servlet釋放正在使用的資源并存儲(chǔ)有關(guān)資料。為了完成以上工作，引擎會(huì)調(diào)用Servlet的destroy()方法。
在卸載一個(gè)Servlet之前，Servlet引擎必須等待所有的service()方法完成或超時(shí)結(jié)束（Servlet引擎會(huì)對(duì)超時(shí)作出定義）。當(dāng)一個(gè)Servlet被卸載時(shí)，引擎將不能給Servlet發(fā)送任何請(qǐng)求。引擎必須釋放Servlet并完成無(wú)用存儲(chǔ)單元的收集

Servlet映射技術(shù)\r
作為一個(gè)Servlet引擎的開(kāi)發(fā)者，你必須對(duì)于如何映射客戶端的請(qǐng)求到Servlet有大量的適應(yīng)性。這份說(shuō)明文檔不規(guī)定映射如何發(fā)生。但是，你必須能夠自由地運(yùn)用下面的所有技術(shù)：

映射一個(gè)Servlet到一個(gè)URL
例如，你可以指定一個(gè)特殊的Servlet它僅被來(lái)自/feedback/index.html的請(qǐng)求調(diào)用。

映射一個(gè)Servlet到以一個(gè)指定的目錄名開(kāi)始的所有URL
例如，你可以映射一個(gè)Servlet到/catalog，這樣來(lái)自/catalog/、 /catalog/garden和/catalog/housewares/index.html的請(qǐng)求都會(huì)被映射到這個(gè)Servlet。但是來(lái)自/catalogtwo 或/catalog.html的請(qǐng)求沒(méi)被映射。

映射一個(gè)Servlet到所有以一個(gè)特定的字段結(jié)尾的所有URL
例如，你可以映射一個(gè)來(lái)自于所有以in.thtml結(jié)尾的請(qǐng)求到一個(gè)特定的Servlet。

映射一個(gè)Servlet到一個(gè)特殊的URL /servlet/servlet_name。
例如，如果你建立了一個(gè)名叫l(wèi)istattributes的Servlet，你可以通過(guò)使用/servlet/listattributes來(lái)訪問(wèn)這個(gè)Servlet。

通過(guò)類名調(diào)用Servlet
例如，如果Servlet引擎接收了來(lái)自/servlet/com.foo.servlet.MailServlet的請(qǐng)求，Servlet引擎會(huì)載入這個(gè)com.foo.servlet.MailServlet類，建立實(shí)例，并通過(guò)這個(gè)Servlet來(lái)處理請(qǐng)求。

Servlet環(huán)境
ServletContext接口定義了一個(gè)Servlet環(huán)境對(duì)象，這個(gè)對(duì)象定義了一個(gè)在Servlet引擎上的Servlet的視圖。通過(guò)使用這個(gè)對(duì)象，Servlet可以記錄事件、得到資源并得到來(lái)自Servlet引擎的類（例如RequestDispatcher對(duì)象）。一個(gè)Servlet只能運(yùn)行在一個(gè)Servlet環(huán)境中，但是不同的Servlet可以在Servlet引擎上有不同的視圖。
如果Servlet引擎支持虛擬主機(jī)，每個(gè)虛擬主機(jī)有一個(gè)Servlet環(huán)境。一個(gè)Servlet環(huán)境不能在虛擬主機(jī)之間共享。
Servlet引擎能夠允許一個(gè)Servlet環(huán)境有它自己的活動(dòng)范圍。
例如，一個(gè)Servlet環(huán)境是屬于bank應(yīng)用的，它將被映射到/bank目錄下。在這種情況下，一個(gè)對(duì)getContext方法的調(diào)用會(huì)返回/bank的Servlet環(huán)境。

HTTP會(huì)話
HTTP是一個(gè)沒(méi)有狀態(tài)的協(xié)議。要建立一個(gè)有效的Web服務(wù)應(yīng)用，你必須能夠識(shí)別一個(gè)連續(xù)的來(lái)自遠(yuǎn)端的客戶機(jī)的唯一的請(qǐng)求。隨著時(shí)間的過(guò)去，發(fā)展了許多會(huì)話跟蹤的技術(shù)，但是使用起來(lái)都比較麻煩。
Java Servlet API提供了一個(gè)簡(jiǎn)單的接口，通過(guò)這個(gè)接口，Servlet引擎可以有效地跟蹤用戶的會(huì)話。

建立Session
因?yàn)镠TTP是一個(gè)請(qǐng)求-響應(yīng)協(xié)議，一個(gè)會(huì)話在客戶機(jī)加入之前會(huì)被認(rèn)為是一個(gè)新的會(huì)話。加入的意思是返回會(huì)話跟蹤信息到服務(wù)器中，指出會(huì)話已被建立。在客戶端加入之前，我們不能判斷下一個(gè)客戶端請(qǐng)求是目前會(huì)話的一部分。
在下面的情況下，Session會(huì)被認(rèn)為是新的Session。
客戶端的Session在此之前還不知道
客戶端選擇不加入Session，例如，如果客戶端拒絕接收來(lái)自服務(wù)器的cookie
作為一個(gè)Servlet的開(kāi)發(fā)者，你必須決定你的Web應(yīng)用是否處理客戶機(jī)不加入或不能加入Session。服務(wù)器會(huì)在Web服務(wù)器或Servlet規(guī)定的時(shí)間內(nèi)維持一個(gè)Session對(duì)象。當(dāng)Session終止時(shí)，服務(wù)器會(huì)釋放Session對(duì)象以及所有綁定在Session上的對(duì)象。
綁定對(duì)象到Session中
如果有助于你處理應(yīng)用的數(shù)據(jù)需求，你也許需要綁定對(duì)象到Session中，你可以通過(guò)一個(gè)唯一的名字綁定任何的對(duì)象到Session中，這時(shí)，你需要使用HttpSession對(duì)象。任何綁定到Session上的對(duì)象都可以被處理同一會(huì)話的Servlet調(diào)用。
有些對(duì)象可能需要你知道什么時(shí)候會(huì)被放置到Session中或從Session中移開(kāi)。你可以通過(guò)使用HttpSessionBindingListener接口獲得這些信息。當(dāng)你的應(yīng)用存儲(chǔ)數(shù)據(jù)到Session中，或從Session中清除數(shù)據(jù)，Servlet都會(huì)通過(guò)HttpSessionBindingListener檢杳什么類被綁定或被取消綁定。這個(gè)接口的方法會(huì)通報(bào)被綁定或被取消綁定的對(duì)象。