001    /*
002     * Licensed to the Apache Software Foundation (ASF) under one
003     * or more contributor license agreements.  See the NOTICE file
004     * distributed with this work for additional information
005     * regarding copyright ownership.  The ASF licenses this file
006     * to you under the Apache License, Version 2.0 (the
007     * "License"); you may not use this file except in compliance
008     * with the License.  You may obtain a copy of the License at
009     *
010     *  http://www.apache.org/licenses/LICENSE-2.0
011     *
012     * Unless required by applicable law or agreed to in writing,
013     * software distributed under the License is distributed on an
014     * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015     * KIND, either express or implied.  See the License for the
016     * specific language governing permissions and limitations
017     * under the License.
018     */
019    
020    //
021    // This source code implements specifications defined by the Java
022    // Community Process. In order to remain compliant with the specification
023    // DO NOT add / change / or delete method signatures!
024    //
025    
026    package javax.servlet.jsp;
027    
028    /**
029     * Exception to indicate the calling page must cease evaluation.
030     * Thrown by a simple tag handler to indicate that the remainder of 
031     * the page must not be evaluated.  The result is propagated back to
032     * the pagein the case where one tag invokes another (as can be
033     * the case with tag files).  The effect is similar to that of a 
034     * Classic Tag Handler returning Tag.SKIP_PAGE from doEndTag().
035     * Jsp Fragments may also throw this exception.  This exception
036     * should not be thrown manually in a JSP page or tag file - the behavior is
037     * undefined.  The exception is intended to be thrown inside 
038     * SimpleTag handlers and in JSP fragments.
039     * 
040     * @see javax.servlet.jsp.tagext.SimpleTag#doTag
041     * @see javax.servlet.jsp.tagext.JspFragment#invoke
042     * @see javax.servlet.jsp.tagext.Tag#doEndTag
043     * @since 2.0
044     */
045    public class SkipPageException
046        extends JspException
047    {
048        /**
049         * Creates a SkipPageException with no message.
050         */
051        public SkipPageException() {
052            super();
053        }
054        
055        /**
056         * Creates a SkipPageException with the provided message.
057         *
058         * @param message the detail message
059         */
060        public SkipPageException( String message ) {
061            super( message );
062        }
063    
064        /**
065         * Creates a SkipPageException with the provided message and root cause.
066         *
067         * @param message the detail message
068         * @param rootCause the originating cause of this exception
069         */
070        public SkipPageException( String message, Throwable rootCause ) {
071            super( message, rootCause );
072        }
073    
074        /**
075         * Creates a SkipPageException with the provided root cause.
076         *
077         * @param rootCause the originating cause of this exception
078         */
079        public SkipPageException( Throwable rootCause ) {
080            super( rootCause );
081        }
082        
083    }
084    
085