01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one or more
03: * contributor license agreements. See the NOTICE file distributed with
04: * this work for additional information regarding copyright ownership.
05: * The ASF licenses this file to You under the Apache License, Version 2.0
06: * (the "License"); you may not use this file except in compliance with
07: * the License. You may obtain a copy of the License at
08: *
09: * 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: package javax.servlet.jsp;
18:
19: /**
20: * Exception to indicate the calling page must cease evaluation.
21: * Thrown by a simple tag handler to indicate that the remainder of
22: * the page must not be evaluated. The result is propagated back to
23: * the pagein the case where one tag invokes another (as can be
24: * the case with tag files). The effect is similar to that of a
25: * Classic Tag Handler returning Tag.SKIP_PAGE from doEndTag().
26: * Jsp Fragments may also throw this exception. This exception
27: * should not be thrown manually in a JSP page or tag file - the behavior is
28: * undefined. The exception is intended to be thrown inside
29: * SimpleTag handlers and in JSP fragments.
30: *
31: * @see javax.servlet.jsp.tagext.SimpleTag#doTag
32: * @see javax.servlet.jsp.tagext.JspFragment#invoke
33: * @see javax.servlet.jsp.tagext.Tag#doEndTag
34: * @since 2.0
35: */
36: public class SkipPageException extends JspException {
37: /**
38: * Creates a SkipPageException with no message.
39: */
40: public SkipPageException() {
41: super ();
42: }
43:
44: /**
45: * Creates a SkipPageException with the provided message.
46: *
47: * @param message the detail message
48: */
49: public SkipPageException(String message) {
50: super (message);
51: }
52:
53: /**
54: * Creates a SkipPageException with the provided message and root cause.
55: *
56: * @param message the detail message
57: * @param rootCause the originating cause of this exception
58: */
59: public SkipPageException(String message, Throwable rootCause) {
60: super (message, rootCause);
61: }
62:
63: /**
64: * Creates a SkipPageException with the provided root cause.
65: *
66: * @param rootCause the originating cause of this exception
67: */
68: public SkipPageException(Throwable rootCause) {
69: super(rootCause);
70: }
71:
72: }
|