Save This Page
Home » glassfish-v2ur2-b04-src » javax » servlet » jsp » [javadoc | source]
    1   /*
    2    * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
    3    * 
    4    * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
    5    * 
    6    * Portions Copyright Apache Software Foundation.
    7    * 
    8    * The contents of this file are subject to the terms of either the GNU
    9    * General Public License Version 2 only ("GPL") or the Common Development
   10    * and Distribution License("CDDL") (collectively, the "License").  You
   11    * may not use this file except in compliance with the License. You can obtain
   12    * a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
   13    * or glassfish/bootstrap/legal/LICENSE.txt.  See the License for the specific
   14    * language governing permissions and limitations under the License.
   15    * 
   16    * When distributing the software, include this License Header Notice in each
   17    * file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
   18    * Sun designates this particular file as subject to the "Classpath" exception
   19    * as provided by Sun in the GPL Version 2 section of the License file that
   20    * accompanied this code.  If applicable, add the following below the License
   21    * Header, with the fields enclosed by brackets [] replaced by your own
   22    * identifying information: "Portions Copyrighted [year]
   23    * [name of copyright owner]"
   24    * 
   25    * Contributor(s):
   26    * 
   27    * If you wish your version of this file to be governed by only the CDDL or
   28    * only the GPL Version 2, indicate your decision by adding "[Contributor]
   29    * elects to include this software in this distribution under the [CDDL or GPL
   30    * Version 2] license."  If you don't indicate a single choice of license, a
   31    * recipient has the option to distribute your version of this file under
   32    * either the CDDL, the GPL Version 2 or to extend the choice of license to
   33    * its licensees as provided above.  However, if you add GPL Version 2 code
   34    * and therefore, elected the GPL Version 2 license, then the option applies
   35    * only if the new code is made subject to such option by the copyright
   36    * holder.
   37    */
   38    
   39   package javax.servlet.jsp;
   40   
   41   import javax.servlet;
   42   import javax.servlet.http;
   43   import java.io.IOException;
   44   
   45   /**
   46    * The HttpJspPage interface describes the interaction that a JSP Page
   47    * Implementation Class must satisfy when using the HTTP protocol.
   48    *
   49    * <p>
   50    * The behaviour is identical to that of the JspPage, except for the signature
   51    * of the _jspService method, which is now expressible in the Java type
   52    * system and included explicitly in the interface.
   53    * 
   54    * @see JspPage
   55    */
   56   
   57   public interface HttpJspPage extends JspPage {
   58   
   59       /** The _jspService()method corresponds to the body of the JSP page. This
   60        * method is defined automatically by the JSP container and should never
   61        * be defined by the JSP page author.
   62        * <p>
   63        * If a superclass is specified using the extends attribute, that
   64        * superclass may choose to perform some actions in its service() method
   65        * before or after calling the _jspService() method.  See using the extends
   66        * attribute in the JSP_Engine chapter of the JSP specification.
   67        *
   68        * @param request Provides client request information to the JSP.
   69        * @param response Assists the JSP in sending a response to the client.
   70        * @throws ServletException Thrown if an error occurred during the 
   71        *     processing of the JSP and that the container should take 
   72        *     appropriate action to clean up the request.
   73        * @throws IOException Thrown if an error occurred while writing the
   74        *     response for this page.
   75        */
   76       public void _jspService(HttpServletRequest request,
   77                               HttpServletResponse response)
   78          throws ServletException, IOException;
   79   }

Save This Page
Home » glassfish-v2ur2-b04-src » javax » servlet » jsp » [javadoc | source]