Fixing javadoc

This commit is contained in:
Joakim Erdfelt 2013-10-23 16:59:30 -07:00
parent 275008d207
commit ebf11ebfb8
1 changed files with 12 additions and 7 deletions

View File

@ -31,15 +31,18 @@ import org.eclipse.jetty.server.Request;
/** ScopedHandler. /** ScopedHandler.
* *
* A ScopedHandler is a HandlerWrapper where the wrapped handlers * A ScopedHandler is a HandlerWrapper where the wrapped handlers
* each define a scope. When {@link #handle(String, Request, HttpServletRequest, HttpServletResponse)} * each define a scope.
*
* <p>When {@link #handle(String, Request, HttpServletRequest, HttpServletResponse)}
* is called on the first ScopedHandler in a chain of HandlerWrappers, * is called on the first ScopedHandler in a chain of HandlerWrappers,
* the {@link #doScope(String, Request, HttpServletRequest, HttpServletResponse)} method is * the {@link #doScope(String, Request, HttpServletRequest, HttpServletResponse)} method is
* called on all contained ScopedHandlers, before the * called on all contained ScopedHandlers, before the
* {@link #doHandle(String, Request, HttpServletRequest, HttpServletResponse)} method * {@link #doHandle(String, Request, HttpServletRequest, HttpServletResponse)} method
* is called on all contained handlers. * is called on all contained handlers.</p>
* *
* <p>For example if Scoped handlers A, B & C were chained together, then * <p>For example if Scoped handlers A, B & C were chained together, then
* the calling order would be:<pre> * the calling order would be:</p>
* <pre>
* A.handle(...) * A.handle(...)
* A.doScope(...) * A.doScope(...)
* B.doScope(...) * B.doScope(...)
@ -47,10 +50,11 @@ import org.eclipse.jetty.server.Request;
* A.doHandle(...) * A.doHandle(...)
* B.doHandle(...) * B.doHandle(...)
* C.doHandle(...) * C.doHandle(...)
* <pre> * </pre>
* *
* <p>If non scoped handler X was in the chained A, B, X & C, then * <p>If non scoped handler X was in the chained A, B, X & C, then
* the calling order would be:<pre> * the calling order would be:</p>
* <pre>
* A.handle(...) * A.handle(...)
* A.doScope(...) * A.doScope(...)
* B.doScope(...) * B.doScope(...)
@ -60,9 +64,10 @@ import org.eclipse.jetty.server.Request;
* X.handle(...) * X.handle(...)
* C.handle(...) * C.handle(...)
* C.doHandle(...) * C.doHandle(...)
* <pre> * </pre>
* *
* <p>A typical usage pattern is:<pre> * <p>A typical usage pattern is:</p>
* <pre>
* private static class MyHandler extends ScopedHandler * private static class MyHandler extends ScopedHandler
* { * {
* public void doScope(String target, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException * public void doScope(String target, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException