001 /**
002 *
003 * Copyright 2003-2004 The Apache Software Foundation
004 *
005 * Licensed under the Apache License, Version 2.0 (the "License");
006 * you may not use this file except in compliance with the License.
007 * You may obtain a copy of the License at
008 *
009 * http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017
018 //
019 // This source code implements specifications defined by the Java
020 // Community Process. In order to remain compliant with the specification
021 // DO NOT add / change / or delete method signatures!
022 //
023
024 package javax.servlet;
025
026 /**
027 * Ensures that servlets handle
028 * only one request at a time. This interface has no methods.
029 *
030 * <p>If a servlet implements this interface, you are <i>guaranteed</i>
031 * that no two threads will execute concurrently in the
032 * servlet's <code>service</code> method. The servlet container
033 * can make this guarantee by synchronizing access to a single
034 * instance of the servlet, or by maintaining a pool of servlet
035 * instances and dispatching each new request to a free servlet.
036 *
037 * <p>Note that SingleThreadModel does not solve all thread safety
038 * issues. For example, session attributes and static variables can
039 * still be accessed by multiple requests on multiple threads
040 * at the same time, even when SingleThreadModel servlets are used.
041 * It is recommended that a developer take other means to resolve
042 * those issues instead of implementing this interface, such as
043 * avoiding the usage of an instance variable or synchronizing
044 * the block of the code accessing those resources.
045 * This interface is deprecated in Servlet API version 2.4.
046 *
047 * @deprecated As of Java Servlet API 2.4, with no direct
048 * replacement.
049 *
050 * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
051 */
052 public interface SingleThreadModel {
053 }