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 }