Servlet規範v2.2 翻譯 (1)

 引子:

    看Spring Security的時候,看到其比較多地使用了Servlet Listener、filter之類的東西。Filter做過,listener卻從來沒有。

    於是想從網上找一份servlet規範仔細看看,查來查去,沒有合適的中文翻譯版(v2.3有一份網友翻譯的,不過看了一下,不大合我的口味)。於是,準備自己翻譯一下,一來翻譯的過程中看得會更仔細,二來,有感於接觸過的技術人員基礎知識大多很不紮實,翻譯一下也許對大家有點幫助吧。

    從sun網站合jsr網站上,目前好找到的是v2.2, v2.3, v2.4這三份。v2.5看起來還沒有final。先從v2.2看起吧,一個個看下來,瞭解這幾個版本的發展過程,應當也會有所收穫。

        

     規範文檔容易找到,相應實現的源代碼還沒下到。瞭解從哪裏下servlet API參考實現源代碼請幫忙說一下。

     翻譯有不合適的地方,也請多提意見

 

前言<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

本文內容爲Java Servlet規範v2.2

可以從下面網址下載到響應的Java Servlet APIJavadoc文檔(v2.2)及其參考實現:

http://java.sun.com/products/servlet/index.html

上面提供的參考實現提供了一個規範實現的參考標準。如果規範、API和參考實現三者存在不一致的情況,則Servlet規範2.2 > Java Servlet API Reference 2.2 > 參考實現。

0.1. 誰應當閱讀本規範

本文檔的目標讀者爲:

l         遵循規範提供Servlet引擎的Web服務器或應用服務器提供商

l         Web應用開發工具提供商

l         需要了解servlet運行機制,以編寫複雜的servlet應用的開發人員

說明:

       本規範不是關於servlet的用戶手冊。

0.2. API參考

Java Servlet API Reference v2.2 提供了組成Servlet API的所有接口、類、例外(Exception)、方法的說明。本文檔中對各函數的參數簽名做了簡要說明。請參考API參考文檔瞭解詳細說明。

0.3. 其他的Java規範

在本規範中,將多處參考如下Java API規範:

l         Java2 Platform Enterprise Edition v1.2J2EE

l         JavaServer Pages v1.1JSP

l         JavaNaming and Direcotry InterfaceJNDI

上述規範可以從J2EE網站上找到:

http://java.sun.com/j2ee

0.4. 其他重要的參考資料

Servlet APIServlet應用的開發實現中,還參考和遵循瞭如下互聯網規範:

l         RFC 1945 Hypertext Transfer Protocol (HTTP/1.0)

l         RFC 2045 MIME Part One: Format of Internet message Bodies

l         RFC 2046 MIME Part Two: Media Types

l         RFC 2047 MIME Part Three: Message Header Extensions for non-ASCII text

l         RFC 2048 MIME Part Four: Registration Procedures

l         RFC 2049 MIME Part Five: Conformance Criteria and Examples

l         RFC 2109 <?xml:namespace prefix = st1 ns = "urn:schemas-microsoft-com:office:smarttags" />HTTPState Management Mechanism

l         RFC 2145 Use and Interpretation of HTTP Version Numbers

l         RFC 2324 Hypertext Coffee Pot Control Protocol (HTCPCP/1.0)

l         RFC 2616 Hypertext Transfer Protocol (HTTP/1.1)

l         RFC 2617 HTTP Authentication: Basic and Digest Authentication

上述RFC文檔可以下面的網站上找到:

http://www.rfc-editor.org/

W3c協會(http://www.w3.org)是HTTP相關信息的權威發佈機構

在本規範中,部署描述符使用了XMLExtensible Markup Language)。在如下網站可以找到關於XML的更多信息:

http://java.sum.com

http://www.xml.org

0.5. 提供反饋

Java社區的成功有賴於您的積極參與。我們歡迎您就本規範提出任何方面的反饋意見,請將您的意見email到:[email protected]

由於會收到大量的反饋信息,我們的工程師無法對郵件一一進行回覆。但我們將安排一個專門小組,對所有的反饋信息進行認真地閱讀、評估和存檔。

0.6. 鳴謝

感謝Anselm Baird-Smith, Elias Bayeh, Vince Bonfanti, Larry Cable, Robert Clark, Daniel Coward, Satish Dharmaraj, Jim Driscoll, Shel Finkelstein, Mark Hapner, Jason Hunter, Rod McChesney, Stefano Mazzocchi, Craig McClanahan, Adam Messinger, Ron Monzillo, Vivek Nagar, Kevin Osborn, Bob Pasker, Eduardo Pelegri-Lopart, Harish Prabandham, Bill Shannon, Jon S. Stevens, James Todd, Spike Washburn, and Alan Williamson爲本規範的改進和發展作出了巨大貢獻。感謝Connie Weiss, Jeff JacksonMala Chandra支持和推動servlet的發展提供了非凡的管理和幫助。

本規範是一項持續的、廣泛的努力的成果,包含了來自Sun及其合作伙伴的大量貢獻,尤其是如下這些公司和小組,對Servlet規範的發展作出了巨大的貢獻:Apache Developer Community, Art Technology Group, BEA Weblogic, Clear Ink, IBM, Gefion Software, Live Software, Netscape Communications, New Atlanta CommunicationsOracle

規範的檢查和修訂過程同樣是非常有價值的。我們的合作伙伴和公衆提供了很多反饋意見來幫助我們定義和改進規範。再次,謹對所有提供反饋的人和機構致意誠摯的感謝。

 

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章