org.eclipse.jetty.servlet

Class ServletHandler

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.servlet.ServletHandler

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, LifeCycle

Direct Known Subclasses:

AntWebAppContext.AntServletHandler

@ManagedObject(value="Servlet Handler")
public class ServletHandler
extends ScopedHandler

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServletHandler.Default404Servlet

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.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 String	__DEFAULT_SERVLET
protected ConcurrentMap<String,FilterChain>[]	_chainCache
protected Queue<String>[]	_chainLRU

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

_nextScope, _outerScope

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

_handler

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

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
ServletHandler() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addFilter(FilterHolder filter) Convenience method to add a preconstructed FilterHolder
void	addFilter(FilterHolder filter, FilterMapping filterMapping) convenience method to add a filter and mapping
FilterHolder	addFilter(String className, String pathSpec, EnumSet<DispatcherType> dispatches) Deprecated. use addFilterWithMapping(Class, String, EnumSet) instead
void	addFilterMapping(FilterMapping mapping) Convenience method to add a preconstructed FilterMapping
FilterHolder	addFilterWithMapping(Class<? extends Filter> filter, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter.
FilterHolder	addFilterWithMapping(Class<? extends Filter> filter, String pathSpec, int dispatches) Convenience method to add a filter.
void	addFilterWithMapping(FilterHolder holder, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter.
void	addFilterWithMapping(FilterHolder holder, String pathSpec, int dispatches) Convenience method to add a filter.
FilterHolder	addFilterWithMapping(String className, String pathSpec, EnumSet<DispatcherType> dispatches) Convenience method to add a filter.
FilterHolder	addFilterWithMapping(String className, String pathSpec, int dispatches) Convenience method to add a filter.
void	addListener(ListenerHolder listener) Add a holder for a listener
void	addServlet(ServletHolder holder) Convenience method to add a pre-constructed ServletHolder.
void	addServletMapping(ServletMapping mapping) Convenience method to add a pre-constructed ServletMapping.
ServletHolder	addServletWithMapping(Class<? extends Servlet> servlet, String pathSpec) conveniance method to add a servlet.
void	addServletWithMapping(ServletHolder servlet, String pathSpec) conveniance method to add a servlet.
ServletHolder	addServletWithMapping(String className, String pathSpec) Convenience method to add a servlet.
void	doHandle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response)
void	doScope(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response)
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
protected void	doStop() Stops the managed lifecycle beans in the reverse order they were added.
Object	getContextLog()
FilterHolder	getFilter(String name)
protected FilterChain	getFilterChain(Request baseRequest, String pathInContext, ServletHolder servletHolder)
FilterMapping[]	getFilterMappings()
FilterHolder[]	getFilters() Get Filters.
PathMap.MappedEntry<ServletHolder>	getHolderEntry(String pathInContext) ServletHolder matching path.
protected IdentityService	getIdentityService()
ListenerHolder[]	getListeners()
int	getMaxFilterChainsCacheSize()
ServletHolder	getServlet(String name)
ServletContext	getServletContext()
ServletMapping	getServletMapping(String pathSpec) Get the ServletMapping matching the path
ServletMapping[]	getServletMappings()
ServletHolder[]	getServlets() Get Servlets.
void	initialize() Initialize filters and load-on-startup servlets.
protected FilterMapping[]	insertFilterMapping(FilterMapping mapping, int pos, boolean before) Insert a filtermapping in the list
protected void	invalidateChainsCache()
boolean	isAvailable()
boolean	isEnsureDefaultServlet()
boolean	isFilterChainsCached()
boolean	isStartWithUnavailable()
FilterHolder	newFilterHolder(BaseHolder.Source source)
ListenerHolder	newListenerHolder(BaseHolder.Source source)
ServletHolder	newServletHolder(BaseHolder.Source source) see also newServletHolder(Class)
protected void	notFound(Request baseRequest, HttpServletRequest request, HttpServletResponse response)
void	prependFilterMapping(FilterMapping mapping) Convenience method to add a preconstructed FilterMapping
void	setEnsureDefaultServlet(boolean ensureDefaultServlet)
void	setFilterChainsCached(boolean filterChainsCached)
void	setFilterMappings(FilterMapping[] filterMappings)
void	setFilters(FilterHolder[] holders)
void	setListeners(ListenerHolder[] listeners)
void	setMaxFilterChainsCacheSize(int maxFilterChainsCacheSize) Set the maximum filter chain cache size.
void	setServletMappings(ServletMapping[] servletMappings)
void	setServlets(ServletHolder[] holders) Set Servlets.
Set<String>	setServletSecurity(ServletRegistration.Dynamic registration, ServletSecurityElement servletSecurityElement)
void	setStartWithUnavailable(boolean start)
protected void	start(LifeCycle l) Starts the given lifecycle.
protected void	updateMappings()
protected void	updateNameMappings()

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

handle, never, nextHandle, nextScope

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

destroy, expandChildren, getHandler, getHandlers, setHandler, setServer

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

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

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

dumpThis, getServer

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

addBean, addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, stop, unmanage, 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

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

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

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

Field Detail

__DEFAULT_SERVLET

public static final String __DEFAULT_SERVLET

See Also:

Constant Field Values

_chainCache

protected final ConcurrentMap<String,FilterChain>[] _chainCache

_chainLRU

protected final Queue<String>[] _chainLRU

Constructor Detail

ServletHandler

public ServletHandler()

Constructor.

Method Detail

doStart

protected void doStart()
                throws Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class ScopedHandler

Throws:

Exception

See Also:

AbstractHandler.doStart()

isEnsureDefaultServlet

public boolean isEnsureDefaultServlet()

Returns:

true if ServletHandler always has a default servlet, using ServletHandler.Default404Servlet if no other default servlet is configured.

setEnsureDefaultServlet

public void setEnsureDefaultServlet(boolean ensureDefaultServlet)

Parameters:

ensureDefaultServlet - true if ServletHandler always has a default servlet, using ServletHandler.Default404Servlet if no other default servlet is configured.

start

protected void start(LifeCycle l)
              throws Exception

Description copied from class: ContainerLifeCycle

Starts the given lifecycle.

Overrides:

start in class ContainerLifeCycle

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class AbstractHandler

Throws:

Exception

getIdentityService

protected IdentityService getIdentityService()

getContextLog

public Object getContextLog()

Returns:

Returns the contextLog.

getFilterMappings

@ManagedAttribute(value="filters",
                  readonly=true)
public FilterMapping[] getFilterMappings()

Returns:

Returns the filterMappings.

getFilters

@ManagedAttribute(value="filters",
                  readonly=true)
public FilterHolder[] getFilters()

Get Filters.

Returns:

Array of defined servlets

getHolderEntry

public PathMap.MappedEntry<ServletHolder> getHolderEntry(String pathInContext)

ServletHolder matching path.

Parameters:

pathInContext - Path within _context.

Returns:

PathMap Entries pathspec to ServletHolder

getServletContext

public ServletContext getServletContext()

getServletMappings

@ManagedAttribute(value="mappings of servlets",
                  readonly=true)
public ServletMapping[] getServletMappings()

Returns:

Returns the servletMappings.

getServletMapping

public ServletMapping getServletMapping(String pathSpec)

Get the ServletMapping matching the path

Parameters:

pathSpec -

Returns:

getServlets

@ManagedAttribute(value="servlets",
                  readonly=true)
public ServletHolder[] getServlets()

Get Servlets.

Returns:

Array of defined servlets

getServlet

public ServletHolder getServlet(String name)

doScope

public void doScope(String target,
           Request baseRequest,
           HttpServletRequest request,
           HttpServletResponse response)
             throws IOException,
                    ServletException

Specified by:

doScope in class ScopedHandler

Throws:

IOException

ServletException

doHandle

public void doHandle(String target,
            Request baseRequest,
            HttpServletRequest request,
            HttpServletResponse response)
              throws IOException,
                     ServletException

Specified by:

doHandle in class ScopedHandler

Throws:

IOException

ServletException

getFilterChain

protected FilterChain getFilterChain(Request baseRequest,
                         String pathInContext,
                         ServletHolder servletHolder)

invalidateChainsCache

protected void invalidateChainsCache()

isAvailable

public boolean isAvailable()

Returns:

true if the handler is started and there are no unavailable servlets

setStartWithUnavailable

public void setStartWithUnavailable(boolean start)

Parameters:

start - True if this handler will start with unavailable servlets

isStartWithUnavailable

public boolean isStartWithUnavailable()

Returns:

True if this handler will start with unavailable servlets

initialize

public void initialize()
                throws Exception

Initialize filters and load-on-startup servlets.

Throws:

Exception

isFilterChainsCached

public boolean isFilterChainsCached()

Returns:

Returns the filterChainsCached.

addListener

public void addListener(ListenerHolder listener)

Add a holder for a listener

Parameters:

filter -

getListeners

public ListenerHolder[] getListeners()

setListeners

public void setListeners(ListenerHolder[] listeners)

newListenerHolder

public ListenerHolder newListenerHolder(BaseHolder.Source source)

newServletHolder

public ServletHolder newServletHolder(BaseHolder.Source source)

see also newServletHolder(Class)

addServletWithMapping

public ServletHolder addServletWithMapping(String className,
                                  String pathSpec)

Convenience method to add a servlet.

Returns:

The servlet holder.

addServletWithMapping

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

conveniance method to add a servlet.

Returns:

The servlet holder.

addServletWithMapping

public void addServletWithMapping(ServletHolder servlet,
                         String pathSpec)

conveniance method to add a servlet.

Parameters:

servlet - servlet holder to add

pathSpec - servlet mappings for the servletHolder

addServlet

public void addServlet(ServletHolder holder)

Convenience method to add a pre-constructed ServletHolder.

Parameters:

holder -

addServletMapping

public void addServletMapping(ServletMapping mapping)

Convenience method to add a pre-constructed ServletMapping.

Parameters:

mapping -

setServletSecurity

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

newFilterHolder

public FilterHolder newFilterHolder(BaseHolder.Source source)

getFilter

public FilterHolder getFilter(String name)

addFilterWithMapping

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

Convenience method to add a filter.

Parameters:

filter - class of filter to create

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

Returns:

The filter holder.

addFilterWithMapping

public FilterHolder addFilterWithMapping(String className,
                                String pathSpec,
                                EnumSet<DispatcherType> dispatches)

Convenience method to add a filter.

Parameters:

className - of filter

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

Returns:

The filter holder.

addFilterWithMapping

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

Convenience method to add a filter.

Parameters:

holder - filter holder to add

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

addFilterWithMapping

public FilterHolder addFilterWithMapping(Class<? extends Filter> filter,
                                String pathSpec,
                                int dispatches)

Convenience method to add a filter.

Parameters:

filter - class of filter to create

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

Returns:

The filter holder.

addFilterWithMapping

public FilterHolder addFilterWithMapping(String className,
                                String pathSpec,
                                int dispatches)

Convenience method to add a filter.

Parameters:

className - of filter

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

Returns:

The filter holder.

addFilterWithMapping

public void addFilterWithMapping(FilterHolder holder,
                        String pathSpec,
                        int dispatches)

Convenience method to add a filter.

Parameters:

holder - filter holder to add

pathSpec - filter mappings for filter

dispatches - see FilterMapping.setDispatches(int)

addFilter

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

Deprecated. use addFilterWithMapping(Class, String, EnumSet) instead

Convenience method to add a filter with a mapping

Parameters:

className -

pathSpec -

dispatches -

Returns:

the filter holder created

addFilter

public void addFilter(FilterHolder filter,
             FilterMapping filterMapping)

convenience method to add a filter and mapping

Parameters:

filter -

filterMapping -

addFilter

public void addFilter(FilterHolder filter)

Convenience method to add a preconstructed FilterHolder

Parameters:

filter -

addFilterMapping

public void addFilterMapping(FilterMapping mapping)

Convenience method to add a preconstructed FilterMapping

Parameters:

mapping -

prependFilterMapping

public void prependFilterMapping(FilterMapping mapping)

Convenience method to add a preconstructed FilterMapping

Parameters:

mapping -

insertFilterMapping

protected FilterMapping[] insertFilterMapping(FilterMapping mapping,
                                  int pos,
                                  boolean before)

Insert a filtermapping in the list

Parameters:

mapping - the FilterMapping to add

pos - the position in the existing arry at which to add it

before - if true, insert before pos, if false insert after it

Returns:

updateNameMappings

protected void updateNameMappings()

updateMappings

protected void updateMappings()

notFound

protected void notFound(Request baseRequest,
            HttpServletRequest request,
            HttpServletResponse response)
                 throws IOException,
                        ServletException

Throws:

IOException

ServletException

setFilterChainsCached

public void setFilterChainsCached(boolean filterChainsCached)

Parameters:

filterChainsCached - The filterChainsCached to set.

setFilterMappings

public void setFilterMappings(FilterMapping[] filterMappings)

Parameters:

filterMappings - The filterMappings to set.

setFilters

public void setFilters(FilterHolder[] holders)

setServletMappings

public void setServletMappings(ServletMapping[] servletMappings)

Parameters:

servletMappings - The servletMappings to set.

setServlets

public void setServlets(ServletHolder[] holders)

Set Servlets.

Parameters:

holders - Array of servlets to define

getMaxFilterChainsCacheSize

public int getMaxFilterChainsCacheSize()

Returns:

The maximum entries in a filter chain cache.

setMaxFilterChainsCacheSize

public void setMaxFilterChainsCacheSize(int maxFilterChainsCacheSize)

Set the maximum filter chain cache size. Filter chains are cached if isFilterChainsCached() is true. If the max cache size is greater than zero, then the cache is flushed whenever it grows to be this size.

Parameters:

maxFilterChainsCacheSize - the maximum number of entries in a filter chain cache.