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