servlet2_2-spec 英文版

Java™ Servlet Specification, v2.2

Final Release

December 17th, 1999

James Duncan Davidson

Danny Coward

Please send all comments to

servletapi-feedback@eng.sun.com

.

Java™Servlet Specification ("Specification")

Version: 2.2

Status: Final Release

foreign patents, or pending applications. Except as provided under the following license, no part of this Specification may be

reproduced in any form by any means without the prior written authorization of Sun Microsystems, Inc. (“Sun”) and its licensors, if any.

Any use of this Specification and the information described herein will be governed by these terms and conditions and the Export

Control and General Terms as set forth in Sun's website Legal Terms. By viewing, downloading or otherwise copying this

Specification, you agree that you have read, understood, and will comply with all the terms and conditions set forth herein.

Sun hereby grants you a fully-paid, non-exclusive, non-transferable, worldwide, limited license (without the right to sublicense), under

Sun's intellectual property rights that are essential to practice this Specification, to internally practice this Specification solely for the

purpose of creating a clean room implementation of this Specification that: (i) includes a complete implementation of the current

version of this Specification, without subsetting or supersetting; (ii) implements all of the interfaces and functionality of this

Specification, as defined by Sun, without subsetting or supersetting; (iii) includes a complete implementation of any optional

separate license from Sun. This Specification contains the proprietary information of Sun and may only be used in accordance with

the license terms set forth herein. This license will terminate immediately without notice from Sun if you fail to comply with any

provision of this license. Sun may, at its sole option, terminate this license without cause upon ten (10) days notice to you. Upon

termination of this license, you must cease use of or destroy this Specification.

TRADEMARKS.

No right, title, or interest in or to any trademarks, service marks, or trade names of Sun or Sun's licensors is granted hereunder. Sun,

Sun Microsystems, the Sun logo, Java, Jini, JavaServer Pages, Enterprise JavaBeans, Java Compatible, JDK, JDBC, JavaBeans,

JavaMail, Write Once, Run Anywhere, and Java Naming and Directory Interface are trademarks or registered trademarks of Sun

Microsystems, Inc. in the U.S. and other countries.

DISCLAIMER OF WARRANTIES.

THIS SPECIFICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE

PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED INTO NEW VERSIONS

OF THE SPECIFICATION, IF ANY. SUN MAY MAKE IMPROVEMENTS AND/OR CHANGES TO THE PRODUCT(S) AND/OR THE

PROGRAM(S) DESCRIBED IN THIS SPECIFICATION AT ANY TIME. Any use of such changes in the Specification will be governed

by the then-current license for the applicable version of the Specification.

LIMITATION OF LIABILITY.

TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY DAMAGES,

INCLUDING WITHOUT LIMITATION, LOST REVENUE, PROFITS OR DATA, OR FOR SPECIAL, INDIRECT, CONSEQUENTIAL,

INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING

OUT OF OR RELATED TO ANY FURNISHING, PRACTICING, MODIFYING OR ANY USE OF THE SPECIFICATION, EVEN IF SUN

Use, duplication, or disclosure by the U.S. Government is subject to the restrictions set forth in this license and as provided in DFARS

227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii)(Oct 1988), FAR 12.212(a) (1995), FAR 52.227-19 (June

1987), or FAR 52.227-14(ALT III) (June 1987), as applicable.

You may wish to report any ambiguities, inconsistencies, or inaccuracies you may find in connection with your use of the Specification

("Feedback"). To the extent that you provide Sun with any Feedback, you hereby: (i) agree that such Feedback is provided on a non-

proprietary and non-confidential basis and (ii) grant Sun a perpetual, non-exclusive, worldwide, fully paid-up, irrevocable license, with

the right to sublicense through multiple levels of sublicensees, to incorporate, disclose, and use without limitation the Feedback for

any purpose related to the Specification and future versions, implementations, and test suites thereof.

Table Of Contents

Who Should Read This Specification 8

API Reference 8

Other Java™ Platform Specifications 8

Other Important References 8

Comparing Servlets with Other Technologies 12

Relationship to Java 2 Platform Enterprise Edition 12

Distributable Servlet Containers 12

Changes Since Version 2.1 12

Terms Used 15

Basic Terms 15

Roles 16

Security Terms 17

The Servlet Interface 19

Request Handling Methods 19

Resources 24

Multiple Hosts and Servlet Contexts 24

Reloading Considerations 24

Temporary Working Directories 25

The Request 27

Parameters 27

Attributes 27

Headers 28

Request Path Elements 28

Path Translation Methods 29

Convenience Methods 32

Internationalization 32

Closure of Response Object 33

Sessions 35

Session Tracking Mechanisms 35

Creating a Session 35

Session Scope 36

Binding Attributes into a Session 36

Session Timeouts 36

Last Accessed Times 36

Error Handling 41