1   /*
    2   * Licensed to the Apache Software Foundation (ASF) under one or more
    3   * contributor license agreements.  See the NOTICE file distributed with
    4   * this work for additional information regarding copyright ownership.
    5   * The ASF licenses this file to You under the Apache License, Version 2.0
    6   * (the "License"); you may not use this file except in compliance with
    7   * the License.  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   package javax.servlet.jsp;
   19   
   20   import javax.servlet;
   21   import javax.servlet.http;
   22   import java.io.IOException;
   23   
   24   /**
   25    * The HttpJspPage interface describes the interaction that a JSP Page
   26    * Implementation Class must satisfy when using the HTTP protocol.
   27    *
   28    * <p>
   29    * The behaviour is identical to that of the JspPage, except for the signature
   30    * of the _jspService method, which is now expressible in the Java type
   31    * system and included explicitly in the interface.
   32    * 
   33    * @see JspPage
   34    */
   35   
   36   public interface HttpJspPage extends JspPage {
   37   
   38       /** The _jspService()method corresponds to the body of the JSP page. This
   39        * method is defined automatically by the JSP container and should never
   40        * be defined by the JSP page author.
   41        * <p>
   42        * If a superclass is specified using the extends attribute, that
   43        * superclass may choose to perform some actions in its service() method
   44        * before or after calling the _jspService() method.  See using the extends
   45        * attribute in the JSP_Engine chapter of the JSP specification.
   46        *
   47        * @param request Provides client request information to the JSP.
   48        * @param response Assists the JSP in sending a response to the client.
   49        * @throws ServletException Thrown if an error occurred during the 
   50        *     processing of the JSP and that the container should take 
   51        *     appropriate action to clean up the request.
   52        * @throws IOException Thrown if an error occurred while writing the
   53        *     response for this page.
   54        */
   55       public void _jspService(HttpServletRequest request,
   56                               HttpServletResponse response)
   57          throws ServletException, IOException;
   58   }