/*
 * Copyright (c) 1997, 2020 Oracle and/or its affiliates and others.
 * All rights reserved.
 * Copyright 2004 The Apache Software Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package jakarta.servlet.jsp;

import jakarta.servlet.http.*;
import java.io.IOException;
import jakarta.servlet.ServletException;

/**
 * The HttpJspPage interface describes the interaction that a JSP Page Implementation Class must satisfy when using the
 * HTTP protocol.
 *
 * <p>
 * The behaviour is identical to that of the JspPage, except for the signature of the _jspService method, which is now
 * expressible in the Java type system and included explicitly in the interface.
 * 
 * @see JspPage
 */
public interface HttpJspPage extends JspPage {

    /**
     * The _jspService()method corresponds to the body of the JSP page. This method is defined automatically by the JSP
     * container and should never be defined by the JSP page author.
     * <p>
     * If a superclass is specified using the extends attribute, that superclass may choose to perform some actions in
     * its service() method before or after calling the _jspService() method. See using the extends attribute in the
     * JSP_Engine chapter of the JSP specification.
     *
     * @param request  Provides client request information to the JSP.
     * @param response Assists the JSP in sending a response to the client.
     * @throws ServletException Thrown if an error occurred during the processing of the JSP and that the container
     *                          should take appropriate action to clean up the request.
     * @throws IOException      Thrown if an error occurred while writing the response for this page.
     */
    public void _jspService(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException;
}
