org.glassfish.grizzly.servlet

Class WebappContext

java.lang.Object

org.glassfish.grizzly.servlet.WebappContext

All Implemented Interfaces:

javax.servlet.ServletContext

public class WebappContext
extends java.lang.Object
implements javax.servlet.ServletContext

This class acts as the foundation for registering listeners, servlets, and filters in an embedded environment.

Additionally, this class implements the the requirements set forth by the Servlet 2.5 specification of ServletContext, however, it also exposes the dynamic registration API of Servlet 3.0.

TODO: Provide code examples once the api firms up a bit.

Since:

2.2

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	deployed
protected java.util.Map<java.lang.String,FilterRegistration>	filterRegistrations
protected java.util.Map<java.lang.String,ServletRegistration>	servletRegistrations
protected java.util.Map<java.lang.String,FilterRegistration>	unmodifiableFilterRegistrations

Fields inherited from interface javax.servlet.ServletContext

ORDERED_LIBS, TEMPDIR

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WebappContext()
	WebappContext(java.lang.String displayName) Creates a simple WebappContext with the root being "/".
	WebappContext(java.lang.String displayName, java.lang.String contextPath)
	WebappContext(java.lang.String displayName, java.lang.String contextPath, java.lang.String basePath)

Method Summary

Methods

Modifier and Type	Method and Description
void	addContextInitParameter(java.lang.String name, java.lang.String value)
FilterRegistration	addFilter(java.lang.String filterName, java.lang.Class<? extends javax.servlet.Filter> filterClass) Adds the filter with the given name and class type to this servlet context.
FilterRegistration	addFilter(java.lang.String filterName, javax.servlet.Filter filter) Registers the given filter instance with this WebappContext under the given filterName.
FilterRegistration	addFilter(java.lang.String filterName, java.lang.String className) Adds the filter with the given name and class name to this servlet context.
protected void	addFilterMap(FilterMap filterMap, boolean isMatchAfter) Add a filter mapping to this Context.
void	addListener(java.lang.Class<? extends java.util.EventListener> listenerClass) Adds the given listener class to this WebappContext.
void	addListener(java.lang.String className) Adds the listener with the given class name to this WebappContext.
<T extends java.util.EventListener> void	addListener(T eventListener)
ServletRegistration	addServlet(java.lang.String servletName, java.lang.Class<? extends javax.servlet.Servlet> servletClass) Adds the servlet with the given name and class type to this servlet context.
ServletRegistration	addServlet(java.lang.String servletName, javax.servlet.Servlet servlet) Registers the given servlet instance with this WebappContext under the given servletName.
ServletRegistration	addServlet(java.lang.String servletName, java.lang.String className) Adds the servlet with the given name and class name to this servlet context.
void	clearContextInitParameters()
protected java.util.EventListener	createEventListenerInstance(java.lang.Class<? extends java.util.EventListener> eventListenerClass) Instantiates the given EventListener class.
protected java.util.EventListener	createEventListenerInstance(java.lang.String eventListenerClassname) Instantiates the given EventListener class.
<T extends javax.servlet.Filter> T	createFilter(java.lang.Class<T> clazz)
protected javax.servlet.Filter	createFilterInstance(java.lang.Class<? extends javax.servlet.Filter> filterClass) Instantiates the given Filter class.
protected javax.servlet.Filter	createFilterInstance(FilterRegistration registration) Instantiates the given Filter class.
<T extends javax.servlet.http.HttpUpgradeHandler> T	createHttpUpgradeHandlerInstance(java.lang.Class<T> clazz) Instantiates the given HttpUpgradeHandler class.
<T extends java.util.EventListener> T	createListener(java.lang.Class<T> clazz)
<T extends javax.servlet.Servlet> T	createServlet(java.lang.Class<T> clazz)
protected javax.servlet.Servlet	createServletInstance(java.lang.Class<? extends javax.servlet.Servlet> servletClass) Instantiates the given Servlet class.
protected javax.servlet.Servlet	createServletInstance(ServletRegistration registration) Instantiates the given Servlet class.
void	declareRoles(java.lang.String... roleNames)
void	deploy(HttpServer targetServer)
protected void	destroyFilters()
java.lang.Object	getAttribute(java.lang.String name)
java.util.Enumeration<java.lang.String>	getAttributeNames()
protected java.lang.String	getBasePath()
java.lang.ClassLoader	getClassLoader()
javax.servlet.ServletContext	getContext(java.lang.String uri)
java.lang.String	getContextPath()
java.util.Set<javax.servlet.SessionTrackingMode>	getDefaultSessionTrackingModes()
int	getEffectiveMajorVersion()
int	getEffectiveMinorVersion()
java.util.Set<javax.servlet.SessionTrackingMode>	getEffectiveSessionTrackingModes()
protected java.util.EventListener[]	getEventListeners()
protected FilterChainFactory	getFilterChainFactory()
protected java.util.List<FilterMap>	getFilterMaps()
FilterRegistration	getFilterRegistration(java.lang.String name) Gets the FilterRegistration corresponding to the filter with the given filterName.
java.util.Map<java.lang.String,? extends FilterRegistration>	getFilterRegistrations() Gets a (possibly empty) Map of the FilterRegistration objects (keyed by filter name) corresponding to all filters registered with this WebappContext.
java.lang.String	getInitParameter(java.lang.String name)
java.util.Enumeration<java.lang.String>	getInitParameterNames()
javax.servlet.descriptor.JspConfigDescriptor	getJspConfigDescriptor()
int	getMajorVersion()
java.lang.String	getMimeType(java.lang.String file)
int	getMinorVersion()
javax.servlet.RequestDispatcher	getNamedDispatcher(java.lang.String name)
java.lang.String	getRealPath(java.lang.String path)
javax.servlet.RequestDispatcher	getRequestDispatcher(java.lang.String path)
java.net.URL	getResource(java.lang.String path)
java.io.InputStream	getResourceAsStream(java.lang.String path)
java.util.Set<java.lang.String>	getResourcePaths(java.lang.String path)
java.lang.String	getServerInfo()
javax.servlet.Servlet	getServlet(java.lang.String name) Deprecated.
java.lang.String	getServletContextName()
protected java.util.Collection<java.lang.String>	getServletNameFilterMappings(java.lang.String filterName) Gets the current servlet name mappings of the Filter with the given name.
java.util.Enumeration<java.lang.String>	getServletNames() Deprecated.
ServletRegistration	getServletRegistration(java.lang.String name) Gets the ServletRegistration corresponding to the servlet with the given servletName.
java.util.Map<java.lang.String,? extends ServletRegistration>	getServletRegistrations() Gets a (possibly empty) Map of the ServletRegistration objects (keyed by servlet name) corresponding to all servlets registered with this WebappContext.
java.util.Enumeration<javax.servlet.Servlet>	getServlets() Deprecated.
javax.servlet.SessionCookieConfig	getSessionCookieConfig()
protected java.util.Collection<java.lang.String>	getUrlPatternFilterMappings(java.lang.String filterName) Gets the current URL pattern mappings of the Filter with the given name.
java.lang.String	getVirtualServerName()
void	log(java.lang.Exception e, java.lang.String message) Deprecated.
void	log(java.lang.String message)
void	log(java.lang.String message, java.lang.Throwable throwable)
protected java.lang.String	normalize(java.lang.String path) Return a context-relative path, beginning with a "/", that represents the canonical version of the specified path after ".." and "." elements are resolved out.
void	removeAttribute(java.lang.String name)
void	removeContextInitParameter(java.lang.String name)
protected void	removeFilterMaps() Removes any filter mappings from this Context.
void	setAttribute(java.lang.String name, java.lang.Object value)
protected void	setDispatcherHelper(DispatcherHelper dispatcherHelper)
boolean	setInitParameter(java.lang.String name, java.lang.String value)
void	setSessionTrackingModes(java.util.Set<javax.servlet.SessionTrackingMode> sessionTrackingModes)
void	undeploy()
protected void	unregisterAllFilters()
protected void	unregisterFilter(javax.servlet.Filter f)
protected boolean	validateURLPattern(java.lang.String urlPattern) Validate the syntax of a proposed <url-pattern> for conformance with specification requirements.

Methods inherited from class java.lang.Object

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

Field Detail

servletRegistrations

protected final java.util.Map<java.lang.String,ServletRegistration> servletRegistrations

filterRegistrations

protected final java.util.Map<java.lang.String,FilterRegistration> filterRegistrations

unmodifiableFilterRegistrations

protected final java.util.Map<java.lang.String,FilterRegistration> unmodifiableFilterRegistrations

deployed

protected boolean deployed

Constructor Detail

WebappContext

protected WebappContext()

WebappContext

public WebappContext(java.lang.String displayName)

Creates a simple WebappContext with the root being "/".

Parameters:

displayName -

WebappContext

public WebappContext(java.lang.String displayName,
             java.lang.String contextPath)

WebappContext

public WebappContext(java.lang.String displayName,
             java.lang.String contextPath,
             java.lang.String basePath)

Method Detail

deploy

public void deploy(HttpServer targetServer)

Parameters:

targetServer -

undeploy

public void undeploy()

addContextInitParameter

public void addContextInitParameter(java.lang.String name,
                           java.lang.String value)

Parameters:

name -

value -

removeContextInitParameter

public void removeContextInitParameter(java.lang.String name)

Parameters:

name -

clearContextInitParameters

public void clearContextInitParameters()

addFilter

public FilterRegistration addFilter(java.lang.String filterName,
                           java.lang.Class<? extends javax.servlet.Filter> filterClass)

Adds the filter with the given name and class type to this servlet context.

The registered filter may be further configured via the returned FilterRegistration object.

If this WebappContext already contains a preliminary FilterRegistration for a filter with the given filterName, it will be completed (by assigning the name of the given filterClass to it) and returned.

Specified by:

addFilter in interface javax.servlet.ServletContext

Parameters:

filterName - the name of the filter

filterClass - the class object from which the filter will be instantiated

Returns:

a FilterRegistration object that may be used to further configure the registered filter, or null if this WebappContext already contains a complete FilterRegistration for a filter with the given filterName

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

addFilter

public FilterRegistration addFilter(java.lang.String filterName,
                           javax.servlet.Filter filter)

Registers the given filter instance with this WebappContext under the given filterName.

The registered filter may be further configured via the returned FilterRegistration object.

If this WebappContext already contains a preliminary FilterRegistration for a filter with the given filterName, it will be completed (by assigning the class name of the given filter instance to it) and returned.

Specified by:

addFilter in interface javax.servlet.ServletContext

Parameters:

filterName - the name of the filter

filter - the filter instance to register

Returns:

a FilterRegistration object that may be used to further configure the given filter, or null if this WebappContext already contains a complete FilterRegistration for a filter with the given filterName or if the same filter instance has already been registered with this or another WebappContext in the same container

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

Since:

Servlet 3.0

addFilter

public FilterRegistration addFilter(java.lang.String filterName,
                           java.lang.String className)

Adds the filter with the given name and class name to this servlet context.

The registered filter may be further configured via the returned FilterRegistration object.

The specified className will be loaded using the classloader associated with the application represented by this WebappContext.

If this WebappContext already contains a preliminary FilterRegistration for a filter with the given filterName, it will be completed (by assigning the given className to it) and returned.

Specified by:

addFilter in interface javax.servlet.ServletContext

Parameters:

filterName - the name of the filter

className - the fully qualified class name of the filter

Returns:

a FilterRegistration object that may be used to further configure the registered filter, or null if this WebappContext already contains a complete FilterRegistration for a filter with the given filterName

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

addServlet

public ServletRegistration addServlet(java.lang.String servletName,
                             java.lang.Class<? extends javax.servlet.Servlet> servletClass)

Adds the servlet with the given name and class type to this servlet context.

The registered servlet may be further configured via the returned ServletRegistration object.

If this WebappContext already contains a preliminary ServletRegistration for a servlet with the given servletName, it will be completed (by assigning the name of the given servletClass to it) and returned.

Specified by:

addServlet in interface javax.servlet.ServletContext

Parameters:

servletName - the name of the servlet

servletClass - the class object from which the servlet will be instantiated

Returns:

a ServletRegistration object that may be used to further configure the registered servlet, or null if this WebappContext already contains a complete ServletRegistration for the given servletName

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

addServlet

public ServletRegistration addServlet(java.lang.String servletName,
                             javax.servlet.Servlet servlet)

Registers the given servlet instance with this WebappContext under the given servletName.

The registered servlet may be further configured via the returned ServletRegistration object.

If this WebappContext already contains a preliminary ServletRegistration for a servlet with the given servletName, it will be completed (by assigning the class name of the given servlet instance to it) and returned.

Specified by:

addServlet in interface javax.servlet.ServletContext

Parameters:

servletName - the name of the servlet

servlet - the servlet instance to register

Returns:

a ServletRegistration object that may be used to further configure the given servlet, or null if this WebappContext already contains a complete ServletRegistration for a servlet with the given servletName or if the same servlet instance has already been registered with this or another WebappContext in the same container

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

java.lang.IllegalArgumentException - if the given servlet instance implements SingleThreadModel

addServlet

public ServletRegistration addServlet(java.lang.String servletName,
                             java.lang.String className)

Adds the servlet with the given name and class name to this servlet context.

The registered servlet may be further configured via the returned ServletRegistration object.

The specified className will be loaded using the classloader associated with the application represented by this WebappContext.

If this WebappContext already contains a preliminary ServletRegistration for a servlet with the given servletName, it will be completed (by assigning the given className to it) and returned.

Specified by:

addServlet in interface javax.servlet.ServletContext

Parameters:

servletName - the name of the servlet

className - the fully qualified class name of the servlet

Returns:

a ServletRegistration object that may be used to further configure the registered servlet, or null if this WebappContext already contains a complete ServletRegistration for a servlet with the given servletName

Throws:

java.lang.IllegalStateException - if this WebappContext has already been initialized

getFilterRegistration

public FilterRegistration getFilterRegistration(java.lang.String name)

Gets the FilterRegistration corresponding to the filter with the given filterName.

Specified by:

getFilterRegistration in interface javax.servlet.ServletContext

Returns:

the (complete or preliminary) FilterRegistration for the filter with the given filterName, or null if no FilterRegistration exists under that name

getFilterRegistrations

public java.util.Map<java.lang.String,? extends FilterRegistration> getFilterRegistrations()

Gets a (possibly empty) Map of the FilterRegistration objects (keyed by filter name) corresponding to all filters registered with this WebappContext.

The returned Map includes the FilterRegistration objects corresponding to all declared and annotated filters, as well as the FilterRegistration objects corresponding to all filters that have been added via one of the addFilter methods.

Any changes to the returned Map must not affect this WebappContext.

Specified by:

getFilterRegistrations in interface javax.servlet.ServletContext

Returns:

Map of the (complete and preliminary) FilterRegistration objects corresponding to all filters currently registered with this WebappContext

getServletRegistration

public ServletRegistration getServletRegistration(java.lang.String name)

Gets the ServletRegistration corresponding to the servlet with the given servletName.

Specified by:

getServletRegistration in interface javax.servlet.ServletContext

Returns:

the (complete or preliminary) ServletRegistration for the servlet with the given servletName, or null if no ServletRegistration exists under that name

getServletRegistrations

public java.util.Map<java.lang.String,? extends ServletRegistration> getServletRegistrations()

Gets a (possibly empty) Map of the ServletRegistration objects (keyed by servlet name) corresponding to all servlets registered with this WebappContext.

The returned Map includes the ServletRegistration objects corresponding to all declared and annotated servlets, as well as the ServletRegistration objects corresponding to all servlets that have been added via one of the addServlet methods.

If permitted, any changes to the returned Map must not affect this WebappContext.

Specified by:

getServletRegistrations in interface javax.servlet.ServletContext

Returns:

Map of the (complete and preliminary) ServletRegistration objects corresponding to all servlets currently registered with this WebappContext

Since:

Servlet 3.0

addListener

public void addListener(java.lang.Class<? extends java.util.EventListener> listenerClass)

Adds the given listener class to this WebappContext.

The given listener must be an instance of one or more of the following interfaces:

• ServletContextAttributeListener
• ServletRequestListener
• ServletRequestAttributeListener
• HttpSessionListener
• HttpSessionAttributeListener

If the given listener is an instance of a listener interface whose invocation order corresponds to the declaration order (i.e., if it is an instance of ServletRequestListener, ServletContextListener, or HttpSessionListener), then the listener will be added to the end of the ordered list of listeners of that interface.

Specified by:

addListener in interface javax.servlet.ServletContext

Throws:

java.lang.IllegalArgumentException - if the given listener is not an instance of any of the above interfaces

java.lang.IllegalStateException - if this WebappContext has already been initialized

addListener

public void addListener(java.lang.String className)

Adds the listener with the given class name to this WebappContext.

The class with the given name will be loaded using the classloader associated with the application represented by this WebappContext, and must implement one or more of the following interfaces:

• ServletContextAttributeListener
• ServletRequestListener
• ServletRequestAttributeListener
• HttpSessionListener
• HttpSessionAttributeListener

As part of this method call, the container must load the class with the specified class name to ensure that it implements one of the required interfaces.

If the class with the given name implements a listener interface whose invocation order corresponds to the declaration order (i.e., if it implements ServletRequestListener, ServletContextListener, or HttpSessionListener), then the new listener will be added to the end of the ordered list of listeners of that interface.

Specified by:

addListener in interface javax.servlet.ServletContext

Parameters:

className - the fully qualified class name of the listener

Throws:

java.lang.IllegalArgumentException - if the class with the given name does not implement any of the above interfaces

java.lang.IllegalStateException - if this WebappContext has already been initialized

addListener

public <T extends java.util.EventListener> void addListener(T eventListener)

Specified by:

addListener in interface javax.servlet.ServletContext

createServlet

public <T extends javax.servlet.Servlet> T createServlet(java.lang.Class<T> clazz)
                                              throws javax.servlet.ServletException

Specified by:

createServlet in interface javax.servlet.ServletContext

Throws:

javax.servlet.ServletException

createFilter

public <T extends javax.servlet.Filter> T createFilter(java.lang.Class<T> clazz)
                                            throws javax.servlet.ServletException

Specified by:

createFilter in interface javax.servlet.ServletContext

Throws:

javax.servlet.ServletException

createListener

public <T extends java.util.EventListener> T createListener(java.lang.Class<T> clazz)
                                                 throws javax.servlet.ServletException

Specified by:

createListener in interface javax.servlet.ServletContext

Throws:

javax.servlet.ServletException

declareRoles

public void declareRoles(java.lang.String... roleNames)

Specified by:

declareRoles in interface javax.servlet.ServletContext

getContextPath

public java.lang.String getContextPath()

Specified by:

getContextPath in interface javax.servlet.ServletContext

getContext

public javax.servlet.ServletContext getContext(java.lang.String uri)

Specified by:

getContext in interface javax.servlet.ServletContext

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface javax.servlet.ServletContext

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface javax.servlet.ServletContext

getEffectiveMajorVersion

public int getEffectiveMajorVersion()

Specified by:

getEffectiveMajorVersion in interface javax.servlet.ServletContext

getEffectiveMinorVersion

public int getEffectiveMinorVersion()

Specified by:

getEffectiveMinorVersion in interface javax.servlet.ServletContext

getMimeType

public java.lang.String getMimeType(java.lang.String file)

Specified by:

getMimeType in interface javax.servlet.ServletContext

getResourcePaths

public java.util.Set<java.lang.String> getResourcePaths(java.lang.String path)

Specified by:

getResourcePaths in interface javax.servlet.ServletContext

getResource

public java.net.URL getResource(java.lang.String path)
                         throws java.net.MalformedURLException

Specified by:

getResource in interface javax.servlet.ServletContext

Throws:

java.net.MalformedURLException

getResourceAsStream

public java.io.InputStream getResourceAsStream(java.lang.String path)

Specified by:

getResourceAsStream in interface javax.servlet.ServletContext

getRequestDispatcher

public javax.servlet.RequestDispatcher getRequestDispatcher(java.lang.String path)

Specified by:

getRequestDispatcher in interface javax.servlet.ServletContext

getNamedDispatcher

public javax.servlet.RequestDispatcher getNamedDispatcher(java.lang.String name)

Specified by:

getNamedDispatcher in interface javax.servlet.ServletContext

getServlet

@Deprecated
public javax.servlet.Servlet getServlet(java.lang.String name)
                                 throws javax.servlet.ServletException

Deprecated.

Specified by:

getServlet in interface javax.servlet.ServletContext

Throws:

javax.servlet.ServletException

getServlets

@Deprecated
public java.util.Enumeration<javax.servlet.Servlet> getServlets()

Deprecated.

Specified by:

getServlets in interface javax.servlet.ServletContext

getServletNames

@Deprecated
public java.util.Enumeration<java.lang.String> getServletNames()

Deprecated.

Specified by:

getServletNames in interface javax.servlet.ServletContext

log

public void log(java.lang.String message)

Specified by:

log in interface javax.servlet.ServletContext

log

@Deprecated
public void log(java.lang.Exception e,
                  java.lang.String message)

Deprecated.

Specified by:

log in interface javax.servlet.ServletContext

log

public void log(java.lang.String message,
       java.lang.Throwable throwable)

Specified by:

log in interface javax.servlet.ServletContext

getRealPath

public java.lang.String getRealPath(java.lang.String path)

Specified by:

getRealPath in interface javax.servlet.ServletContext

getVirtualServerName

public java.lang.String getVirtualServerName()

Specified by:

getVirtualServerName in interface javax.servlet.ServletContext

getServerInfo

public java.lang.String getServerInfo()

Specified by:

getServerInfo in interface javax.servlet.ServletContext

getInitParameter

public java.lang.String getInitParameter(java.lang.String name)

Specified by:

getInitParameter in interface javax.servlet.ServletContext

getInitParameterNames

public java.util.Enumeration<java.lang.String> getInitParameterNames()

Specified by:

getInitParameterNames in interface javax.servlet.ServletContext

setInitParameter

public boolean setInitParameter(java.lang.String name,
                       java.lang.String value)

Specified by:

setInitParameter in interface javax.servlet.ServletContext

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Specified by:

getAttribute in interface javax.servlet.ServletContext

getAttributeNames

public java.util.Enumeration<java.lang.String> getAttributeNames()

Specified by:

getAttributeNames in interface javax.servlet.ServletContext

setAttribute

public void setAttribute(java.lang.String name,
                java.lang.Object value)

Specified by:

setAttribute in interface javax.servlet.ServletContext

removeAttribute

public void removeAttribute(java.lang.String name)

Specified by:

removeAttribute in interface javax.servlet.ServletContext

getServletContextName

public java.lang.String getServletContextName()

Specified by:

getServletContextName in interface javax.servlet.ServletContext

getSessionCookieConfig

public javax.servlet.SessionCookieConfig getSessionCookieConfig()

Specified by:

getSessionCookieConfig in interface javax.servlet.ServletContext

setSessionTrackingModes

public void setSessionTrackingModes(java.util.Set<javax.servlet.SessionTrackingMode> sessionTrackingModes)

Specified by:

setSessionTrackingModes in interface javax.servlet.ServletContext

getDefaultSessionTrackingModes

public java.util.Set<javax.servlet.SessionTrackingMode> getDefaultSessionTrackingModes()

Specified by:

getDefaultSessionTrackingModes in interface javax.servlet.ServletContext

getEffectiveSessionTrackingModes

public java.util.Set<javax.servlet.SessionTrackingMode> getEffectiveSessionTrackingModes()

Specified by:

getEffectiveSessionTrackingModes in interface javax.servlet.ServletContext

getJspConfigDescriptor

public javax.servlet.descriptor.JspConfigDescriptor getJspConfigDescriptor()

Specified by:

getJspConfigDescriptor in interface javax.servlet.ServletContext

getClassLoader

public java.lang.ClassLoader getClassLoader()

Specified by:

getClassLoader in interface javax.servlet.ServletContext

normalize

protected java.lang.String normalize(java.lang.String path)

Return a context-relative path, beginning with a "/", that represents the canonical version of the specified path after ".." and "." elements are resolved out. If the specified path attempts to go outside the boundaries of the current context (i.e. too many ".." path elements are present), return null instead.

Parameters:

path - Path to be normalized

getBasePath

protected java.lang.String getBasePath()

Returns:

setDispatcherHelper

protected void setDispatcherHelper(DispatcherHelper dispatcherHelper)

Parameters:

dispatcherHelper -

getEventListeners

protected java.util.EventListener[] getEventListeners()

Returns:

addFilterMap

protected void addFilterMap(FilterMap filterMap,
                boolean isMatchAfter)

Add a filter mapping to this Context.

Parameters:

filterMap - The filter mapping to be added

isMatchAfter - true if the given filter mapping should be matched against requests after any declared filter mappings of this servlet context, and false if it is supposed to be matched before any declared filter mappings of this servlet context

Throws:

java.lang.IllegalArgumentException - if the specified filter name does not match an existing filter definition, or the filter mapping is malformed

getFilterMaps

protected java.util.List<FilterMap> getFilterMaps()

removeFilterMaps

protected void removeFilterMaps()

Removes any filter mappings from this Context.

getServletNameFilterMappings

protected java.util.Collection<java.lang.String> getServletNameFilterMappings(java.lang.String filterName)

Gets the current servlet name mappings of the Filter with the given name.

getUrlPatternFilterMappings

protected java.util.Collection<java.lang.String> getUrlPatternFilterMappings(java.lang.String filterName)

Gets the current URL pattern mappings of the Filter with the given name.

getFilterChainFactory

protected FilterChainFactory getFilterChainFactory()

unregisterFilter

protected void unregisterFilter(javax.servlet.Filter f)

unregisterAllFilters

protected void unregisterAllFilters()

destroyFilters

protected void destroyFilters()

createServletInstance

protected javax.servlet.Servlet createServletInstance(ServletRegistration registration)
                                               throws java.lang.Exception

Instantiates the given Servlet class.

Returns:

the new Servlet instance

Throws:

java.lang.Exception

createServletInstance

protected javax.servlet.Servlet createServletInstance(java.lang.Class<? extends javax.servlet.Servlet> servletClass)
                                               throws java.lang.Exception

Instantiates the given Servlet class.

Returns:

the new Servlet instance

Throws:

java.lang.Exception

createFilterInstance

protected javax.servlet.Filter createFilterInstance(FilterRegistration registration)
                                             throws java.lang.Exception

Instantiates the given Filter class.

Returns:

the new Filter instance

Throws:

java.lang.Exception

createFilterInstance

protected javax.servlet.Filter createFilterInstance(java.lang.Class<? extends javax.servlet.Filter> filterClass)
                                             throws java.lang.Exception

Instantiates the given Filter class.

Returns:

the new Filter instance

Throws:

java.lang.Exception

createEventListenerInstance

protected java.util.EventListener createEventListenerInstance(java.lang.Class<? extends java.util.EventListener> eventListenerClass)
                                                       throws java.lang.Exception

Instantiates the given EventListener class.

Returns:

the new EventListener instance

Throws:

java.lang.Exception

createEventListenerInstance

protected java.util.EventListener createEventListenerInstance(java.lang.String eventListenerClassname)
                                                       throws java.lang.Exception

Instantiates the given EventListener class.

Returns:

the new EventListener instance

Throws:

java.lang.Exception

createHttpUpgradeHandlerInstance

public <T extends javax.servlet.http.HttpUpgradeHandler> T createHttpUpgradeHandlerInstance(java.lang.Class<T> clazz)
                                                                                 throws java.lang.Exception

Instantiates the given HttpUpgradeHandler class.

Type Parameters:

T -

Parameters:

clazz -

Returns:

a new T instance

Throws:

java.lang.Exception

validateURLPattern

protected boolean validateURLPattern(java.lang.String urlPattern)

Validate the syntax of a proposed <url-pattern> for conformance with specification requirements.

Parameters:

urlPattern - URL pattern to be validated