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.jsp;
025    
026    import javax.servlet.*;
027    import javax.servlet.http.*;
028    import java.io.IOException;
029    
030    /**
031     * The HttpJspPage interface describes the interaction that a JSP Page
032     * Implementation Class must satisfy when using the HTTP protocol.
033     *
034     * <p>
035     * The behaviour is identical to that of the JspPage, except for the signature
036     * of the _jspService method, which is now expressible in the Java type
037     * system and included explicitly in the interface.
038     * 
039     * @see JspPage
040     */
041    
042    public interface HttpJspPage extends JspPage {
043    
044        /** The _jspService()method corresponds to the body of the JSP page. This
045         * method is defined automatically by the JSP container and should never
046         * be defined by the JSP page author.
047         * <p>
048         * If a superclass is specified using the extends attribute, that
049         * superclass may choose to perform some actions in its service() method
050         * before or after calling the _jspService() method.  See using the extends
051         * attribute in the JSP_Engine chapter of the JSP specification.
052         *
053         * @param request Provides client request information to the JSP.
054         * @param response Assists the JSP in sending a response to the client.
055         * @throws ServletException Thrown if an error occurred during the 
056         *     processing of the JSP and that the container should take 
057         *     appropriate action to clean up the request.
058         * @throws IOException Thrown if an error occurred while writing the
059         *     response for this page.
060         */
061        public void _jspService(HttpServletRequest request,
062                                HttpServletResponse response)
063           throws ServletException, IOException;
064    }