From ebf11ebfb8569c1e531fad43547b8dc8fd525a03 Mon Sep 17 00:00:00 2001 From: Joakim Erdfelt Date: Wed, 23 Oct 2013 16:59:30 -0700 Subject: [PATCH] Fixing javadoc --- .../jetty/server/handler/ScopedHandler.java | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/jetty-server/src/main/java/org/eclipse/jetty/server/handler/ScopedHandler.java b/jetty-server/src/main/java/org/eclipse/jetty/server/handler/ScopedHandler.java index 45e3d166419..bba4ddf0f80 100644 --- a/jetty-server/src/main/java/org/eclipse/jetty/server/handler/ScopedHandler.java +++ b/jetty-server/src/main/java/org/eclipse/jetty/server/handler/ScopedHandler.java @@ -31,15 +31,18 @@ import org.eclipse.jetty.server.Request; /** ScopedHandler. * * A ScopedHandler is a HandlerWrapper where the wrapped handlers - * each define a scope. When {@link #handle(String, Request, HttpServletRequest, HttpServletResponse)} + * each define a scope. + * + *

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