Class ContextHandlerCollection

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerCollection

org.eclipse.jetty.server.handler.ContextHandlerCollection

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle

@ManagedObject("Context Handler Collection")
public class ContextHandlerCollection
extends HandlerCollection

This HandlerCollection is creates a Map of contexts to it's contained handlers based on the context path and virtual hosts of any contained ContextHandlers. 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.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	ContextHandlerCollection.Branch
private static class	ContextHandlerCollection.Mapping

Nested classes/interfaces inherited from class HandlerCollection

HandlerCollection.Handlers

Nested classes/interfaces inherited from class AbstractHandler

AbstractHandler.ErrorDispatchHandler

Nested classes/interfaces inherited from class AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface Dumpable

Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface LifeCycle

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field	Description
private Class<? extends ContextHandler>	_contextClass	Deprecated.
private final SerializedExecutor	_serializedExecutor
private static final Logger	LOG

Fields inherited from class HandlerCollection

_handlers

Fields inherited from class AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
ContextHandlerCollection()
ContextHandlerCollection(ContextHandler... contexts)

Method Summary

Modifier and Type	Method	Description
ContextHandler	addContext(String contextPath, String resourceBase)	Deprecated. Unused convenience method no longer supported.
void	deployHandler(Handler handler, Callback callback)	Thread safe deploy of a Handler.
Class<?>	getContextClass()	Deprecated. Unused convenience mechanism not used.
void	handle(String target, Request baseRequest, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)	Handle a request.
void	mapContexts()	Remap the contexts.
protected HandlerCollection.Handlers	newHandlers(Handler[] handlers)
void	setContextClass(Class<? extends ContextHandler> contextClass)	Deprecated. Unused convenience mechanism not used.
void	undeployHandler(Handler handler, Callback callback)	Thread safe undeploy of a Handler.

Methods inherited from class HandlerCollection

addHandler, destroy, expandChildren, getHandlers, prependHandler, removeHandler, setHandlers, updateHandlers

Methods inherited from class AbstractHandlerContainer

doShutdown, expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass, setServer

Methods inherited from class AbstractHandler

doError, doStart, doStop, getServer

Methods inherited from class ContainerLifeCycle

addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpObjects, dumpStdErr, dumpThis, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from class AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface Dumpable

dumpSelf

Methods inherited from interface Dumpable.DumpableContainer

isDumpable

Methods inherited from interface LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Field Details

LOG

private static final Logger LOG

_serializedExecutor

private final SerializedExecutor _serializedExecutor

_contextClass

@Deprecated
private Class<? extends ContextHandler> _contextClass

Deprecated.

Constructor Details

ContextHandlerCollection

public ContextHandlerCollection()

ContextHandlerCollection

public ContextHandlerCollection(ContextHandler... contexts)

Method Details

mapContexts

@ManagedOperation("Update the mapping of context path to context")
public void mapContexts()

Remap the contexts. Normally this is not required as context mapping is maintained as a side effect of HandlerCollection.setHandlers(Handler[]) However, if configuration changes in the deep handler structure (eg contextpath is changed), then this call will trigger a remapping. This method is mutually excluded from deployHandler(Handler, Callback) and undeployHandler(Handler, Callback)

newHandlers

protected HandlerCollection.Handlers newHandlers(Handler[] handlers)

Overrides:

newHandlers in class HandlerCollection

handle

public void handle(String target,
 Request baseRequest,
 javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response)
            throws IOException,
javax.servlet.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.

baseRequest - The original unwrapped request object.

request - The request either as the Request object or a wrapper of that request. The HttpConnection.getCurrentConnection().getHttpChannel().getRequest() 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().getHttpChannel().getResponse() method can be used access the Response object if required.

Throws:

IOException - if unable to handle the request or response processing

javax.servlet.ServletException - if unable to handle the request or response due to underlying servlet issue

addContext

@Deprecated
public ContextHandler addContext(String contextPath,
 String resourceBase)

Deprecated.

Unused convenience method no longer supported.

Adds a context handler.

Parameters:

contextPath - The context path to add

resourceBase - the base (root) Resource

Returns:

the ContextHandler just added

deployHandler

public void deployHandler(Handler handler,
 Callback callback)

Thread safe deploy of a Handler.

This method is the equivalent of HandlerCollection.addHandler(Handler), but its execution is non-block and mutually excluded from all other calls to deployHandler(Handler, Callback) and undeployHandler(Handler, Callback). The handler may be added after this call returns.

Parameters:

handler - the handler to deploy

callback - Called after handler has been added

undeployHandler

public void undeployHandler(Handler handler,
 Callback callback)

Thread safe undeploy of a Handler.

This method is the equivalent of HandlerCollection.removeHandler(Handler), but its execution is non-block and mutually excluded from all other calls to deployHandler(Handler, Callback) and undeployHandler(Handler, Callback). The handler may be removed after this call returns.

Parameters:

handler - The handler to undeploy

callback - Called after handler has been removed

getContextClass

@Deprecated
public Class<?> getContextClass()

Deprecated.

Unused convenience mechanism not used.

Returns:

The class to use to add new Contexts

setContextClass

@Deprecated
public void setContextClass(Class<? extends ContextHandler> contextClass)

Deprecated.

Unused convenience mechanism not used.

Parameters:

contextClass - The class to use to add new Contexts