Save This Page
Home » apache-tomcat-6.0.16-src » javax » servlet » [javadoc | source]
    1   /*
    2   * Licensed to the Apache Software Foundation (ASF) under one or more
    3   * contributor license agreements.  See the NOTICE file distributed with
    4   * this work for additional information regarding copyright ownership.
    5   * The ASF licenses this file to You under the Apache License, Version 2.0
    6   * (the "License"); you may not use this file except in compliance with
    7   * the License.  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   package javax.servlet;
   18   
   19   /**
   20    * Ensures that servlets handle
   21    * only one request at a time. This interface has no methods.
   22    *
   23    * <p>If a servlet implements this interface, you are <i>guaranteed</i>
   24    * that no two threads will execute concurrently in the
   25    * servlet's <code>service</code> method. The servlet container
   26    * can make this guarantee by synchronizing access to a single
   27    * instance of the servlet, or by maintaining a pool of servlet
   28    * instances and dispatching each new request to a free servlet.
   29    *
   30    * <p>Note that SingleThreadModel does not solve all thread safety
   31    * issues.  For example, session attributes and static variables can
   32    * still be accessed by multiple requests on multiple threads
   33    * at the same time, even when SingleThreadModel servlets are used.
   34    * It is recommended that a developer take other means to resolve
   35    * those issues instead of implementing this interface, such as
   36    * avoiding the usage of an instance variable or synchronizing
   37    * the block of the code accessing those resources.
   38    * This interface is deprecated in Servlet API version 2.4.
   39    *
   40    *
   41    * @author	Various
   42    * @version	$Version$
   43    *
   44    * @deprecated	As of Java Servlet API 2.4, with no direct
   45    *	replacement.
   46    */
   47   
   48   public interface SingleThreadModel {
   49   }

Save This Page
Home » apache-tomcat-6.0.16-src » javax » servlet » [javadoc | source]