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
20
21
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 }