1 //
2 //  ========================================================================
3 //  Copyright (c) 1995-2014 Mort Bay Consulting Pty. Ltd.
4 //  ------------------------------------------------------------------------
5 //  All rights reserved. This program and the accompanying materials
6 //  are made available under the terms of the Eclipse Public License v1.0
7 //  and Apache License v2.0 which accompanies this distribution.
8 //
9 //      The Eclipse Public License is available at
10 //      http://www.eclipse.org/legal/epl-v10.html
11 //
12 //      The Apache License v2.0 is available at
13 //      http://www.opensource.org/licenses/apache2.0.php
14 //
15 //  You may elect to redistribute this code under either of these licenses.
16 //  ========================================================================
17 //
18 
19 
20 package org.eclipse.jetty.continuation;
21 
22 
23 /* ------------------------------------------------------------ */
24 /** ContinuationThrowable
25  * <p>
26  * A ContinuationThrowable is throw by {@link Continuation#undispatch()}
27  * in order to exit the dispatch to a Filter or Servlet.  Use of
28  * ContinuationThrowable is discouraged and it is preferable to
29  * allow return to be used. ContinuationThrowables should only be
30  * used when there is a Filter/Servlet which cannot be modified
31  * to avoid committing a response when {@link Continuation#isSuspended()}
32  * is true.
33  * </p>
34  * <p>
35  * ContinuationThrowable instances are often reused so that the
36  * stack trace may be entirely unrelated to the calling stack.
37  * A real stack trace may be obtained by enabling debug.
38  * </p>
39  * <p>
40  * ContinuationThrowable extends Error as this is more likely
41  * to be uncaught (or rethrown) by a Filter/Servlet.  A ContinuationThrowable
42  * does not represent and error condition.
43  * </p>
44  */
45 public class ContinuationThrowable extends Error
46 {}
47