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参考实现源代码请帮忙说一下。

     翻译有不合适的地方，也请多提意见

 

前言

本文内容为Java Servlet规范v2.2。

可以从下面网址下载到响应的Java Servlet API的Javadoc文档（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.2（J2EE）

l         JavaServer Pages v1.1（JSP）

l         JavaNaming and Direcotry Interface（JNDI）

上述规范可以从J2EE网站上找到：

http://java.sun.com/j2ee

0.4. 其他重要的参考资料

在Servlet API和Servlet应用的开发实现中，还参考和遵循了如下互联网规范：

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 HTTP State 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相关信息的权威发布机构

在本规范中，部署描述符使用了XML（Extensible Markup Language）。在如下网站可以找到关于XML的更多信息：

http://java.sum.com

http://www.xml.org

0.5. 提供反馈

Java社区的成功有赖于您的积极参与。我们欢迎您就本规范提出任何方面的反馈意见，请将您的意见email到：[e-mail]

由于会收到大量的反馈信息，我们的工程师无法对邮件一一进行回复。但我们将安排一个专门小组，对所有的反馈信息进行认真地阅读、评估和存档。

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 Jackson和Mala Chandra支持和推动servlet的发展提供了非凡的管理和帮助。

本规范是一项持续的、广泛的努力的成果，包含了来自Sun及其合作伙伴的大量贡献，尤其是如下这些公司和小组，对Servlet规范的发展作出了巨大的贡献：Apache Developer Community, Art Technology Group, BEA Weblogic, Clear Ink, IBM, Gefion Software, Live Software, Netscape Communications, New Atlanta Communications和Oracle。

规范的检查和修订过程同样是非常有价值的。我们的合作伙伴和公众提供了很多反馈意见来帮助我们定义和改进规范。再次，谨对所有提供反馈的人和机构致意诚挚的感谢。