1
Java™ Servlet 规范
版本 3.1(最终版)
Shing Wai Chan Rajiv Mordani [作者]
穆茂强 张开涛 [译者]
2012 年 6 月翻译
2013 年 7 月修订
Oracle 公司
www.oracle.com
3
Servlet3.1(JSR340)规范目前已经发布最终版本了,已包含在 Java EE 7 平台。 Servlet3.0(JSR 315)已经
包含在 Java EE 6 平台。具体请参考本规范网站:http://jcp.org/en/jsr/detail?id=340
前言
此文档是 Java Servlet 规范,版本:3.1。此文档描述了 Java Servlet API 标准。
其他资料
该规范制定的目的是给 Java Servlets 一个完整和清晰的解释。如果有仍有问题,可以查阅以下资料:
■ 一个参考实现(reference implementation 简称 RI)已经实现并提供了本规范的行为基准(behavioral
benchmark)。该参考实现没有对一个详细的特性实现去诠释,其他实现者可以以参考实现作为原型,以此
原型完成规范。
■ 一个兼容性测试套件(compatibility test suite 简称 CTS)用来验证实现是否兼容 Java Servlet API 标准需
求。并且测试结果为分析一个实现是不是标准实现提供了一个规范值。
■ 如果需要进一步澄清疑问,可以咨询 Java 社区进程(Java Community Process 简称 JCP)控制下的 Java
Servlet API 工作组,他们是问题的最终判定者。
非常欢迎建议和反馈,这些信息可以用来改善未来版本。
谁应该读此规范
规范的目标读者有如下几种:
■ Web Server 和 Application Server 供应商,用于开发符合此标准的 servlet 引擎。
■ 工具供应商,想要开发符合此规范的 Web 应用的支持工具。
■ 熟练的 servlet 开发者,想要弄明白 servlet 技术的底层机制。
此规范不是 servlet 开发人的用户指南,而且也并不打算被用作这样。用于此目的参考文献可以到
http://java.sun.com/products/servlet
查找。
API 规范
定义了 Java Servlet API 中类、接口、方法签名的完整规范,且附带的 Javadoc 文档有可用的在线版。
其他的 Java 平台规范
此规范参考如下其他 Java API 规范:
■ Java Platform, Enterprise Edition ("Java EE"), version 7
■ JavaServer Pages™ ("JSP™"), version 2.2
4
■ Java Naming and Directory Interface™ ("J.N.D.I.").
■ Context and Dependency Injection for the Java EE Platform
■ Managed Beans specification
这些规范可以在 Java Platform, Enterprise Edition 网站中找到:http://java.sun.com/javaee/
。
其他重要参考资料
以下 Internet 规范提供了一些有关开发和实现 Java Servlet API 和标准 servlet 引擎的信息:
■ RFC 1630 Uniform Resource Identifiers (URI)
■ RFC 1738 Uniform Resource Locators (URL)
■ RFC 2396 Uniform Resource Identifiers (URI): Generic Syntax
■ RFC 1808 Relative Uniform Resource Locators
■ RFC 1945 Hypertext Transfer Protocol (HTTP/1.0)
■ RFC 2045 MIME Part One: Format of Internet Message Bodies
■ RFC 2046 MIME Part Two: Media Types
■ RFC 2047 MIME Part Three: Message Header Extensions for non-ASCII text
■ RFC 2048 MIME Part Four: Registration Procedures
■ RFC 2049 MIME Part Five: Conformance Criteria and Examples
■ RFC 2109 HTTP State Management Mechanism
■ RFC 2145 Use and Interpretation of HTTP Version Numbers
■ RFC 2324 Hypertext Coffee Pot Control Protocol (HTCPCP/1.0)1
■ RFC 2616 Hypertext Transfer Protocol (HTTP/1.1)
■ RFC 2617 HTTP Authentication: Basic and Digest Authentication
■ RFC 3986 Uniform Resource Identifier (URI): Generic Syntax
RFC 在线版本请访问:http://wwww.ietf.org/rfc/
。
万维网联盟(http://www.w3.org/)是影响本规范和实现的 HTTP 相关来源信息的权威。
可扩展的标记语言(XML):用于此规范第 13 章描述的部署描述。更多的 XML 信息可以在以下网站找到:
http://java.sun.com/xml
http://www.xml.org/
提供反馈
我们欢迎大家提供此规范的任意和所有的反馈。请发送你的建议到 jsr-315-comments@jcp.org 邮箱。
5
请注意,由于我们收到大量的反馈意见,你可能不能正常收到来自工程师的回复。尽管如此,规范团队会
阅读、评估、存档每一个建议。
专家组成员
■ Deepak Anupalli (Pramati Technologies)
■ Euigeun Chung (TmaxSoft, Inc)
■
Ted Goddard (Icesoft Technologies Inc)
■ Robert Goff (IBM)
■ Richard Hightower
■ Seth Hodgson (Adobe Systems Inc.)
■ Remy Maucherat (RedHat)
■ Minoru Nitta (Fujitsu Limited)
■
Chang Paek (TmaxSoft, Inc)
■ Ramesh PVK (Pramati Technnologies)
■ Alex Rojkov (Caucho Technologies)
■ Mark Thomas (VMware)
■ Gregory John Wilkins
■ Wenbo Zhu (Google Inc.)
答谢
Oracle 的 Bill Shannon 为该规范提供了非常宝贵的技术投入。Oracle 的 Ron Monzillo 帮助推动了一些建议
和围绕安全方面的技术讨论。