Field Detail

• myAttributes

  protected java.util.Hashtable<java.lang.String,java.lang.Object> myAttributes

  Servlet context attributes.

• myLogWriter

  protected java.io.PrintWriter myLogWriter

  The log writer we will write log messages to.

• myResourceBaseURL

  protected java.net.URL myResourceBaseURL

  The base URL (document root) for this context.

Constructor Detail

• JspCServletContext

  public JspCServletContext(java.io.PrintWriter aLogWriter,
                            java.net.URL aResourceBaseURL)

  Create a new instance of this ServletContext implementation.

  Parameters:

  aLogWriter - PrintWriter which is used for log() calls

  aResourceBaseURL - Resource base URL

Method Detail

• getAttribute

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

  Return the specified context attribute, if any.

  Specified by:

  getAttribute in interface ServletContext

  Parameters:

  name - Name of the requested attribute

  Returns:

  an Object containing the value of the attribute, or null if no attribute exists matching the given name.

  See Also:

  ServletContext.getAttributeNames()

• getAttributeNames

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

  Return an enumeration of context attribute names.

  Specified by:

  getAttributeNames in interface ServletContext

  Returns:

  an Enumeration of attribute names

  See Also:

  ServletContext.getAttribute(java.lang.String)

• getContextPath

  public java.lang.String getContextPath()

  Returns the context path of the web application.

  Specified by:

  getContextPath in interface ServletContext

  Returns:

  The context path of the web application, or "" for the root context

  See Also:

  HttpServletRequest.getContextPath()

• getContext

  public ServletContext getContext(java.lang.String uripath)

  Return the servlet context for the specified path.

  Specified by:

  getContext in interface ServletContext

  Parameters:

  uripath - Server-relative path starting with '/'

  Returns:

  the ServletContext object that corresponds to the named URL, or null if either none exists or the container wishes to restrict this access.

  See Also:

  RequestDispatcher

• getInitParameter

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

  Return the specified context initialization parameter.

  Specified by:

  getInitParameter in interface ServletContext

  Parameters:

  name - Name of the requested parameter

  Returns:

  a String containing the value of the context's initialization parameter, or null if the context's initialization parameter does not exist.

  See Also:

  ServletConfig.getInitParameter(java.lang.String)

• getInitParameterNames

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

  Return an enumeration of the names of context initialization parameters.

  Specified by:

  getInitParameterNames in interface ServletContext

  Returns:

  an Enumeration of String objects containing the names of the context's initialization parameters

  See Also:

  ServletConfig.getInitParameter(java.lang.String)

• getMajorVersion

  public int getMajorVersion()

  Return the Servlet API major version number.

  Specified by:

  getMajorVersion in interface ServletContext

  Returns:

  4

• getMimeType

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

  Return the MIME type for the specified filename.

  Specified by:

  getMimeType in interface ServletContext

  Parameters:

  file - Filename whose MIME type is requested

  Returns:

  a String specifying the file's MIME type

• getMinorVersion

  public int getMinorVersion()

  Return the Servlet API minor version number.

  Specified by:

  getMinorVersion in interface ServletContext

  Returns:

  0

• getEffectiveMajorVersion

  public int getEffectiveMajorVersion()

  Description copied from interface: ServletContext
  Gets the major version of the Servlet specification that the application represented by this ServletContext is based on.

  The value returned may be different from ServletContext.getMajorVersion(), which returns the major version of the Servlet specification supported by the Servlet container.

  Specified by:

  getEffectiveMajorVersion in interface ServletContext

  Returns:

  the major version of the Servlet specification that the application represented by this ServletContext is based on

• getEffectiveMinorVersion

  public int getEffectiveMinorVersion()

  Description copied from interface: ServletContext
  Gets the minor version of the Servlet specification that the application represented by this ServletContext is based on.

  The value returned may be different from ServletContext.getMinorVersion(), which returns the minor version of the Servlet specification supported by the Servlet container.

  Specified by:

  getEffectiveMinorVersion in interface ServletContext

  Returns:

  the minor version of the Servlet specification that the application represented by this ServletContext is based on

• getNamedDispatcher

  public RequestDispatcher getNamedDispatcher(java.lang.String name)

  Return a request dispatcher for the specified servlet name.

  Specified by:

  getNamedDispatcher in interface ServletContext

  Parameters:

  name - Name of the requested servlet

  Returns:

  a RequestDispatcher object that acts as a wrapper for the named servlet, or null if the ServletContext cannot return a RequestDispatcher

  See Also:

  RequestDispatcher, ServletContext.getContext(java.lang.String), ServletConfig.getServletName()

• getRealPath

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

  Return the real path for the specified context-relative virtual path.

  Specified by:

  getRealPath in interface ServletContext

  Parameters:

  path - The context-relative virtual path to resolve

  Returns:

  the real path, or null if the translation cannot be performed

• getRequestDispatcher

  public RequestDispatcher getRequestDispatcher(java.lang.String path)

  Return a request dispatcher for the specified context-relative path.

  Specified by:

  getRequestDispatcher in interface ServletContext

  Parameters:

  path - Context-relative path for which to acquire a dispatcher

  Returns:

  a RequestDispatcher object that acts as a wrapper for the resource at the specified path, or null if the ServletContext cannot return a RequestDispatcher

  See Also:

  RequestDispatcher, ServletContext.getContext(java.lang.String)

• getResource

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

  Return a URL object of a resource that is mapped to the specified context-relative path.

  Specified by:

  getResource in interface ServletContext

  Parameters:

  path - Context-relative path of the desired resource

  Returns:

  the resource located at the named path, or null if there is no resource at that path

  Throws:

  java.net.MalformedURLException - if the resource path is not properly formed

• getResourceAsStream

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

  Return an InputStream allowing access to the resource at the specified context-relative path.

  Specified by:

  getResourceAsStream in interface ServletContext

  Parameters:

  path - Context-relative path of the desired resource

  Returns:

  the InputStream returned to the servlet, or null if no resource exists at the specified path

• getResourcePaths

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

  Return the set of resource paths for the "directory" at the specified context path.

  Specified by:

  getResourcePaths in interface ServletContext

  Parameters:

  path - Context-relative base path

  Returns:

  a Set containing the directory listing, or null if there are no resources in the web application whose path begins with the supplied path.

• getServerInfo

  public java.lang.String getServerInfo()

  Return descriptive information about this server.

  Specified by:

  getServerInfo in interface ServletContext

  Returns:

  a String containing at least the servlet container name and version number

• getServlet

  public Servlet getServlet(java.lang.String name)
                     throws ServletException

  Deprecated. This method has been deprecated with no replacement
  Return a null reference for the specified servlet name.

  Specified by:

  getServlet in interface ServletContext

  Parameters:

  name - Name of the requested servlet

  Returns:

  the javax.servlet.Servlet Servlet with the given name

  Throws:

  ServletException - if an exception has occurred that interfaces with servlet's normal operation

• getServletContextName

  public java.lang.String getServletContextName()

  Return the name of this servlet context.

  Specified by:

  getServletContextName in interface ServletContext

  Returns:

  The name of the web application or null if no name has been declared in the deployment descriptor.

• getServletNames

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

  Deprecated. This method has been deprecated with no replacement
  Return an empty enumeration of servlet names.

  Specified by:

  getServletNames in interface ServletContext

  Returns:

  an Enumeration of javax.servlet.Servlet Servlet names

• getServlets

  public java.util.Enumeration<Servlet> getServlets()

  Deprecated. This method has been deprecated with no replacement
  Return an empty enumeration of servlets.

  Specified by:

  getServlets in interface ServletContext

  Returns:

  an Enumeration of javax.servlet.Servlet Servlet

• log

  public void log(java.lang.String message)

  Log the specified message.

  Specified by:

  log in interface ServletContext

  Parameters:

  message - The message to be logged

• log

  public void log(java.lang.Exception exception,
                  java.lang.String message)

  Deprecated. Use log(String,Throwable) instead
  Log the specified message and exception.

  Specified by:

  log in interface ServletContext

  Parameters:

  exception - The exception to be logged

  message - The message to be logged

• log

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

  Log the specified message and exception.

  Specified by:

  log in interface ServletContext

  Parameters:

  message - The message to be logged

  exception - The exception to be logged

• removeAttribute

  public void removeAttribute(java.lang.String name)

  Remove the specified context attribute.

  Specified by:

  removeAttribute in interface ServletContext

  Parameters:

  name - Name of the attribute to remove

• setAttribute

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

  Set or replace the specified context attribute.

  Specified by:

  setAttribute in interface ServletContext

  Parameters:

  name - Name of the context attribute to set

  value - Corresponding attribute value

• addServlet

  public void addServlet(java.lang.String servletName,
                         java.lang.String description,
                         java.lang.String className,
                         java.util.Map<java.lang.String,java.lang.String> initParameters,
                         int loadOnStartup)

• addServletMapping

  public void addServletMapping(java.lang.String servletName,
                                java.lang.String[] urlPatterns)

  Adds servlet mappings from the given url patterns to the servlet with the given servlet name to this servlet context.

• addFilter

  public void addFilter(java.lang.String filterName,
                        java.lang.String description,
                        java.lang.String className,
                        java.util.Map<java.lang.String,java.lang.String> initParameters)

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

• setInitParameter

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

  Description copied from interface: ServletContext
  Sets the context initialization parameter with the given name and value on this ServletContext.

  Specified by:

  setInitParameter in interface ServletContext

  Parameters:

  name - the name of the context initialization parameter to set

  value - the value of the context initialization parameter to set

  Returns:

  true if the context initialization parameter with the given name and value was set successfully on this ServletContext, and false if it was not set because this ServletContext already contains a context initialization parameter with a matching name

• addServlet

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

  Description copied from interface: ServletContext
  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 ServletContext.

  If this ServletContext 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.

  This method introspects the class with the given className for the ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, and javax.annotation.security.DeclareRoles annotations. In addition, this method supports resource injection if the class with the given className represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addServlet in interface 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 ServletContext already contains a complete ServletRegistration for a servlet with the given servletName

• addServlet

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

  Description copied from interface: ServletContext
  Registers the given servlet instance with this ServletContext under the given servletName.

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

  If this ServletContext 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 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 ServletContext 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 ServletContext in the same container

• addServlet

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

  Description copied from interface: ServletContext
  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 ServletContext 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.

  This method introspects the given servletClass for the ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, and javax.annotation.security.DeclareRoles annotations. In addition, this method supports resource injection if the given servletClass represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addServlet in interface 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 ServletContext already contains a complete ServletRegistration for the given servletName

• createServlet

  public <T extends Servlet> T createServlet(java.lang.Class<T> c)
                                      throws ServletException

  Description copied from interface: ServletContext
  Instantiates the given Servlet class.

  The returned Servlet instance may be further customized before it is registered with this ServletContext via a call to ServletContext.addServlet(String,Servlet).

  The given Servlet class must define a zero argument constructor, which is used to instantiate it.

  This method introspects the given clazz for the following annotations: ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, and javax.annotation.security.DeclareRoles. In addition, this method supports resource injection if the given clazz represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  createServlet in interface ServletContext

  Type Parameters:

  T - the class of the Servlet to create

  Parameters:

  c - the Servlet class to instantiate

  Returns:

  the new Servlet instance

  Throws:

  ServletException - if the given clazz fails to be instantiated

• getServletRegistration

  public ServletRegistration getServletRegistration(java.lang.String servletName)

  Description copied from interface: ServletContext
  Gets the ServletRegistration corresponding to the servlet with the given servletName.

  Specified by:

  getServletRegistration in interface ServletContext

  Parameters:

  servletName - the name of a servlet

  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,ServletRegistration> getServletRegistrations()

  Description copied from interface: ServletContext
  Gets a (possibly empty) Map of the ServletRegistration objects (keyed by servlet name) corresponding to all servlets registered with this ServletContext.

  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 and addJspFile methods.

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

  Specified by:

  getServletRegistrations in interface ServletContext

  Returns:

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

• addFilter

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

  Description copied from interface: ServletContext
  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 ServletContext.

  If this ServletContext 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.

  This method supports resource injection if the class with the given className represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addFilter in interface 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 ServletContext already contains a complete FilterRegistration for a filter with the given filterName

• addFilter

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

  Description copied from interface: ServletContext
  Registers the given filter instance with this ServletContext under the given filterName.

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

  If this ServletContext 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 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 ServletContext 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 ServletContext in the same container

• addFilter

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

  Description copied from interface: ServletContext
  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 ServletContext 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.

  This method supports resource injection if the given filterClass represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addFilter in interface 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 ServletContext already contains a complete FilterRegistration for a filter with the given filterName

• createFilter

  public <T extends Filter> T createFilter(java.lang.Class<T> c)

  Description copied from interface: ServletContext
  Instantiates the given Filter class.

  The returned Filter instance may be further customized before it is registered with this ServletContext via a call to ServletContext.addFilter(String,Filter).

  The given Filter class must define a zero argument constructor, which is used to instantiate it.

  This method supports resource injection if the given clazz represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  createFilter in interface ServletContext

  Type Parameters:

  T - the class of the Filter to create

  Parameters:

  c - the Filter class to instantiate

  Returns:

  the new Filter instance

• getFilterRegistration

  public FilterRegistration getFilterRegistration(java.lang.String filterName)

  Description copied from interface: ServletContext
  Gets the FilterRegistration corresponding to the filter with the given filterName.

  Specified by:

  getFilterRegistration in interface ServletContext

  Parameters:

  filterName - the name of a filter

  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,FilterRegistration> getFilterRegistrations()

  Description copied from interface: ServletContext
  Gets a (possibly empty) Map of the FilterRegistration objects (keyed by filter name) corresponding to all filters registered with this ServletContext.

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

  Specified by:

  getFilterRegistrations in interface ServletContext

  Returns:

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

• getSessionCookieConfig

  public SessionCookieConfig getSessionCookieConfig()

  Description copied from interface: ServletContext
  Gets the SessionCookieConfig object through which various properties of the session tracking cookies created on behalf of this ServletContext may be configured.

  Repeated invocations of this method will return the same SessionCookieConfig instance.

  Specified by:

  getSessionCookieConfig in interface ServletContext

  Returns:

  the SessionCookieConfig object through which various properties of the session tracking cookies created on behalf of this ServletContext may be configured

• setSessionTrackingModes

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

  Description copied from interface: ServletContext
  Sets the session tracking modes that are to become effective for this ServletContext.

  The given sessionTrackingModes replaces any session tracking modes set by a previous invocation of this method on this ServletContext.

  Specified by:

  setSessionTrackingModes in interface ServletContext

  Parameters:

  sessionTrackingModes - the set of session tracking modes to become effective for this ServletContext

• getDefaultSessionTrackingModes

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

  Description copied from interface: ServletContext
  Gets the session tracking modes that are supported by default for this ServletContext.

  The returned set is not backed by the ServletContext object, so changes in the returned set are not reflected in the ServletContext object, and vice-versa.

  Specified by:

  getDefaultSessionTrackingModes in interface ServletContext

  Returns:

  set of the session tracking modes supported by default for this ServletContext

• getEffectiveSessionTrackingModes

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

  Description copied from interface: ServletContext
  Gets the session tracking modes that are in effect for this ServletContext.

  The session tracking modes in effect are those provided to setSessionTrackingModes.

  The returned set is not backed by the ServletContext object, so changes in the returned set are not reflected in the ServletContext object, and vice-versa.

  Specified by:

  getEffectiveSessionTrackingModes in interface ServletContext

  Returns:

  set of the session tracking modes in effect for this ServletContext

• addListener

  public void addListener(java.lang.String className)

  Description copied from interface: ServletContext
  Adds the listener with the given class name to this ServletContext.

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

  • ServletContextAttributeListener
  • ServletRequestListener
  • ServletRequestAttributeListener
  • HttpSessionAttributeListener
  • HttpSessionIdListener
  • HttpSessionListener

  If this ServletContext was passed to ServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext), then the class with the given name may also implement ServletContextListener, in addition to the interfaces listed above.

  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.

  This method supports resource injection if the class with the given className represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addListener in interface ServletContext

  Parameters:

  className - the fully qualified class name of the listener

• addListener

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

  Description copied from interface: ServletContext
  Adds the given listener to this ServletContext.

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

  • ServletContextAttributeListener
  • ServletRequestListener
  • ServletRequestAttributeListener
  • HttpSessionAttributeListener
  • HttpSessionIdListener
  • HttpSessionListener

  If this ServletContext was passed to ServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext), then the given listener may also be an instance of ServletContextListener, in addition to the interfaces listed above.

  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 ServletContext

  Type Parameters:

  T - the class of the EventListener to add

  Parameters:

  t - the listener to be added

• addListener

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

  Description copied from interface: ServletContext
  Adds a listener of the given class type to this ServletContext.

  The given listenerClass must implement one or more of the following interfaces:

  • ServletContextAttributeListener
  • ServletRequestListener
  • ServletRequestAttributeListener
  • HttpSessionAttributeListener
  • HttpSessionIdListener
  • HttpSessionListener

  If this ServletContext was passed to ServletContainerInitializer.onStartup(java.util.Set<java.lang.Class<?>>, javax.servlet.ServletContext), then the given listenerClass may also implement ServletContextListener, in addition to the interfaces listed above.

  If the given listenerClass 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.

  This method supports resource injection if the given listenerClass represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  addListener in interface ServletContext

  Parameters:

  listenerClass - the listener class to be instantiated

• createListener

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

  Description copied from interface: ServletContext
  Instantiates the given EventListener class.

  The specified EventListener class must implement at least one of the ServletContextListener, ServletContextAttributeListener, ServletRequestListener, ServletRequestAttributeListener, HttpSessionAttributeListener, HttpSessionIdListener, or HttpSessionListener interfaces.

  The returned EventListener instance may be further customized before it is registered with this ServletContext via a call to ServletContext.addListener(EventListener).

  The given EventListener class must define a zero argument constructor, which is used to instantiate it.

  This method supports resource injection if the given clazz represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

  Specified by:

  createListener in interface ServletContext

  Type Parameters:

  T - the class of the EventListener to create

  Parameters:

  clazz - the EventListener class to instantiate

  Returns:

  the new EventListener instance

  Throws:

  ServletException - if the given clazz fails to be instantiated

• getJspConfigDescriptor

  public JspConfigDescriptor getJspConfigDescriptor()

  Description copied from interface: ServletContext
  Gets the <jsp-config> related configuration that was aggregated from the web.xml and web-fragment.xml descriptor files of the web application represented by this ServletContext.

  Specified by:

  getJspConfigDescriptor in interface ServletContext

  Returns:

  the <jsp-config> related configuration that was aggregated from the web.xml and web-fragment.xml descriptor files of the web application represented by this ServletContext, or null if no such configuration exists

  See Also:

  JspConfigDescriptor

• getClassLoader

  public java.lang.ClassLoader getClassLoader()

  Description copied from interface: ServletContext
  Gets the class loader of the web application represented by this ServletContext.

  If a security manager exists, and the caller's class loader is not the same as, or an ancestor of the requested class loader, then the security manager's checkPermission method is called with a RuntimePermission("getClassLoader") permission to check whether access to the requested class loader should be granted.

  Specified by:

  getClassLoader in interface ServletContext

  Returns:

  the class loader of the web application represented by this ServletContext

• declareRoles

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

  Description copied from interface: ServletContext
  Declares role names that are tested using isUserInRole.

  Roles that are implicitly declared as a result of their use within the setServletSecurity or setRunAsRole methods of the ServletRegistration interface need not be declared.

  Specified by:

  declareRoles in interface ServletContext

  Parameters:

  roleNames - the role names being declared