View Javadoc

    1
    2
    3   /*
    4    * The contents of this file are subject to the terms
    5    * of the Common Development and Distribution License
    6    * (the "License").  You may not use this file except
    7    * in compliance with the License.
    8    *
    9    * You can obtain a copy of the license at
    10   * glassfish/bootstrap/legal/CDDLv1.0.txt or
    11   * https://glassfish.dev.java.net/public/CDDLv1.0.html.
    12   * See the License for the specific language governing
    13   * permissions and limitations under the License.
    14   *
    15   * When distributing Covered Code, include this CDDL
    16   * HEADER in each file and include the License file at
    17   * glassfish/bootstrap/legal/CDDLv1.0.txt.  If applicable,
    18   * add the following below this CDDL HEADER, with the
    19   * fields enclosed by brackets "[]" replaced with your
    20   * own identifying information: Portions Copyright [yyyy]
    21   * [name of copyright owner]
    22   *
    23   * Copyright 2005 Sun Microsystems, Inc. All rights reserved.
    24   *
    25   * Portions Copyright Apache Software Foundation.
    26   */
    27
    28  package javax.servlet;
    29
    30  /**
    31   * Ensures that servlets handle
    32   * only one request at a time. This interface has no methods.
    33   *
    34   * <p>If a servlet implements this interface, you are <i>guaranteed</i>
    35   * that no two threads will execute concurrently in the
    36   * servlet's <code>service</code> method. The servlet container
    37   * can make this guarantee by synchronizing access to a single
    38   * instance of the servlet, or by maintaining a pool of servlet
    39   * instances and dispatching each new request to a free servlet.
    40   *
    41   * <p>Note that SingleThreadModel does not solve all thread safety
    42   * issues.  For example, session attributes and static variables can
    43   * still be accessed by multiple requests on multiple threads
    44   * at the same time, even when SingleThreadModel servlets are used.
    45   * It is recommended that a developer take other means to resolve
    46   * those issues instead of implementing this interface, such as
    47   * avoiding the usage of an instance variable or synchronizing
    48   * the block of the code accessing those resources.
    49   * This interface is deprecated in Servlet API version 2.4.
    50   *
    51   *
    52   * @author	Various
    53   *
    54   * @deprecated	As of Java Servlet API 2.4, with no direct
    55   *	replacement.
    56   */
    57
    58  public interface SingleThreadModel {
    59  }