Servlet.java
上传用户:tanyanyong
上传日期:2013-06-23
资源大小:1355k
文件大小:9k
源码类别:

电子政务应用

开发平台:

MultiPlatform

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  *
  4.  * Copyright (c) 1999 The Apache Software Foundation.  All rights 
  5.  * reserved.
  6.  *
  7.  * Redistribution and use in source and binary forms, with or without
  8.  * modification, are permitted provided that the following conditions
  9.  * are met:
  10.  *
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer. 
  13.  *
  14.  * 2. Redistributions in binary form must reproduce the above copyright
  15.  *    notice, this list of conditions and the following disclaimer in
  16.  *    the documentation and/or other materials provided with the
  17.  *    distribution.
  18.  *
  19.  * 3. The end-user documentation included with the redistribution, if
  20.  *    any, must include the following acknowlegement:  
  21.  *       "This product includes software developed by the 
  22.  *        Apache Software Foundation (http://www.apache.org/)."
  23.  *    Alternately, this acknowlegement may appear in the software itself,
  24.  *    if and wherever such third-party acknowlegements normally appear.
  25.  *
  26.  * 4. The names "The Jakarta Project", "Tomcat", and "Apache Software
  27.  *    Foundation" must not be used to endorse or promote products derived
  28.  *    from this software without prior written permission. For written 
  29.  *    permission, please contact apache@apache.org.
  30.  *
  31.  * 5. Products derived from this software may not be called "Apache"
  32.  *    nor may "Apache" appear in their names without prior written
  33.  *    permission of the Apache Group.
  34.  *
  35.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46.  * SUCH DAMAGE.
  47.  * ====================================================================
  48.  *
  49.  * This software consists of voluntary contributions made by many
  50.  * individuals on behalf of the Apache Software Foundation.  For more
  51.  * information on the Apache Software Foundation, please see
  52.  * <http://www.apache.org/>.
  53.  *
  54.  * ====================================================================
  55.  *
  56.  * This source code implements specifications defined by the Java
  57.  * Community Process. In order to remain compliant with the specification
  58.  * DO NOT add / change / or delete method signatures!
  59.  */ 
  60.  
  61. package javax.servlet;
  62. import java.io.IOException;
  63. /**
  64.  * Defines methods that all servlets must implement.
  65.  *
  66.  * <p>A servlet is a small Java program that runs within a Web server.
  67.  * Servlets receive and respond to requests from Web clients,
  68.  * usually across HTTP, the HyperText Transfer Protocol. 
  69.  *
  70.  * <p>To implement this interface, you can write a generic servlet
  71.  * that extends
  72.  * <code>javax.servlet.GenericServlet</code> or an HTTP servlet that
  73.  * extends <code>javax.servlet.http.HttpServlet</code>.
  74.  *
  75.  * <p>This interface defines methods to initialize a servlet,
  76.  * to service requests, and to remove a servlet from the server.
  77.  * These are known as life-cycle methods and are called in the
  78.  * following sequence:
  79.  * <ol>
  80.  * <li>The servlet is constructed, then initialized with the <code>init</code> method.
  81.  * <li>Any calls from clients to the <code>service</code> method are handled.
  82.  * <li>The servlet is taken out of service, then destroyed with the 
  83.  * <code>destroy</code> method, then garbage collected and finalized.
  84.  * </ol>
  85.  *
  86.  * <p>In addition to the life-cycle methods, this interface
  87.  * provides the <code>getServletConfig</code> method, which the servlet 
  88.  * can use to get any startup information, and the <code>getServletInfo</code>
  89.  * method, which allows the servlet to return basic information about itself,
  90.  * such as author, version, and copyright.
  91.  *
  92.  * @author  Various
  93.  * @version  $Version$
  94.  *
  95.  * @see  GenericServlet
  96.  * @see  javax.servlet.http.HttpServlet
  97.  *
  98.  */
  99. public interface Servlet {
  100.     /**
  101.      * Called by the servlet container to indicate to a servlet that the 
  102.      * servlet is being placed into service.
  103.      *
  104.      * <p>The servlet container calls the <code>init</code>
  105.      * method exactly once after instantiating the servlet.
  106.      * The <code>init</code> method must complete successfully
  107.      * before the servlet can receive any requests.
  108.      *
  109.      * <p>The servlet container cannot place the servlet into service
  110.      * if the <code>init</code> method
  111.      * <ol>
  112.      * <li>Throws a <code>ServletException</code>
  113.      * <li>Does not return within a time period defined by the Web server
  114.      * </ol>
  115.      *
  116.      *
  117.      * @param config a <code>ServletConfig</code> object 
  118.      * containing the servlet's
  119.      *  configuration and initialization parameters
  120.      *
  121.      * @exception ServletException  if an exception has occurred that
  122.      * interferes with the servlet's normal
  123.      * operation
  124.      *
  125.      * @see  UnavailableException
  126.      * @see  #getServletConfig
  127.      *
  128.      */
  129.     public void init(ServletConfig config) throws ServletException;
  130.     
  131.     
  132.     /**
  133.      *
  134.      * Returns a {@link ServletConfig} object, which contains
  135.      * initialization and startup parameters for this servlet.
  136.      * The <code>ServletConfig</code> object returned is the one 
  137.      * passed to the <code>init</code> method. 
  138.      *
  139.      * <p>Implementations of this interface are responsible for storing the 
  140.      * <code>ServletConfig</code> object so that this 
  141.      * method can return it. The {@link GenericServlet}
  142.      * class, which implements this interface, already does this.
  143.      *
  144.      * @return the <code>ServletConfig</code> object
  145.      * that initializes this servlet
  146.      *
  147.      * @see  #init
  148.      *
  149.      */
  150.     public ServletConfig getServletConfig();
  151.     
  152.     
  153.     /**
  154.      * Called by the servlet container to allow the servlet to respond to 
  155.      * a request.
  156.      *
  157.      * <p>This method is only called after the servlet's <code>init()</code>
  158.      * method has completed successfully.
  159.      * 
  160.      * <p>Servlets typically run inside multithreaded servlet containers
  161.      * that can handle multiple requests concurrently. Developers must 
  162.      * be aware to synchronize access to any shared resources such as files,
  163.      * network connections, and as well as the servlet's class and instance 
  164.      * variables. 
  165.      * More information on multithreaded programming in Java is available in 
  166.      * <a href="http://java.sun.com/Series/Tutorial/java/threads/multithreaded.html">
  167.      * the Java tutorial on multi-threaded programming</a>.
  168.      *
  169.      *
  170.      * @param req  the <code>ServletRequest</code> object that contains
  171.      * the client's request
  172.      *
  173.      * @param res  the <code>ServletResponse</code> object that contains
  174.      * the servlet's response
  175.      *
  176.      * @exception ServletException  if an exception occurs that interferes
  177.      * with the servlet's normal operation 
  178.      *
  179.      * @exception IOException  if an input or output exception occurs
  180.      *
  181.      */
  182.     public void service(ServletRequest req, ServletResponse res)
  183. throws ServletException, IOException;
  184.     /**
  185.      * Returns information about the servlet, such
  186.      * as author, version, and copyright.
  187.      * 
  188.      * <p>The string that this method returns should
  189.      * be plain text and not markup of any kind (such as HTML, XML,
  190.      * etc.).
  191.      *
  192.      * @return  a <code>String</code> containing servlet information
  193.      *
  194.      */
  195.     public String getServletInfo();
  196.     
  197.     
  198.     /**
  199.      *
  200.      * Called by the servlet container to indicate to a servlet that the
  201.      * servlet is being taken out of service.  This method is
  202.      * only called once all threads within the servlet's
  203.      * <code>service</code> method have exited or after a timeout
  204.      * period has passed. After the servlet container calls this 
  205.      * method, it will not call the <code>service</code> method again
  206.      * on this servlet.
  207.      *
  208.      * <p>This method gives the servlet an opportunity 
  209.      * to clean up any resources that are being held (for example, memory,
  210.      * file handles, threads) and make sure that any persistent state is
  211.      * synchronized with the servlet's current state in memory.
  212.      *
  213.      */
  214.     public void destroy();
  215. }