View Javadoc

1   /**
2    *
3    * Copyright 2003-2004 The Apache Software Foundation
4    *
5    *  Licensed under the Apache License, Version 2.0 (the "License");
6    *  you may not use this file except in compliance with the License.
7    *  You may obtain a copy of the License at
8    *
9    *     http://www.apache.org/licenses/LICENSE-2.0
10   *
11   *  Unless required by applicable law or agreed to in writing, software
12   *  distributed under the License is distributed on an "AS IS" BASIS,
13   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   *  See the License for the specific language governing permissions and
15   *  limitations under the License.
16   */
17  
18  //
19  // This source code implements specifications defined by the Java
20  // Community Process. In order to remain compliant with the specification
21  // DO NOT add / change / or delete method signatures!
22  //
23  
24  package javax.servlet;
25  
26  /**
27   * Ensures that servlets handle
28   * only one request at a time. This interface has no methods.
29   *
30   * <p>If a servlet implements this interface, you are <i>guaranteed</i>
31   * that no two threads will execute concurrently in the
32   * servlet's <code>service</code> method. The servlet container
33   * can make this guarantee by synchronizing access to a single
34   * instance of the servlet, or by maintaining a pool of servlet
35   * instances and dispatching each new request to a free servlet.
36   *
37   * <p>Note that SingleThreadModel does not solve all thread safety
38   * issues.  For example, session attributes and static variables can
39   * still be accessed by multiple requests on multiple threads
40   * at the same time, even when SingleThreadModel servlets are used.
41   * It is recommended that a developer take other means to resolve
42   * those issues instead of implementing this interface, such as
43   * avoiding the usage of an instance variable or synchronizing
44   * the block of the code accessing those resources.
45   * This interface is deprecated in Servlet API version 2.4.
46   *
47   * @deprecated As of Java Servlet API 2.4, with no direct
48   * replacement.
49   *
50   * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
51   */
52  public interface SingleThreadModel {
53  }