1 //
2 // ========================================================================
3 // Copyright (c) 1995-2016 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 {}