Module org.eclipse.jetty.ee10.servlet

Package org.eclipse.jetty.ee10.servlet

Class ServletHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.Handler.Abstract

org.eclipse.jetty.server.Handler.AbstractContainer

org.eclipse.jetty.server.Handler.Wrapper

org.eclipse.jetty.ee10.servlet.ServletHandler

All Implemented Interfaces:

org.eclipse.jetty.server.Handler, org.eclipse.jetty.server.Handler.Container, org.eclipse.jetty.server.Handler.Singleton, org.eclipse.jetty.server.Request.Handler, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.LifeCycle, org.eclipse.jetty.util.thread.Invocable

@ManagedObject("Servlet Handler")
public class ServletHandler
extends org.eclipse.jetty.server.Handler.Wrapper

Servlet HttpHandler.

This handler maps requests to servlets that implement the jakarta.servlet.http.HttpServlet API.

This handler does not implement the full J2EE features and is intended to be used directly when a full web application is not required. If a Web application is required, then this handler should be used as part of a org.eclipse.jetty.webapp.WebAppContext.

Unless run as part of a ServletContextHandler or derivative, the initialize() method must be called manually after start().

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ServletHandler.Default404Servlet
static class	ServletHandler.MappedServlet	A mapping of a servlet by pathSpec or by name

Nested classes/interfaces inherited from class org.eclipse.jetty.server.Handler.Abstract

org.eclipse.jetty.server.Handler.Abstract.NonBlocking

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

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

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

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

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

org.eclipse.jetty.util.component.Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.Handler

org.eclipse.jetty.server.Handler.Abstract, org.eclipse.jetty.server.Handler.AbstractContainer, org.eclipse.jetty.server.Handler.Collection, org.eclipse.jetty.server.Handler.Container, org.eclipse.jetty.server.Handler.Sequence, org.eclipse.jetty.server.Handler.Singleton, org.eclipse.jetty.server.Handler.Wrapper

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.Invocable

org.eclipse.jetty.util.thread.Invocable.Callable, org.eclipse.jetty.util.thread.Invocable.InvocationType, org.eclipse.jetty.util.thread.Invocable.ReadyTask, org.eclipse.jetty.util.thread.Invocable.Task

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

org.eclipse.jetty.util.component.LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.Request.Handler

org.eclipse.jetty.server.Request.Handler.AbortException

Field Summary

Fields

Modifier and Type	Field	Description
protected final ConcurrentMap<String,jakarta.servlet.FilterChain>[]	_chainCache

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

FAILED, STARTED, STARTING, STOPPED, STOPPING

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

KEY

Fields inherited from interface org.eclipse.jetty.util.thread.Invocable

__nonBlocking, NOOP

Constructor Summary

Constructors

Constructor	Description
ServletHandler()	Constructor.

Method Summary

Modifier and Type	Method	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
void	addFilterMapping(FilterMapping mapping)	Convenience method to add a preconstructed FilterMapping
FilterHolder	addFilterWithMapping(Class<? extends jakarta.servlet.Filter> filter, String pathSpec, int dispatches)	Convenience method to add a filter.
FilterHolder	addFilterWithMapping(Class<? extends jakarta.servlet.Filter> filter, String pathSpec, EnumSet<jakarta.servlet.DispatcherType> dispatches)	Convenience method to add a filter.
FilterHolder	addFilterWithMapping(String className, String pathSpec, int dispatches)	Convenience method to add a filter.
FilterHolder	addFilterWithMapping(String className, String pathSpec, EnumSet<jakarta.servlet.DispatcherType> dispatches)	Convenience method to add a filter.
void	addFilterWithMapping(FilterHolder holder, String pathSpec, int dispatches)	Convenience method to add a filter.
void	addFilterWithMapping(FilterHolder holder, String pathSpec, EnumSet<jakarta.servlet.DispatcherType> 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 jakarta.servlet.Servlet> servlet, String pathSpec)	Convenience method to add a servlet.
ServletHolder	addServletWithMapping(String className, String pathSpec)	Convenience method to add a servlet.
void	addServletWithMapping(ServletHolder servlet, String pathSpec)	Convenience method to add a servlet.
protected org.eclipse.jetty.http.pathmap.PathSpec	asPathSpec(String pathSpec)
protected boolean	containsFilterHolder(FilterHolder holder)
protected boolean	containsServletHolder(ServletHolder holder)
protected void	doStart()
protected void	doStop()
void	dump(Appendable out, String indent)
FilterHolder	getFilter(String name)
protected jakarta.servlet.FilterChain	getFilterChain(jakarta.servlet.http.HttpServletRequest request, String pathInContext, ServletHolder servletHolder)
FilterMapping[]	getFilterMappings()
FilterHolder[]	getFilters()
protected org.eclipse.jetty.security.IdentityService	getIdentityService()
ListenerHolder[]	getListeners()
ServletHandler.MappedServlet	getMappedServlet(String target)	ServletHolder matching path.
org.eclipse.jetty.http.pathmap.MatchedResource<ServletHandler.MappedServlet>	getMatchedServlet(String target)	ServletHolder matching target path.
int	getMaxFilterChainsCacheSize()
ServletHolder	getServlet(String name)
jakarta.servlet.ServletContext	getServletContext()
ServletContextHandler	getServletContextHandler()
ServletMapping	getServletMapping(String pathSpec)	Get the ServletMapping matching the path
ServletMapping[]	getServletMappings()
ServletHolder[]	getServlets()
List<ServletHolder>	getServlets(Class<?> clazz)
boolean	handle(org.eclipse.jetty.server.Request request, org.eclipse.jetty.server.Response response, org.eclipse.jetty.util.Callback callback)
void	initialize()	Initialize filters and load-on-startup servlets.
protected void	initializeHolders(Collection<? extends BaseHolder<?>> holders)
protected void	invalidateChainsCache()
boolean	isAllowDuplicateMappings()
boolean	isAvailable()
boolean	isDecodeAmbiguousURIs()
boolean	isDumpable(Object o)
boolean	isEnsureDefaultServlet()
boolean	isFilterChainsCached()
boolean	isInitialized()
boolean	isStartWithUnavailable()
protected jakarta.servlet.FilterChain	newFilterChain(FilterHolder filterHolder, jakarta.servlet.FilterChain chain)	Create a FilterChain that calls the passed filter with the passed chain
FilterHolder	newFilterHolder(Source source)
ListenerHolder	newListenerHolder(Source source)
ServletHolder	newServletHolder(Source source)	Add a new servlet holder
protected void	notFound(org.eclipse.jetty.server.Request baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
void	prependFilter(FilterHolder filter)	Convenience method to add a preconstructed FilterHolder
void	prependFilterMapping(FilterMapping mapping)	Convenience method to add a preconstructed FilterMapping
void	removeFilterHolder(FilterHolder holder)
void	removeFilterMapping(FilterMapping mapping)
void	setAllowDuplicateMappings(boolean allowDuplicateMappings)	Set the allowDuplicateMappings to set.
void	setDecodeAmbiguousURIs(boolean decodeAmbiguousURIs)	Allow or disallow ambiguous URIs to be returned by ServletApiRequest.getServletPath() and ServletApiRequest.getPathInfo().
void	setEnsureDefaultServlet(boolean ensureDefaultServlet)
void	setFilterChainsCached(boolean filterChainsCached)
void	setFilterMappings(FilterMapping[] filterMappings)
void	setFilters(FilterHolder[] holders)
void	setListeners(ListenerHolder[] holders)
void	setMaxFilterChainsCacheSize(int maxFilterChainsCacheSize)	Set the maximum filter chain cache size.
void	setServletMappings(ServletMapping[] servletMappings)
void	setServlets(ServletHolder[] holders)	Set Servlets.
Set<String>	setServletSecurity(jakarta.servlet.ServletRegistration.Dynamic registration, jakarta.servlet.ServletSecurityElement servletSecurityElement)
void	setStartWithUnavailable(boolean start)
protected void	start(org.eclipse.jetty.util.component.LifeCycle l)
protected void	stop(org.eclipse.jetty.util.component.LifeCycle l)
protected void	updateMappings()
protected void	updateNameMappings()

Methods inherited from class org.eclipse.jetty.server.Handler.Wrapper

getHandler, getInvocationType, setHandler

Methods inherited from class org.eclipse.jetty.server.Handler.AbstractContainer

findContainerOf, getDescendant, getDescendants, isDynamic, setDynamic, setServer

Methods inherited from class org.eclipse.jetty.server.Handler.Abstract

destroy, getServer

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

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

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

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop, toString

Methods inherited from class java.lang.Object

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

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

getCachedBeans, getEventListeners

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

destroy

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

dumpSelf

Methods inherited from interface org.eclipse.jetty.server.Handler

getServer, setServer

Methods inherited from interface org.eclipse.jetty.server.Handler.Container

getContainer, getDescendant, getDescendants, getDescendants

Methods inherited from interface org.eclipse.jetty.server.Handler.Singleton

getHandlers, getTail, insertHandler, setHandler

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

addEventListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, start, stop

Field Details

_chainCache

protected final ConcurrentMap<String,jakarta.servlet.FilterChain>[] _chainCache

Constructor Details

ServletHandler

public ServletHandler()

Constructor.

Method Details

isDecodeAmbiguousURIs

@ManagedAttribute("True if URIs with violations are decoded")
public boolean isDecodeAmbiguousURIs()

setDecodeAmbiguousURIs

public void setDecodeAmbiguousURIs(boolean decodeAmbiguousURIs)

Allow or disallow ambiguous URIs to be returned by ServletApiRequest.getServletPath() and ServletApiRequest.getPathInfo().

Note that the HttpConfiguration.setUriCompliance(UriCompliance) must also be set to allow ambiguous URIs to be accepted by the Connector.

Parameters:

decodeAmbiguousURIs - True if ambiguous URIs are decoded by all servlet API methods.

isDumpable

public boolean isDumpable(Object o)

dump

public void dump(Appendable out,
 String indent)
          throws IOException

Specified by:

dump in interface org.eclipse.jetty.util.component.Dumpable

Overrides:

dump in class org.eclipse.jetty.util.component.ContainerLifeCycle

Throws:

IOException

doStart

protected void doStart()
                throws Exception

Overrides:

doStart in class org.eclipse.jetty.server.Handler.Abstract

Throws:

Exception

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(org.eclipse.jetty.util.component.LifeCycle l)
              throws Exception

Overrides:

start in class org.eclipse.jetty.util.component.ContainerLifeCycle

Throws:

Exception

stop

protected void stop(org.eclipse.jetty.util.component.LifeCycle l)
             throws Exception

Overrides:

stop in class org.eclipse.jetty.util.component.ContainerLifeCycle

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class org.eclipse.jetty.server.Handler.Abstract

Throws:

Exception

getFilterMappings

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

getFilters

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

getServletContext

public jakarta.servlet.ServletContext getServletContext()

getServletContextHandler

public ServletContextHandler getServletContextHandler()

getServletMappings

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

getServletMapping

public ServletMapping getServletMapping(String pathSpec)

Get the ServletMapping matching the path

Parameters:

pathSpec - the path spec

Returns:

the servlet mapping for the path spec (or null if not found)

getServlets

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

getServlets

public List<ServletHolder> getServlets(Class<?> clazz)

getServlet

public ServletHolder getServlet(String name)

getIdentityService

protected org.eclipse.jetty.security.IdentityService getIdentityService()

handle

public boolean handle(org.eclipse.jetty.server.Request request,
 org.eclipse.jetty.server.Response response,
 org.eclipse.jetty.util.Callback callback)
               throws Exception

Specified by:

handle in interface org.eclipse.jetty.server.Request.Handler

Overrides:

handle in class org.eclipse.jetty.server.Handler.Wrapper

Throws:

Exception

getMatchedServlet

public org.eclipse.jetty.http.pathmap.MatchedResource<ServletHandler.MappedServlet> getMatchedServlet(String target)

ServletHolder matching target path.

Parameters:

target - Path within _context or servlet name

Returns:

MatchedResource, pointing to the MappedResource for the ServletHolder, and also the pathspec specific name/info sections for the match. Named servlets have a null PathSpec and MatchedResource.

getMappedServlet

public ServletHandler.MappedServlet getMappedServlet(String target)

ServletHolder matching path.

Parameters:

target - Path within _context or servlet name

Returns:

MappedResource to the ServletHolder. Named servlets have a null PathSpec

getFilterChain

protected jakarta.servlet.FilterChain getFilterChain(jakarta.servlet.http.HttpServletRequest request,
 String pathInContext,
 ServletHolder servletHolder)

newFilterChain

protected jakarta.servlet.FilterChain newFilterChain(FilterHolder filterHolder,
 jakarta.servlet.FilterChain chain)

Create a FilterChain that calls the passed filter with the passed chain

Parameters:

filterHolder - The filter to invoke

chain - The chain to pass to the filter

Returns:

A FilterChain that invokes the filter with the chain

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

isAllowDuplicateMappings

public boolean isAllowDuplicateMappings()

Returns:

the allowDuplicateMappings

setAllowDuplicateMappings

public void setAllowDuplicateMappings(boolean allowDuplicateMappings)

Set the allowDuplicateMappings to set.

Parameters:

allowDuplicateMappings - the allowDuplicateMappings to set

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 - if unable to initialize

isInitialized

public boolean isInitialized()

Returns:

true if initialized has been called, false otherwise

initializeHolders

protected void initializeHolders(Collection<? extends BaseHolder<?>> holders)

isFilterChainsCached

public boolean isFilterChainsCached()

Returns:

whether the filter chains are cached.

addListener

public void addListener(ListenerHolder listener)

Add a holder for a listener

Parameters:

listener - the listener for the holder

getListeners

public ListenerHolder[] getListeners()

setListeners

public void setListeners(ListenerHolder[] holders)

newListenerHolder

public ListenerHolder newListenerHolder(Source source)

newServletHolder

public ServletHolder newServletHolder(Source source)

Add a new servlet holder

Parameters:

source - the holder source

Returns:

the servlet holder

addServletWithMapping

public ServletHolder addServletWithMapping(String className,
 String pathSpec)

Convenience method to add a servlet.

Parameters:

className - the class name

pathSpec - the path spec

Returns:

The servlet holder.

addServletWithMapping

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

Convenience method to add a servlet.

Parameters:

servlet - the servlet class

pathSpec - the path spec

Returns:

The servlet holder.

addServletWithMapping

public void addServletWithMapping(ServletHolder servlet,
 String pathSpec)

Convenience 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 - the servlet holder

addServletMapping

public void addServletMapping(ServletMapping mapping)

Convenience method to add a pre-constructed ServletMapping.

Parameters:

mapping - the servlet mapping

setServletSecurity

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

newFilterHolder

public FilterHolder newFilterHolder(Source source)

getFilter

public FilterHolder getFilter(String name)

addFilterWithMapping

public FilterHolder addFilterWithMapping(Class<? extends jakarta.servlet.Filter> filter,
 String pathSpec,
 EnumSet<jakarta.servlet.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<jakarta.servlet.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<jakarta.servlet.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 jakarta.servlet.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 void addFilter(FilterHolder filter,
 FilterMapping filterMapping)

Convenience method to add a filter and mapping

Parameters:

filter - the filter holder

filterMapping - the filter mapping

addFilter

public void addFilter(FilterHolder filter)

Convenience method to add a preconstructed FilterHolder

Parameters:

filter - the filter holder

prependFilter

public void prependFilter(FilterHolder filter)

Convenience method to add a preconstructed FilterHolder

Parameters:

filter - the filter holder

addFilterMapping

public void addFilterMapping(FilterMapping mapping)

Convenience method to add a preconstructed FilterMapping

Parameters:

mapping - the filter mapping

prependFilterMapping

public void prependFilterMapping(FilterMapping mapping)

Convenience method to add a preconstructed FilterMapping

Parameters:

mapping - the filter mapping

removeFilterHolder

public void removeFilterHolder(FilterHolder holder)

removeFilterMapping

public void removeFilterMapping(FilterMapping mapping)

updateNameMappings

protected void updateNameMappings()

asPathSpec

protected org.eclipse.jetty.http.pathmap.PathSpec asPathSpec(String pathSpec)

updateMappings

protected void updateMappings()

notFound

protected void notFound(org.eclipse.jetty.server.Request baseRequest,
 jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response)
                 throws IOException,
jakarta.servlet.ServletException

Throws:

IOException

jakarta.servlet.ServletException

containsFilterHolder

protected boolean containsFilterHolder(FilterHolder holder)

containsServletHolder

protected boolean containsServletHolder(ServletHolder holder)

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.