## org.mortbay.jetty.handler
Class ContextHandlerCollection

    java.lang.Object
      org.mortbay.component.AbstractLifeCycle
          org.mortbay.jetty.handler.AbstractHandler
              org.mortbay.jetty.handler.AbstractHandlerContainer
                  org.mortbay.jetty.handler.HandlerCollection
                      org.mortbay.jetty.handler.ContextHandlerCollection

All Implemented Interfaces:
  LifeCycle, Handler, HandlerContainer

    public class ContextHandlerCollection

extends HandlerCollection

ContextHandlerCollection. This `HandlerCollection` is creates a `PathMap` to it's contained handlers based on the context path and virtual hosts of any contained `ContextHandler`s. The contexts do not need to be directly contained, only children of the contained handlers. Multiple contexts may have the same context path and they are called in order until one handles the request.

Field Summary

Fields inherited from class org.mortbay.jetty.handler.AbstractHandler
`_string`

Fields inherited from interface org.mortbay.jetty.Handler
`ALL, DEFAULT, ERROR, FORWARD, INCLUDE, REQUEST`

Constructor Summary
`ContextHandlerCollection()`

Method Summary
`ContextHandler` `addContext(String contextPath, String resourceBase)` Add a context handler.
`protected void` `doStart()`
`Class` `getContextClass()`
`void` `handle(String target, HttpServletRequest request, HttpServletResponse response, int dispatch)` Handle a request.
`void` `mapContexts()` Remap the context paths.
`void` `setContextClass(Class contextClass)`
`void` `setHandlers(Handler[] handlers)`

Methods inherited from class org.mortbay.jetty.handler.HandlerCollection
`addHandler, doStop, expandChildren, getHandlers, removeHandler, setServer`

Methods inherited from class org.mortbay.jetty.handler.AbstractHandlerContainer
`expandHandler, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass`

Methods inherited from class org.mortbay.jetty.handler.AbstractHandler
`destroy, getServer, toString`

Methods inherited from class org.mortbay.component.AbstractLifeCycle
`isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, start, stop`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Methods inherited from interface org.mortbay.component.LifeCycle
`isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, start, stop`

Constructor Detail

### ContextHandlerCollection

    public ContextHandlerCollection()

Method Detail

### mapContexts

    public void mapContexts()

  Remap the context paths.

### setHandlers

    public void setHandlers(Handler[] handlers)

  Overrides:
    `setHandlers` in class `HandlerCollection`
  Parameters:
    `handlers` - The handlers to set.

### doStart

    protected void doStart()
                    throws Exception

  Overrides:
    `doStart` in class `HandlerCollection`
  Throws:
    `Exception`

### handle

    public void handle(String target,
                       HttpServletRequest request,
                       HttpServletResponse response,
                       int dispatch)
                throws IOException,
                       ServletException

  Description copied from interface: `Handler`
  Handle a request.

  Specified by:
    `handle` in interface `Handler`
  Overrides:
    `handle` in class `HandlerCollection`
  Parameters:
    `target` - The target of the request - either a URI or a name.
    `request` - The request either as the `Request` object or a wrapper of that request. The `HttpConnection.getCurrentConnection()` method can be used access the Request object if required.
    `response` - The response as the `Response` object or a wrapper of that request. The `HttpConnection.getCurrentConnection()` method can be used access the Response object if required.
    `dispatch` - The dispatch mode: `Handler.REQUEST`, `Handler.FORWARD`, `Handler.INCLUDE`, `Handler.ERROR`
  Throws:
    `IOException`
    `ServletException`

### addContext

    public ContextHandler addContext(String contextPath,
                                     String resourceBase)

  Add a context handler.

  Parameters:
    `contextPath` - The context path to add
  Returns:
  Throws:
    `IllegalAccessException`
    `InstantiationException`

### getContextClass

    public Class getContextClass()

  Returns:
    The class to use to add new Contexts

### setContextClass

    public void setContextClass(Class contextClass)

  Parameters:
    `contextClass` - The class to use to add new Contexts

Copyright © 2007 Mort Bay Consulting. All Rights Reserved.