From ebf11ebfb8569c1e531fad43547b8dc8fd525a03 Mon Sep 17 00:00:00 2001
From: Joakim Erdfelt When {@link #handle(String, Request, HttpServletRequest, HttpServletResponse)}
* is called on the first ScopedHandler in a chain of HandlerWrappers,
* the {@link #doScope(String, Request, HttpServletRequest, HttpServletResponse)} method is
* called on all contained ScopedHandlers, before the
* {@link #doHandle(String, Request, HttpServletRequest, HttpServletResponse)} method
- * is called on all contained handlers.
+ * is called on all contained handlers. For example if Scoped handlers A, B & C were chained together, then
- * the calling order would be:
+ * the calling order would be:
* A.handle(...) * A.doScope(...) * B.doScope(...) @@ -47,10 +50,11 @@ import org.eclipse.jetty.server.Request; * A.doHandle(...) * B.doHandle(...) * C.doHandle(...) - *+ ** *If non scoped handler X was in the chained A, B, X & C, then - * the calling order would be:
+ * the calling order would be: + ** A.handle(...) * A.doScope(...) * B.doScope(...) @@ -60,9 +64,10 @@ import org.eclipse.jetty.server.Request; * X.handle(...) * C.handle(...) * C.doHandle(...) - *+ ** - *A typical usage pattern is:
+ *A typical usage pattern is:
+ ** private static class MyHandler extends ScopedHandler * { * public void doScope(String target, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException