org.eclipse.jetty.servlet

Class ServletContextHandler

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.HandlerWrapper

org.eclipse.jetty.server.handler.ScopedHandler

org.eclipse.jetty.server.handler.ContextHandler

org.eclipse.jetty.servlet.ServletContextHandler

All Implemented Interfaces:

Handler, HandlerContainer, Attributes, Container, Destroyable, Dumpable, Graceful, LifeCycle

Direct Known Subclasses:

WebAppContext

@ManagedObject(value="Servlet Context Handler")
public class ServletContextHandler
extends ContextHandler

Servlet Context.

This extension to the ContextHandler allows for simple construction of a context with ServletHandler and optionally session and security handlers, et.

   new ServletContext("/context",Context.SESSIONS|Context.NO_SECURITY);
 

This class should have been called ServletContext, but this would have cause confusion with ServletContext.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ServletContextHandler.Context
static interface	ServletContextHandler.Decorator Deprecated. use new Decorator
static class	ServletContextHandler.JspConfig
static class	ServletContextHandler.JspPropertyGroup
static interface	ServletContextHandler.ServletContainerInitializerCaller
static class	ServletContextHandler.TagLib

Nested classes/interfaces inherited from class org.eclipse.jetty.server.handler.ContextHandler

ContextHandler.AliasCheck, ContextHandler.ApproveAliases, ContextHandler.ApproveNonExistentDirectoryAliases, ContextHandler.Availability, ContextHandler.ContextScopeListener, ContextHandler.ContextStatus, ContextHandler.StaticContext

Nested classes/interfaces inherited from class org.eclipse.jetty.server.handler.AbstractHandler

AbstractHandler.ErrorDispatchHandler

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Graceful

Graceful.Shutdown

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Field Summary

Fields

Modifier and Type	Field and Description
static int	GZIP
static int	NO_SECURITY
static int	NO_SESSIONS
static int	SECURITY
static int	SESSIONS

Fields inherited from class org.eclipse.jetty.server.handler.ContextHandler

DEFAULT_LISTENER_TYPE_INDEX, DEFAULT_MAX_FORM_CONTENT_SIZE, DEFAULT_MAX_FORM_KEYS, EXTENDED_LISTENER_TYPE_INDEX, MANAGED_ATTRIBUTES, MAX_FORM_CONTENT_SIZE_KEY, MAX_FORM_KEYS_KEY, SERVLET_LISTENER_TYPES, SERVLET_MAJOR_VERSION, SERVLET_MINOR_VERSION

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor and Description
ServletContextHandler()
ServletContextHandler(HandlerContainer parent, SessionHandler sessionHandler, SecurityHandler securityHandler, ServletHandler servletHandler, ErrorHandler errorHandler)
ServletContextHandler(HandlerContainer parent, String contextPath)
ServletContextHandler(HandlerContainer parent, String contextPath, boolean sessions, boolean security)
ServletContextHandler(HandlerContainer parent, String contextPath, int options)
ServletContextHandler(HandlerContainer parent, String contextPath, SessionHandler sessionHandler, SecurityHandler securityHandler, ServletHandler servletHandler, ErrorHandler errorHandler)
ServletContextHandler(HandlerContainer parent, String contextPath, SessionHandler sessionHandler, SecurityHandler securityHandler, ServletHandler servletHandler, ErrorHandler errorHandler, int options)
ServletContextHandler(int options)

Method Summary

Modifier and Type	Method and Description
void	addDecorator(ServletContextHandler.Decorator decorator) Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead
void	addEventListener(EventListener listener) Add EventListener Adds an EventListener to the list.
FilterHolder	addFilter(Class<? extends Filter> filterClass, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter
void	addFilter(FilterHolder holder, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter
FilterHolder	addFilter(String filterClass, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter
ServletHolder	addServlet(Class<? extends Servlet> servlet, String pathSpec) Convenience method to add a servlet.
void	addServlet(ServletHolder servlet, String pathSpec) Convenience method to add a servlet.
ServletHolder	addServlet(String className, String pathSpec) Convenience method to add a servlet.
void	callContextDestroyed(ServletContextListener l, ServletContextEvent e)
void	callContextInitialized(ServletContextListener l, ServletContextEvent e)
List<ServletContextHandler.Decorator>	getDecorators() Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead
Class<? extends SecurityHandler>	getDefaultSecurityHandlerClass() Get the defaultSecurityHandlerClass.
GzipHandler	getGzipHandler()
DecoratedObjectFactory	getObjectFactory() The DecoratedObjectFactory for use by IoC containers (weld / spring / etc)
SecurityHandler	getSecurityHandler()
static ServletContextHandler	getServletContextHandler(ServletContext context)
ServletHandler	getServletHandler()
SessionHandler	getSessionHandler()
void	insertHandler(HandlerWrapper handler) Insert a HandlerWrapper before the first Session,Security or ServletHandler but after any other HandlerWrappers.
void	setDecorators(List<ServletContextHandler.Decorator> decorators) Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead
void	setDefaultSecurityHandlerClass(Class<? extends SecurityHandler> defaultSecurityHandlerClass) Set the defaultSecurityHandlerClass.
void	setGzipHandler(GzipHandler gzipHandler)
void	setHandler(Handler handler)
void	setSecurityHandler(SecurityHandler securityHandler)
void	setServletHandler(ServletHandler servletHandler)
Set<String>	setServletSecurity(ServletRegistration.Dynamic registration, ServletSecurityElement servletSecurityElement) Delegate for ServletRegistration.Dynamic.setServletSecurity method
void	setSessionHandler(SessionHandler sessionHandler)

Methods inherited from class org.eclipse.jetty.server.handler.ContextHandler

addAliasCheck, addLocaleEncoding, addVirtualHosts, checkAlias, checkContext, checkContextPath, checkVirtualHost, clearAliasChecks, clearAttributes, contextDestroyed, contextInitialized, doHandle, doScope, dump, getAliasChecks, getAllowNullPathInfo, getAttribute, getAttributeNames, getAttributes, getBaseResource, getClassLoader, getClassPath, getContextHandler, getContextPath, getContextPathEncoded, getCurrentContext, getDisplayName, getErrorHandler, getEventListeners, getInitParameter, getInitParameterNames, getInitParams, getLocaleEncoding, getLocaleEncoding, getLocaleEncodings, getLogger, getMaxFormContentSize, getMaxFormKeys, getMimeTypes, getProtectedTargets, getResource, getResourceBase, getResourcePaths, getServerInfo, getServletContext, getVirtualHosts, getWelcomeFiles, handle, handle, isAvailable, isCompactPath, isDurableListener, isProgrammaticListener, isProtectedTarget, isShutdown, isUsingSecurityManager, loadClass, newResource, newResource, newResource, removeAttribute, removeEventListener, removeVirtualHosts, setAliasChecks, setAllowNullPathInfo, setAttribute, setAttributes, setAvailable, setBaseResource, setClassLoader, setCompactPath, setContextPath, setDisplayName, setErrorHandler, setEventListeners, setInitParameter, setLogger, setManagedAttribute, setMaxFormContentSize, setMaxFormKeys, setMimeTypes, setProtectedTargets, setResourceBase, setServer, setServerInfo, setUsingSecurityManager, setVirtualHosts, setWelcomeFiles, shutdown, toString

Methods inherited from class org.eclipse.jetty.server.handler.ScopedHandler

handle, nextHandle, nextScope

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, getHandler, getHandlers

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

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

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

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

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

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

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dumpContainer, dumpIterable, dumpMapEntries, dumpObjects, dumpSelf, named

Field Detail

SESSIONS

public static final int SESSIONS

See Also:

Constant Field Values

SECURITY

public static final int SECURITY

See Also:

Constant Field Values

GZIP

public static final int GZIP

See Also:

Constant Field Values

NO_SESSIONS

public static final int NO_SESSIONS

See Also:

Constant Field Values

NO_SECURITY

public static final int NO_SECURITY

See Also:

Constant Field Values

Constructor Detail

ServletContextHandler

public ServletContextHandler()

ServletContextHandler

public ServletContextHandler(int options)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             String contextPath)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             String contextPath,
                             int options)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             String contextPath,
                             boolean sessions,
                             boolean security)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             SessionHandler sessionHandler,
                             SecurityHandler securityHandler,
                             ServletHandler servletHandler,
                             ErrorHandler errorHandler)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             String contextPath,
                             SessionHandler sessionHandler,
                             SecurityHandler securityHandler,
                             ServletHandler servletHandler,
                             ErrorHandler errorHandler)

ServletContextHandler

public ServletContextHandler(HandlerContainer parent,
                             String contextPath,
                             SessionHandler sessionHandler,
                             SecurityHandler securityHandler,
                             ServletHandler servletHandler,
                             ErrorHandler errorHandler,
                             int options)

Method Detail

addEventListener

public void addEventListener(EventListener listener)

Add EventListener Adds an EventListener to the list. @see org.eclipse.jetty.server.handler.ContextHandler#addEventListener(). Also adds any listeners that are session related to the SessionHandler.

Overrides:

addEventListener in class ContextHandler

Parameters:

listener - the listener to add

See Also:

ServletContextListener, ServletContextAttributeListener, ServletRequestListener, ServletRequestAttributeListener

setHandler

public void setHandler(Handler handler)

Overrides:

setHandler in class HandlerWrapper

Parameters:

handler - Set the Handler which should be wrapped.

getDefaultSecurityHandlerClass

public Class<? extends SecurityHandler> getDefaultSecurityHandlerClass()

Get the defaultSecurityHandlerClass.

Returns:

the defaultSecurityHandlerClass

setDefaultSecurityHandlerClass

public void setDefaultSecurityHandlerClass(Class<? extends SecurityHandler> defaultSecurityHandlerClass)

Set the defaultSecurityHandlerClass.

Parameters:

defaultSecurityHandlerClass - the defaultSecurityHandlerClass to set

getSecurityHandler

@ManagedAttribute(value="context security handler",
                  readonly=true)
public SecurityHandler getSecurityHandler()

Returns:

Returns the securityHandler.

getServletHandler

@ManagedAttribute(value="context servlet handler",
                  readonly=true)
public ServletHandler getServletHandler()

Returns:

Returns the servletHandler.

getSessionHandler

@ManagedAttribute(value="context session handler",
                  readonly=true)
public SessionHandler getSessionHandler()

Returns:

Returns the sessionHandler.

getGzipHandler

@ManagedAttribute(value="context gzip handler",
                  readonly=true)
public GzipHandler getGzipHandler()

Returns:

Returns the gzipHandler.

addServlet

public ServletHolder addServlet(String className,
                                String pathSpec)

Convenience method to add a servlet.

Parameters:

className - the servlet class name

pathSpec - the path spec to map servlet to

Returns:

the ServletHolder for the added servlet

addServlet

public ServletHolder addServlet(Class<? extends Servlet> servlet,
                                String pathSpec)

Convenience method to add a servlet.

Parameters:

servlet - the servlet class

pathSpec - the path spec to map servlet to

Returns:

the ServletHolder for the added servlet

addServlet

public void addServlet(ServletHolder servlet,
                       String pathSpec)

Convenience method to add a servlet.

Parameters:

servlet - the servlet holder

pathSpec - the path spec

addFilter

public void addFilter(FilterHolder holder,
                      String pathSpec,
                      EnumSet<DispatcherType> dispatches)

Convenience method to add a filter

Parameters:

holder - the filter holder

pathSpec - the path spec

dispatches - the dispatcher types for this filter

addFilter

public FilterHolder addFilter(Class<? extends Filter> filterClass,
                              String pathSpec,
                              EnumSet<DispatcherType> dispatches)

Convenience method to add a filter

Parameters:

filterClass - the filter class

pathSpec - the path spec

dispatches - the dispatcher types for this filter

Returns:

the FilterHolder that was created

addFilter

public FilterHolder addFilter(String filterClass,
                              String pathSpec,
                              EnumSet<DispatcherType> dispatches)

Convenience method to add a filter

Parameters:

filterClass - the filter class name

pathSpec - the path spec

dispatches - the dispatcher types for this filter

Returns:

the FilterHolder that was created

setServletSecurity

public Set<String> setServletSecurity(ServletRegistration.Dynamic registration,
                                      ServletSecurityElement servletSecurityElement)

Delegate for ServletRegistration.Dynamic.setServletSecurity method

Parameters:

registration - ServletRegistration.Dynamic instance that setServletSecurity was called on

servletSecurityElement - new security info

Returns:

the set of exact URL mappings currently associated with the registration that are also present in the web.xml security constraints and thus will be unaffected by this call.

callContextInitialized

public void callContextInitialized(ServletContextListener l,
                                   ServletContextEvent e)

callContextDestroyed

public void callContextDestroyed(ServletContextListener l,
                                 ServletContextEvent e)

setSessionHandler

public void setSessionHandler(SessionHandler sessionHandler)

Parameters:

sessionHandler - The sessionHandler to set.

setSecurityHandler

public void setSecurityHandler(SecurityHandler securityHandler)

Parameters:

securityHandler - The SecurityHandler to set on this context.

setGzipHandler

public void setGzipHandler(GzipHandler gzipHandler)

Parameters:

gzipHandler - The GzipHandler to set on this context.

setServletHandler

public void setServletHandler(ServletHandler servletHandler)

Parameters:

servletHandler - The servletHandler to set.

insertHandler

public void insertHandler(HandlerWrapper handler)

Insert a HandlerWrapper before the first Session,Security or ServletHandler but after any other HandlerWrappers.

Overrides:

insertHandler in class HandlerWrapper

Parameters:

handler - the wrapper to insert

getObjectFactory

public DecoratedObjectFactory getObjectFactory()

The DecoratedObjectFactory for use by IoC containers (weld / spring / etc)

Returns:

The DecoratedObjectFactory

getDecorators

@Deprecated
public List<ServletContextHandler.Decorator> getDecorators()

Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead

Returns:

The decorator list used to resource inject new Filters, Servlets and EventListeners

setDecorators

@Deprecated
public void setDecorators(List<ServletContextHandler.Decorator> decorators)

Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead

Parameters:

decorators - The list of ServletContextHandler.Decorators

addDecorator

@Deprecated
public void addDecorator(ServletContextHandler.Decorator decorator)

Deprecated. use the DecoratedObjectFactory from getAttribute("org.eclipse.jetty.util.DecoratedObjectFactory") or getObjectFactory() instead

Parameters:

decorator - The decorator to add

getServletContextHandler

public static ServletContextHandler getServletContextHandler(ServletContext context)