public class StandardContext extends ContainerBase implements Context, NotificationEmitter
ContainerBase.ContainerBackgroundProcessor, ContainerBase.PrivilegedAddChild| Modifier and Type | Field and Description |
|---|---|
protected boolean |
allowCasualMultipartParsing
Allow multipart/form-data requests to be parsed even when the
target servlet doesn't specify @MultipartConfig or have a
<multipart-config> element.
|
protected ApplicationContext |
context
The ServletContext implementation associated with this Context.
|
protected static ThreadBindingListener |
DEFAULT_NAMING_LISTENER |
protected Manager |
manager
The Manager implementation with which this Container is associated.
|
protected ThreadBindingListener |
threadBindingListener |
accessLog, backgroundProcessorDelay, children, cluster, listeners, logger, logName, name, parent, parentClassLoader, pipeline, sm, startChildren, startStopExecutor, supportmserverADD_WELCOME_FILE_EVENT, CHANGE_SESSION_ID_EVENT, CLEAR_WELCOME_FILES_EVENT, REMOVE_WELCOME_FILE_EVENTADD_CHILD_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_VALVE_EVENTAFTER_DESTROY_EVENT, AFTER_INIT_EVENT, AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_DESTROY_EVENT, BEFORE_INIT_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, CONFIGURE_START_EVENT, CONFIGURE_STOP_EVENT, PERIODIC_EVENT, START_EVENT, STOP_EVENT| Constructor and Description |
|---|
StandardContext()
Create a new StandardContext component with the default basic Valve.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addApplicationEventListener(Object listener)
Add a listener to the end of the list of initialized application event
listeners.
|
void |
addApplicationLifecycleListener(Object listener)
Add a listener to the end of the list of initialized application
lifecycle listeners.
|
void |
addApplicationListener(String listener)
Add a new Listener class name to the set of Listeners
configured for this application.
|
void |
addApplicationParameter(ApplicationParameter parameter)
Add a new application parameter for this application.
|
void |
addChild(Container child)
Add a child Container, only if the proposed child is an implementation
of Wrapper.
|
void |
addConstraint(SecurityConstraint constraint)
Add a security constraint to the set for this web application.
|
void |
addErrorPage(ErrorPage errorPage)
Add an error page for the specified error or Java exception.
|
void |
addFilterDef(FilterDef filterDef)
Add a filter definition to this Context.
|
void |
addFilterMap(FilterMap filterMap)
Add a filter mapping to this Context at the end of the current set
of filter mappings.
|
void |
addFilterMapBefore(FilterMap filterMap)
Add a filter mapping to this Context before the mappings defined in the
deployment descriptor but after any other mappings added via this method.
|
void |
addInstanceListener(String listener)
Add the classname of an InstanceListener to be added to each
Wrapper appended to this Context.
|
void |
addLocaleEncodingMappingParameter(String locale,
String encoding)
Add a Locale Encoding Mapping (see Sec 5.4 of Servlet spec 2.4)
|
void |
addMessageDestination(MessageDestination md)
Add a message destination for this web application.
|
void |
addMessageDestinationRef(MessageDestinationRef mdr)
Add a message destination reference for this web application.
|
void |
addMimeMapping(String extension,
String mimeType)
Add a new MIME mapping, replacing any existing mapping for
the specified extension.
|
void |
addNotificationListener(NotificationListener listener,
NotificationFilter filter,
Object object) |
void |
addParameter(String name,
String value)
Add a new context initialization parameter.
|
void |
addPostConstructMethod(String clazz,
String method)
Add a post construct method definition for the given class, if there is
an existing definition for the specified class - IllegalArgumentException
will be thrown.
|
void |
addPreDestroyMethod(String clazz,
String method)
Add a pre destroy method definition for the given class, if there is an
existing definition for the specified class - IllegalArgumentException
will be thrown.
|
void |
addRoleMapping(String role,
String link)
Add a security role reference for this web application.
|
void |
addSecurityRole(String role)
Add a new security role for this web application.
|
void |
addServletContainerInitializer(ServletContainerInitializer sci,
Set<Class<?>> classes)
Add a ServletContainerInitializer instance to this web application.
|
void |
addServletMapping(String pattern,
String name)
Add a new servlet mapping, replacing any existing mapping for
the specified pattern.
|
void |
addServletMapping(String pattern,
String name,
boolean jspWildCard)
Add a new servlet mapping, replacing any existing mapping for
the specified pattern.
|
Set<String> |
addServletSecurity(ServletRegistration.Dynamic registration,
ServletSecurityElement servletSecurityElement)
Notification that servlet security has been dynamically set in a
ServletRegistration.Dynamic |
void |
addWatchedResource(String name)
Add a new watched resource to the set recognized by this Context.
|
void |
addWelcomeFile(String name)
Add a new welcome file to the set recognized by this Context.
|
void |
addWrapperLifecycle(String listener)
Add the classname of a LifecycleListener to be added to each
Wrapper appended to this Context.
|
void |
addWrapperListener(String listener)
Add the classname of a ContainerListener to be added to each
Wrapper appended to this Context.
|
protected String |
adjustURLPattern(String urlPattern)
Adjust the URL pattern to begin with a leading slash, if appropriate
(i.e. we are running a servlet 2.2 application).
|
void |
backgroundProcess()
Execute a periodic task, such as reloading, etc.
|
ClassLoader |
bind(boolean usePrivilegedAction,
ClassLoader originalClassLoader)
Change the current thread context class loader to the web application
class loader.
|
protected ClassLoader |
bindThread()
Bind current thread, both for CL purposes and for JNDI ENC support
during : startup, shutdown and realoading of the context.
|
Wrapper |
createWrapper()
Factory method to create and return a new Wrapper instance, of
the Java implementation class appropriate for this Context
implementation.
|
protected void |
destroyInternal()
Destroy needs to clean up the context completely.
|
ServletRegistration.Dynamic |
dynamicServletAdded(Wrapper wrapper)
hook to register that we need to scan for security annotations.
|
void |
dynamicServletCreated(Servlet servlet)
hook to track which registrations need annotation scanning
|
boolean |
filterStart()
Configure and initialize the set of filters for this Context.
|
boolean |
filterStop()
Finalize and release the set of filters for this Context.
|
String[] |
findApplicationListeners()
Return the set of application listener class names configured
for this application.
|
ApplicationParameter[] |
findApplicationParameters()
Return the set of application parameters for this application.
|
SecurityConstraint[] |
findConstraints()
Return the security constraints for this web application.
|
ErrorPage |
findErrorPage(int errorCode)
Return the error page entry for the specified HTTP error code,
if any; otherwise return
null. |
ErrorPage |
findErrorPage(String exceptionType)
Return the error page entry for the specified Java exception type,
if any; otherwise return
null. |
ErrorPage[] |
findErrorPages()
Return the set of defined error pages for all specified error codes
and exception types.
|
FilterConfig |
findFilterConfig(String name)
Find and return the initialized
FilterConfig for the
specified filter name, if any; otherwise return null. |
FilterDef |
findFilterDef(String filterName)
Return the filter definition for the specified filter name, if any;
otherwise return
null. |
FilterDef[] |
findFilterDefs()
Return the set of defined filters for this Context.
|
FilterMap[] |
findFilterMaps()
Return the set of filter mappings for this Context.
|
String[] |
findInstanceListeners()
Return the set of InstanceListener classes that will be added to
newly created Wrappers automatically.
|
MessageDestination |
findMessageDestination(String name)
Return the message destination with the specified name, if any;
otherwise, return
null. |
MessageDestinationRef |
findMessageDestinationRef(String name)
Return the message destination ref with the specified name, if any;
otherwise, return
null. |
MessageDestinationRef[] |
findMessageDestinationRefs()
Return the set of defined message destination refs for this web
application.
|
MessageDestination[] |
findMessageDestinations()
Return the set of defined message destinations for this web
application.
|
String |
findMimeMapping(String extension)
Return the MIME type to which the specified extension is mapped,
if any; otherwise return
null. |
String[] |
findMimeMappings()
Return the extensions for which MIME mappings are defined.
|
String |
findParameter(String name)
Return the value for the specified context initialization
parameter name, if any; otherwise return
null. |
String[] |
findParameters()
Return the names of all defined context initialization parameters
for this Context.
|
String |
findPostConstructMethod(String clazz)
Returns the method name that is specified as post construct method for
the given class, if it exists; otherwise
NULL will be
returned. |
Map<String,String> |
findPostConstructMethods()
Returns a map with keys - fully qualified class names of the classes that
have post construct methods and the values are the corresponding method
names.
|
String |
findPreDestroyMethod(String clazz)
Returns the method name that is specified as pre destroy method for the
given class, if it exists; otherwise
NULL will be returned. |
Map<String,String> |
findPreDestroyMethods()
Returns a map with keys - fully qualified class names of the classes that
have pre destroy methods and the values are the corresponding method
names.
|
String |
findRoleMapping(String role)
For the given security role (as used by an application), return the
corresponding role name (as defined by the underlying Realm) if there
is one.
|
boolean |
findSecurityRole(String role)
Return
true if the specified security role is defined
for this application; otherwise return false. |
String[] |
findSecurityRoles()
Return the security roles defined for this application.
|
String |
findServletMapping(String pattern)
Return the servlet name mapped by the specified pattern (if any);
otherwise return
null. |
String[] |
findServletMappings()
Return the patterns of all defined servlet mappings for this
Context.
|
String |
findStatusPage(int status)
Return the context-relative URI of the error page for the specified
HTTP status code, if any; otherwise return
null. |
int[] |
findStatusPages()
Return the set of HTTP status codes for which error pages have
been specified.
|
String[] |
findWatchedResources()
Return the set of watched resources for this Context.
|
boolean |
findWelcomeFile(String name)
Return
true if the specified welcome file is defined
for this Context; otherwise return false. |
String[] |
findWelcomeFiles()
Return the set of welcome files defined for this Context.
|
String[] |
findWrapperLifecycles()
Return the set of LifecycleListener classes that will be added to
newly created Wrappers automatically.
|
String[] |
findWrapperListeners()
Return the set of ContainerListener classes that will be added to
newly created Wrappers automatically.
|
boolean |
fireRequestDestroyEvent(ServletRequest request)
Notify all
ServletRequestListeners that a request
has ended. |
boolean |
fireRequestInitEvent(ServletRequest request)
Notify all
ServletRequestListeners that a request
has started. |
boolean |
getAddWebinfClassesResources()
Gets the flag that indicates if /WEB-INF/classes should be treated like
an exploded JAR and JAR resources made available as if they were in a
JAR.
|
boolean |
getAllowCasualMultipartParsing()
Returns
true if requests mapped to servlets without
"multipart config" to parse multipart/form-data requests anyway. |
String |
getAltDDName()
Return the alternate Deployment Descriptor name.
|
boolean |
getAntiResourceLocking()
Return the antiResourceLocking flag for this Context.
|
Object[] |
getApplicationEventListeners()
Obtain the registered application event listeners.
|
Object[] |
getApplicationLifecycleListeners()
Obtain the registered application lifecycle listeners.
|
Authenticator |
getAuthenticator()
Obtain the
Authenticator that is used by this context or
null if none is used. |
String |
getBaseName()
Return the base name to use for WARs, directories or context.xml files
for this context.
|
String |
getCharset(Locale locale)
Obtain the character set name to use with the given Locale.
|
CharsetMapper |
getCharsetMapper()
Return the Locale to character set mapper for this Context.
|
String |
getCharsetMapperClass()
Return the Locale to character set mapper class for this Context.
|
boolean |
getClearReferencesHttpClientKeepAliveThread()
Return the clearReferencesHttpClientKeepAliveThread flag for this
Context.
|
boolean |
getClearReferencesStatic()
Return the clearReferencesStatic flag for this Context.
|
boolean |
getClearReferencesStopThreads()
Return the clearReferencesStopThreads flag for this Context.
|
boolean |
getClearReferencesStopTimerThreads()
Return the clearReferencesStopTimerThreads flag for this Context.
|
protected boolean |
getComputedFailCtxIfServletStartFails() |
URL |
getConfigFile()
Return the URL of the XML descriptor for this context.
|
boolean |
getConfigured()
Return the "correctly configured" flag for this Context.
|
String |
getContainerSciFilter()
Obtains the regular expression that specifies which container provided
SCIs should be filtered out and not used for this context.
|
CookieProcessor |
getCookieProcessor()
Obtains the
CookieProcessor that will be used to process cookies
for this Context. |
boolean |
getCookies()
Return the "use cookies for session ids" flag.
|
boolean |
getCopyXML() |
boolean |
getCrossContext()
Return the "allow crossing servlet contexts" flag.
|
String |
getDefaultContextXml() |
String |
getDefaultWebXml() |
boolean |
getDelegate()
Return the "follow standard delegation model" flag used to configure
our ClassLoader.
|
boolean |
getDenyUncoveredHttpMethods()
Return the deny-uncovered-http-methods flag for this web application.
|
String |
getDeploymentDescriptor()
JSR77 deploymentDescriptor attribute
|
String |
getDisplayName()
Return the display name of this web application.
|
boolean |
getDistributable()
Return the distributable flag for this web application.
|
String |
getDocBase()
Return the document root for this Context.
|
int |
getEffectiveMajorVersion()
Return the effective major version of the Servlet spec used by this
context.
|
int |
getEffectiveMinorVersion()
Return the effective minor version of the Servlet spec used by this
context.
|
String |
getEncodedPath()
Return the URL encoded context path, using UTF-8.
|
int |
getErrorCount()
Gets the cumulative error count of all servlets in this
StandardContext.
|
Boolean |
getFailCtxIfServletStartFails() |
boolean |
getFireRequestListenersOnForwards()
Determine whether or not requests listeners will be fired on forwards for
this Context.
|
boolean |
getIgnoreAnnotations()
Return the boolean on the annotations parsing.
|
InstanceManager |
getInstanceManager()
Get the instance manager associated with this context.
|
String |
getJ2EEApplication() |
String |
getJ2EEServer() |
JarScanner |
getJarScanner()
Get the Jar Scanner to be used to scan for JAR resources for this
context.
|
String[] |
getJavaVMs() |
boolean |
getJndiExceptionOnFailedWrite()
Returns whether or not an attempt to modify the JNDI context will trigger
an exception or if the request will be ignored.
|
JspConfigDescriptor |
getJspConfigDescriptor()
Obtain the JSP configuration for this context.
|
Loader |
getLoader()
Return the Loader with which this Context is associated.
|
boolean |
getLogEffectiveWebXml()
Should the effective web.xml for this context be logged on context start?
|
LoginConfig |
getLoginConfig()
Return the login configuration descriptor for this web application.
|
Manager |
getManager()
Return the Manager with which this Context is associated.
|
long |
getMaxTime()
Gets the maximum processing time of all servlets in this
StandardContext.
|
long |
getMinTime()
Gets the minimum processing time of all servlets in this
StandardContext.
|
NamingContextListener |
getNamingContextListener()
Naming context listener accessor.
|
NamingResourcesImpl |
getNamingResources()
Return the naming resources associated with this web application.
|
Object |
getNamingToken()
Obtain the token necessary for operations on the associated JNDI naming
context.
|
MBeanNotificationInfo[] |
getNotificationInfo() |
protected String |
getObjectNameKeyProperties()
Allow sub-classes to specify the key properties component of the
ObjectName that will be used to register this component. |
String |
getOriginalDocBase()
Return the original document root for this Context.
|
boolean |
getOverride()
Return the default context override flag for this web application.
|
ClassLoader |
getParentClassLoader()
Return the parent class loader (if any) for this web application.
|
String |
getPath()
Return the context path for this Context.
|
boolean |
getPaused()
Return the request processing paused flag for this Context.
|
boolean |
getPreemptiveAuthentication()
Determines if a user presents authentication credentials, will the
context will process them when the request is for a non-protected
resource.
|
boolean |
getPrivileged()
Return the privileged flag for this web application.
|
long |
getProcessingTime()
Gets the cumulative processing times of all servlets in this
StandardContext.
|
String |
getPublicId()
Return the public identifier of the deployment descriptor DTD that is
currently being parsed.
|
String |
getRealPath(String path)
Return the real path for a given virtual path, if possible; otherwise
return
null. |
boolean |
getReloadable()
Return the reloadable flag for this web application.
|
boolean |
getRenewThreadsWhenStoppingContext() |
int |
getRequestCount()
Gets the cumulative request count of all servlets in this
StandardContext.
|
String |
getResourceOnlyServlets()
Obtains the list of Servlets that expect a resource to be present.
|
WebResourceRoot |
getResources()
Return the Resources with which this Context is associated.
|
boolean |
getSendRedirectBody()
Determines if the context is configured to include a response body as
part of a redirect response.
|
String |
getServer() |
ServletContext |
getServletContext()
Return the servlet context for which this Context is a facade.
|
String[] |
getServlets()
JSR77 servlets attribute
|
String |
getSessionCookieDomain()
Gets the domain to use for session cookies.
|
String |
getSessionCookieName()
Gets the name to use for session cookies.
|
String |
getSessionCookiePath()
Gets the path to use for session cookies.
|
boolean |
getSessionCookiePathUsesTrailingSlash()
Is a / added to the end of the session cookie path to ensure browsers,
particularly IE, don't send a session cookie for context /foo with
requests intended for context /foobar.
|
int |
getSessionTimeout()
Return the default session timeout (in minutes) for this
web application.
|
long |
getStartTime()
Gets the time this context was started.
|
long |
getStartupTime()
Gets the time (in milliseconds) it took to start this context.
|
boolean |
getSwallowAbortedUploads()
Returns
true if remaining request data will be read
(swallowed) even the request violates a data size constraint. |
boolean |
getSwallowOutput()
Return the value of the swallowOutput flag.
|
ThreadBindingListener |
getThreadBindingListener()
Get the associated ThreadBindingListener.
|
long |
getTldScanTime() |
boolean |
getTldValidation()
Will the parsing of *.tld files for this Context be performed by a
validating parser?
|
long |
getUnloadDelay()
Return the value of the unloadDelay flag.
|
boolean |
getUnpackWAR()
Unpack WAR flag accessor.
|
boolean |
getUseHttpOnly()
Gets the value of the use HttpOnly cookies for session cookies flag.
|
String |
getWebappVersion()
Set the version of this web application - used to differentiate
different versions of the same web application when using parallel
deployment.
|
String[] |
getWelcomeFiles()
Return the naming resources associated with this web application.
|
String |
getWorkDir()
Return the work directory for this Context.
|
String |
getWorkPath()
Get the absolute path to the work dir.
|
String |
getWrapperClass()
Return the Java class name of the Wrapper implementation used
for servlets registered in this Context.
|
boolean |
getXmlBlockExternal()
Will the parsing of web.xml, web-fragment.xml, *.tld, *.jspx, *.tagx and
tagplugin.xml files for this Context block the use of external entities?
|
boolean |
getXmlNamespaceAware()
Will the parsing of web.xml and web-fragment.xml files for this Context
be performed by a namespace aware parser?
|
boolean |
getXmlValidation()
Will the parsing of web.xml and web-fragment.xml files for this Context
be performed by a validating parser?
|
protected void |
initInternal()
Sub-classes wishing to perform additional initialization should override
this method, ensuring that super.initInternal() is the first call in the
overriding method.
|
boolean |
isResourceOnlyServlet(String servletName)
Checks the named Servlet to see if it expects a resource to be present.
|
boolean |
isServlet22()
Are we processing a version 2.2 deployment descriptor?
|
boolean |
isStateManageable()
Support for "stateManageable" JSR77
|
boolean |
isUseNaming()
Returns true if the internal naming support is used.
|
boolean |
listenerStart()
Configure the set of instantiated application event listeners
for this Context.
|
boolean |
listenerStop()
Send an application stop event to all interested listeners.
|
boolean |
loadOnStartup(Container[] children)
Load and initialize all servlets marked "load on startup" in the
web application deployment descriptor.
|
void |
reload()
Reload this web application, if reloading is supported.
|
void |
removeApplicationListener(String listener)
Remove the specified application listener class from the set of
listeners for this application.
|
void |
removeApplicationParameter(String name)
Remove the application parameter with the specified name from
the set for this application.
|
void |
removeChild(Container child)
Add a child Container, only if the proposed child is an implementation
of Wrapper.
|
void |
removeConstraint(SecurityConstraint constraint)
Remove the specified security constraint from this web application.
|
void |
removeErrorPage(ErrorPage errorPage)
Remove the error page for the specified error code or
Java language exception, if it exists; otherwise, no action is taken.
|
void |
removeFilterDef(FilterDef filterDef)
Remove the specified filter definition from this Context, if it exists;
otherwise, no action is taken.
|
void |
removeFilterMap(FilterMap filterMap)
Remove a filter mapping from this Context.
|
void |
removeInstanceListener(String listener)
Remove a class name from the set of InstanceListener classes that
will be added to newly created Wrappers.
|
void |
removeMessageDestination(String name)
Remove any message destination with the specified name.
|
void |
removeMessageDestinationRef(String name)
Remove any message destination ref with the specified name.
|
void |
removeMimeMapping(String extension)
Remove the MIME mapping for the specified extension, if it exists;
otherwise, no action is taken.
|
void |
removeNotificationListener(NotificationListener listener)
Remove a JMX-NotificationListener
|
void |
removeNotificationListener(NotificationListener listener,
NotificationFilter filter,
Object object) |
void |
removeParameter(String name)
Remove the context initialization parameter with the specified
name, if it exists; otherwise, no action is taken.
|
void |
removePostConstructMethod(String clazz)
Removes the post construct method definition for the given class, if it
exists; otherwise, no action is taken.
|
void |
removePreDestroyMethod(String clazz)
Removes the pre destroy method definition for the given class, if it
exists; otherwise, no action is taken.
|
void |
removeRoleMapping(String role)
Remove any security role reference for the specified name
|
void |
removeSecurityRole(String role)
Remove any security role with the specified name.
|
void |
removeServletMapping(String pattern)
Remove any servlet mapping for the specified pattern, if it exists;
otherwise, no action is taken.
|
void |
removeWatchedResource(String name)
Remove the specified watched resource name from the list associated
with this Context.
|
void |
removeWelcomeFile(String name)
Remove the specified welcome file name from the list recognized
by this Context.
|
void |
removeWrapperLifecycle(String listener)
Remove a class name from the set of LifecycleListener classes that
will be added to newly created Wrappers.
|
void |
removeWrapperListener(String listener)
Remove a class name from the set of ContainerListener classes that
will be added to newly created Wrappers.
|
void |
resourcesStart()
Allocate resources, including proxy.
|
boolean |
resourcesStop()
Deallocate resources and destroy proxy.
|
void |
setAddWebinfClassesResources(boolean addWebinfClassesResources)
Sets the flag that indicates if /WEB-INF/classes should be treated like
an exploded JAR and JAR resources made available as if they were in a
JAR.
|
void |
setAllowCasualMultipartParsing(boolean allowCasualMultipartParsing)
Set to
true to allow requests mapped to servlets that
do not explicitly declare @MultipartConfig or have
<multipart-config> specified in web.xml to parse
multipart/form-data requests. |
void |
setAltDDName(String altDDName)
Set an alternate Deployment Descriptor name.
|
void |
setAntiResourceLocking(boolean antiResourceLocking)
Set the antiResourceLocking feature for this Context.
|
void |
setApplicationEventListeners(Object[] listeners)
Store the set of initialized application event listener objects,
in the order they were specified in the web application deployment
descriptor, for this application.
|
void |
setApplicationLifecycleListeners(Object[] listeners)
Store the set of initialized application lifecycle listener objects,
in the order they were specified in the web application deployment
descriptor, for this application.
|
void |
setCharsetMapper(CharsetMapper mapper)
Set the Locale to character set mapper for this Context.
|
void |
setCharsetMapperClass(String mapper)
Set the Locale to character set mapper class for this Context.
|
void |
setClearReferencesHttpClientKeepAliveThread(boolean clearReferencesHttpClientKeepAliveThread)
Set the clearReferencesHttpClientKeepAliveThread feature for this
Context.
|
void |
setClearReferencesStatic(boolean clearReferencesStatic)
Set the clearReferencesStatic feature for this Context.
|
void |
setClearReferencesStopThreads(boolean clearReferencesStopThreads)
Set the clearReferencesStopThreads feature for this Context.
|
void |
setClearReferencesStopTimerThreads(boolean clearReferencesStopTimerThreads)
Set the clearReferencesStopTimerThreads feature for this Context.
|
void |
setConfigFile(URL configFile)
Set the URL of the XML descriptor for this context.
|
void |
setConfigured(boolean configured)
Set the "correctly configured" flag for this Context.
|
void |
setContainerSciFilter(String containerSciFilter)
Sets the regular expression that specifies which container provided SCIs
should be filtered out and not used for this context.
|
void |
setCookieProcessor(CookieProcessor cookieProcessor)
Sets the
CookieProcessor that will be used to process cookies
for this Context. |
void |
setCookies(boolean cookies)
Set the "use cookies for session ids" flag.
|
void |
setCopyXML(boolean copyXML) |
void |
setCrossContext(boolean crossContext)
Set the "allow crossing servlet contexts" flag.
|
void |
setDefaultContextXml(String defaultContextXml)
Set the location of the default context xml that will be used.
|
void |
setDefaultWebXml(String defaultWebXml)
Set the location of the default web xml that will be used.
|
void |
setDelegate(boolean delegate)
Set the "follow standard delegation model" flag used to configure
our ClassLoader.
|
void |
setDenyUncoveredHttpMethods(boolean denyUncoveredHttpMethods)
Set the deny-uncovered-http-methods flag for this web application.
|
void |
setDisplayName(String displayName)
Set the display name of this web application.
|
void |
setDistributable(boolean distributable)
Set the distributable flag for this web application.
|
void |
setDocBase(String docBase)
Set the document root for this Context.
|
void |
setEffectiveMajorVersion(int effectiveMajorVersion)
Set the effective major version of the Servlet spec used by this
context.
|
void |
setEffectiveMinorVersion(int effectiveMinorVersion)
Set the effective minor version of the Servlet spec used by this
context.
|
void |
setFailCtxIfServletStartFails(Boolean failCtxIfServletStartFails) |
void |
setFireRequestListenersOnForwards(boolean enable)
Configure whether or not requests listeners will be fired on forwards for
this Context.
|
void |
setIgnoreAnnotations(boolean ignoreAnnotations)
Set the boolean on the annotations parsing for this web
application.
|
void |
setInstanceManager(InstanceManager instanceManager)
Set the instance manager associated with this context.
|
void |
setJ2EEApplication(String j2EEApplication) |
void |
setJ2EEServer(String j2EEServer) |
void |
setJarScanner(JarScanner jarScanner)
Set the Jar Scanner to be used to scan for JAR resources for this
context.
|
String[] |
setJavaVMs(String[] javaVMs) |
void |
setJndiExceptionOnFailedWrite(boolean jndiExceptionOnFailedWrite)
Controls whether or not an attempt to modify the JNDI context will
trigger an exception or if the request will be ignored.
|
void |
setJspConfigDescriptor(JspConfigDescriptor descriptor)
Set the JspConfigDescriptor for this context.
|
void |
setLoader(Loader loader)
Set the Loader with which this Context is associated.
|
void |
setLogEffectiveWebXml(boolean logEffectiveWebXml)
Set whether or not the effective web.xml for this context should be
logged on context start.
|
void |
setLoginConfig(LoginConfig config)
Set the login configuration descriptor for this web application.
|
void |
setManager(Manager manager)
Set the Manager with which this Context is associated.
|
void |
setNamingContextListener(NamingContextListener namingContextListener)
Naming context listener setter.
|
void |
setNamingResources(NamingResourcesImpl namingResources)
Set the naming resources for this web application.
|
void |
setOriginalDocBase(String docBase)
Set the original document root for this Context.
|
void |
setOverride(boolean override)
Set the default context override flag for this web application.
|
void |
setPath(String path)
Set the context path for this Context.
|
void |
setPreemptiveAuthentication(boolean preemptiveAuthentication)
Configures if a user presents authentication credentials, whether the
context will process them when the request is for a non-protected
resource.
|
void |
setPrivileged(boolean privileged)
Set the privileged flag for this web application.
|
void |
setPublicId(String publicId)
Set the public identifier of the deployment descriptor DTD that is
currently being parsed.
|
void |
setReloadable(boolean reloadable)
Set the reloadable flag for this web application.
|
void |
setRenewThreadsWhenStoppingContext(boolean renewThreadsWhenStoppingContext) |
void |
setReplaceWelcomeFiles(boolean replaceWelcomeFiles)
Set the "replace welcome files" property.
|
void |
setResourceOnlyServlets(String resourceOnlyServlets)
Sets the (comma separated) list of Servlets that expect a resource to be
present.
|
void |
setResources(WebResourceRoot resources)
Set the Resources object with which this Context is associated.
|
void |
setSendRedirectBody(boolean sendRedirectBody)
Configures if a response body is included when a redirect response is
sent to the client.
|
String |
setServer(String server) |
void |
setSessionCookieDomain(String sessionCookieDomain)
Sets the domain to use for session cookies.
|
void |
setSessionCookieName(String sessionCookieName)
Sets the name to use for session cookies.
|
void |
setSessionCookiePath(String sessionCookiePath)
Sets the path to use for session cookies.
|
void |
setSessionCookiePathUsesTrailingSlash(boolean sessionCookiePathUsesTrailingSlash)
Configures if a / is added to the end of the session cookie path to
ensure browsers, particularly IE, don't send a session cookie for context
/foo with requests intended for context /foobar.
|
void |
setSessionTimeout(int timeout)
Set the default session timeout (in minutes) for this
web application.
|
void |
setStartupTime(long startupTime) |
void |
setSwallowAbortedUploads(boolean swallowAbortedUploads)
Set to
false to disable request data swallowing
after an upload was aborted due to size constraints. |
void |
setSwallowOutput(boolean swallowOutput)
Set the value of the swallowOutput flag.
|
void |
setThreadBindingListener(ThreadBindingListener threadBindingListener)
Get the associated ThreadBindingListener.
|
void |
setTldScanTime(long tldScanTime) |
void |
setTldValidation(boolean tldValidation)
Controls whether the parsing of *.tld files for this Context will be
performed by a validating parser.
|
void |
setUnloadDelay(long unloadDelay)
Set the value of the unloadDelay flag, which represents the amount
of ms that the container will wait when unloading servlets.
|
void |
setUnpackWAR(boolean unpackWAR)
Unpack WAR flag mutator.
|
void |
setUseHttpOnly(boolean useHttpOnly)
Sets the use HttpOnly cookies for session cookies flag.
|
void |
setUseNaming(boolean useNaming)
Enables or disables naming.
|
void |
setWebappVersion(String webappVersion)
Set the version of this web application - used to differentiate
different versions of the same web application when using parallel
deployment.
|
void |
setWorkDir(String workDir)
Set the work directory for this Context.
|
void |
setWrapperClass(String wrapperClassName)
Set the Java class name of the Wrapper implementation used
for servlets registered in this Context.
|
void |
setXmlBlockExternal(boolean xmlBlockExternal)
Controls whether the parsing of web.xml, web-fragment.xml, *.tld, *.jspx,
*.tagx and tagplugin.xml files for this Context will block the use of
external entities.
|
void |
setXmlNamespaceAware(boolean webXmlNamespaceAware)
Controls whether the parsing of web.xml and web-fragment.xml files for
this Context will be performed by a namespace aware parser.
|
void |
setXmlValidation(boolean webXmlValidation)
Controls whether the parsing of web.xml and web-fragment.xml files
for this Context will be performed by a validating parser.
|
protected void |
startInternal()
Start this component and implement the requirements
of
LifecycleBase.startInternal(). |
protected void |
stopInternal()
Stop this component and implement the requirements
of
LifecycleBase.stopInternal(). |
String |
toString()
Return a String representation of this component.
|
void |
unbind(boolean usePrivilegedAction,
ClassLoader originalClassLoader)
Restore the current thread context class loader to the original class
loader in used before
Context.bind(boolean, ClassLoader) was called. |
protected void |
unbindThread(ClassLoader oldContextClassLoader)
Unbind thread.
|
addContainerListener, addPropertyChangeListener, addValve, findChild, findChildren, findContainerListeners, fireContainerEvent, getAccessLog, getBackgroundProcessorDelay, getCatalinaBase, getCatalinaHome, getChildren, getCluster, getClusterInternal, getDomainInternal, getLogger, getMBeanKeyProperties, getName, getParent, getPipeline, getRealm, getRealmInternal, getStartChildren, getStartStopThreads, logAccess, logName, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setName, setParent, setParentClassLoader, setRealm, setStartChildren, setStartStopThreads, threadStart, threadStopgetDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregisteraddLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, init, removeLifecycleListener, setState, setState, start, stopclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitaddContainerListener, addPropertyChangeListener, findChild, findChildren, findContainerListeners, fireContainerEvent, getAccessLog, getBackgroundProcessorDelay, getCatalinaBase, getCatalinaHome, getCluster, getDomain, getLogger, getMBeanKeyProperties, getName, getObjectName, getParent, getPipeline, getRealm, getStartStopThreads, logAccess, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setName, setParent, setParentClassLoader, setRealm, setStartStopThreadsaddLifecycleListener, destroy, findLifecycleListeners, getState, getStateName, init, removeLifecycleListener, start, stopprotected boolean allowCasualMultipartParsing
protected ApplicationContext context
protected Manager manager
protected static final ThreadBindingListener DEFAULT_NAMING_LISTENER
protected ThreadBindingListener threadBindingListener
public StandardContext()
public void setCookieProcessor(CookieProcessor cookieProcessor)
ContextCookieProcessor that will be used to process cookies
for this Context.setCookieProcessor in interface ContextcookieProcessor - The new cookie processorpublic CookieProcessor getCookieProcessor()
ContextCookieProcessor that will be used to process cookies
for this Context.getCookieProcessor in interface Contextpublic Object getNamingToken()
ContextgetNamingToken in interface Contextpublic void setContainerSciFilter(String containerSciFilter)
ContextMatcher.find() so the regular expression only has
to match a sub-string of the fully qualified class name of the container
provided SCI for it to be filtered out.setContainerSciFilter in interface ContextcontainerSciFilter - The regular expression against which the fully
qualified class name of each container provided
SCI should be checkedpublic String getContainerSciFilter()
ContextMatcher.find() so the regular expression only has
to match a sub-string of the fully qualified class name of the container
provided SCI for it to be filtered out.getContainerSciFilter in interface Contextpublic boolean getSendRedirectBody()
ContextgetSendRedirectBody in interface Contextpublic void setSendRedirectBody(boolean sendRedirectBody)
ContextsetSendRedirectBody in interface Contextpublic boolean getPreemptiveAuthentication()
ContextgetPreemptiveAuthentication in interface Contextpublic void setPreemptiveAuthentication(boolean preemptiveAuthentication)
ContextsetPreemptiveAuthentication in interface Contextpublic void setFireRequestListenersOnForwards(boolean enable)
ContextsetFireRequestListenersOnForwards in interface Contextpublic boolean getFireRequestListenersOnForwards()
ContextgetFireRequestListenersOnForwards in interface Contextpublic void setAddWebinfClassesResources(boolean addWebinfClassesResources)
ContextsetAddWebinfClassesResources in interface ContextaddWebinfClassesResources - The new value for the flagpublic boolean getAddWebinfClassesResources()
ContextgetAddWebinfClassesResources in interface Contextpublic void setWebappVersion(String webappVersion)
ContextsetWebappVersion in interface Contextpublic String getWebappVersion()
ContextgetWebappVersion in interface Contextpublic String getBaseName()
ContextgetBaseName in interface Contextpublic String getResourceOnlyServlets()
ContextgetResourceOnlyServlets in interface Contextpublic void setResourceOnlyServlets(String resourceOnlyServlets)
ContextsetResourceOnlyServlets in interface Contextpublic boolean isResourceOnlyServlet(String servletName)
ContextisResourceOnlyServlet in interface ContextservletName - Name of the Servlet (as per web.xml) to checktrue if the Servlet expects a resource,
otherwise falsepublic int getEffectiveMajorVersion()
ContextgetEffectiveMajorVersion in interface Contextpublic void setEffectiveMajorVersion(int effectiveMajorVersion)
ContextsetEffectiveMajorVersion in interface Contextpublic int getEffectiveMinorVersion()
ContextgetEffectiveMinorVersion in interface Contextpublic void setEffectiveMinorVersion(int effectiveMinorVersion)
ContextsetEffectiveMinorVersion in interface Contextpublic void setLogEffectiveWebXml(boolean logEffectiveWebXml)
ContextsetLogEffectiveWebXml in interface Contextpublic boolean getLogEffectiveWebXml()
ContextgetLogEffectiveWebXml in interface Contextpublic Authenticator getAuthenticator()
ContextAuthenticator that is used by this context or
null if none is used.getAuthenticator in interface Contextpublic JarScanner getJarScanner()
ContextgetJarScanner in interface Contextpublic void setJarScanner(JarScanner jarScanner)
ContextsetJarScanner in interface ContextjarScanner - The Jar Scanner to be used for this context.public InstanceManager getInstanceManager()
ContextgetInstanceManager in interface Contextpublic void setInstanceManager(InstanceManager instanceManager)
ContextsetInstanceManager in interface Contextpublic String getEncodedPath()
ContextgetEncodedPath in interface Contextpublic void setAllowCasualMultipartParsing(boolean allowCasualMultipartParsing)
true to allow requests mapped to servlets that
do not explicitly declare @MultipartConfig or have
<multipart-config> specified in web.xml to parse
multipart/form-data requests.setAllowCasualMultipartParsing in interface ContextallowCasualMultipartParsing - true to allow such
casual parsing, false otherwise.public boolean getAllowCasualMultipartParsing()
true if requests mapped to servlets without
"multipart config" to parse multipart/form-data requests anyway.getAllowCasualMultipartParsing in interface Contexttrue if requests mapped to servlets without
"multipart config" to parse multipart/form-data requests,
false otherwise.public void setSwallowAbortedUploads(boolean swallowAbortedUploads)
false to disable request data swallowing
after an upload was aborted due to size constraints.setSwallowAbortedUploads in interface ContextswallowAbortedUploads - false to disable
swallowing, true otherwise (default).public boolean getSwallowAbortedUploads()
true if remaining request data will be read
(swallowed) even the request violates a data size constraint.getSwallowAbortedUploads in interface Contexttrue if data will be swallowed (default),
false otherwise.public void addServletContainerInitializer(ServletContainerInitializer sci, Set<Class<?>> classes)
addServletContainerInitializer in interface Contextsci - The instance to addclasses - The classes in which the initializer expressed an
interestpublic boolean getDelegate()
public void setDelegate(boolean delegate)
delegate - The new flagpublic boolean isUseNaming()
public void setUseNaming(boolean useNaming)
public Object[] getApplicationEventListeners()
ContextgetApplicationEventListeners in interface Contextpublic void setApplicationEventListeners(Object[] listeners)
ContextsetApplicationEventListeners in interface Contextlisteners - The set of instantiated listener objects.public void addApplicationEventListener(Object listener)
public Object[] getApplicationLifecycleListeners()
ContextgetApplicationLifecycleListeners in interface Contextpublic void setApplicationLifecycleListeners(Object[] listeners)
setApplicationLifecycleListeners in interface Contextlisteners - The set of instantiated listener objects.public void addApplicationLifecycleListener(Object listener)
public boolean getAntiResourceLocking()
public void setAntiResourceLocking(boolean antiResourceLocking)
antiResourceLocking - The new flag valuepublic CharsetMapper getCharsetMapper()
public void setCharsetMapper(CharsetMapper mapper)
mapper - The new mapperpublic String getCharset(Locale locale)
ContextgetCharset in interface Contextlocale - The locale for which the mapped character set should be
returnedpublic URL getConfigFile()
ContextgetConfigFile in interface Contextpublic void setConfigFile(URL configFile)
ContextsetConfigFile in interface ContextconfigFile - The URL of the XML descriptor for this context.public boolean getConfigured()
ContextgetConfigured in interface Contexttrue if the Context has been correctly configured,
otherwise falsepublic void setConfigured(boolean configured)
setConfigured in interface Contextconfigured - The new correctly configured flagpublic boolean getCookies()
ContextgetCookies in interface Contexttrue if it is permitted to use cookies to track
session IDs for this web application, otherwise
falsepublic void setCookies(boolean cookies)
setCookies in interface Contextcookies - The new flagpublic String getSessionCookieName()
getSessionCookieName in interface Contextpublic void setSessionCookieName(String sessionCookieName)
setSessionCookieName in interface ContextsessionCookieName - The name to usepublic boolean getUseHttpOnly()
getUseHttpOnly in interface Contexttrue if the HttpOnly flag should be set on session
cookiespublic void setUseHttpOnly(boolean useHttpOnly)
setUseHttpOnly in interface ContextuseHttpOnly - Set to true to use HttpOnly cookies
for session cookiespublic String getSessionCookieDomain()
getSessionCookieDomain in interface Contextpublic void setSessionCookieDomain(String sessionCookieDomain)
setSessionCookieDomain in interface ContextsessionCookieDomain - The domain to usepublic String getSessionCookiePath()
getSessionCookiePath in interface Contextpublic void setSessionCookiePath(String sessionCookiePath)
setSessionCookiePath in interface ContextsessionCookiePath - The path to usepublic boolean getSessionCookiePathUsesTrailingSlash()
ContextgetSessionCookiePathUsesTrailingSlash in interface Contexttrue if the slash is added, otherwise
falsepublic void setSessionCookiePathUsesTrailingSlash(boolean sessionCookiePathUsesTrailingSlash)
ContextsetSessionCookiePathUsesTrailingSlash in interface ContextsessionCookiePathUsesTrailingSlash - true if the
slash is should be added,
otherwise falsepublic boolean getCrossContext()
ContextgetCrossContext in interface Contexttrue if cross-contest requests are allowed from this
web applications, otherwise falsepublic void setCrossContext(boolean crossContext)
setCrossContext in interface ContextcrossContext - The new cross contexts flagpublic String getDefaultContextXml()
public void setDefaultContextXml(String defaultContextXml)
defaultContextXml - The default web xmlpublic String getDefaultWebXml()
public void setDefaultWebXml(String defaultWebXml)
defaultWebXml - The default web xmlpublic long getStartupTime()
public void setStartupTime(long startupTime)
public long getTldScanTime()
public void setTldScanTime(long tldScanTime)
public boolean getDenyUncoveredHttpMethods()
ContextgetDenyUncoveredHttpMethods in interface Contextpublic void setDenyUncoveredHttpMethods(boolean denyUncoveredHttpMethods)
ContextsetDenyUncoveredHttpMethods in interface ContextdenyUncoveredHttpMethods - The new deny-uncovered-http-methods flagpublic String getDisplayName()
getDisplayName in interface Contextpublic String getAltDDName()
getAltDDName in interface Contextpublic void setAltDDName(String altDDName)
setAltDDName in interface Contextpublic void setDisplayName(String displayName)
setDisplayName in interface ContextdisplayName - The new display namepublic boolean getDistributable()
getDistributable in interface Contextpublic void setDistributable(boolean distributable)
setDistributable in interface Contextdistributable - The new distributable flagpublic String getDocBase()
getDocBase in interface Contextpublic void setDocBase(String docBase)
setDocBase in interface ContextdocBase - The new document rootpublic String getJ2EEApplication()
public void setJ2EEApplication(String j2EEApplication)
public String getJ2EEServer()
public void setJ2EEServer(String j2EEServer)
public Loader getLoader()
Contextpublic void setLoader(Loader loader)
Contextpublic Manager getManager()
Contextnull.getManager in interface Contextpublic void setManager(Manager manager)
ContextsetManager in interface Contextmanager - The newly associated Managerpublic boolean getIgnoreAnnotations()
getIgnoreAnnotations in interface Contextpublic void setIgnoreAnnotations(boolean ignoreAnnotations)
setIgnoreAnnotations in interface ContextignoreAnnotations - The boolean on the annotations parsingpublic LoginConfig getLoginConfig()
getLoginConfig in interface Contextpublic void setLoginConfig(LoginConfig config)
setLoginConfig in interface Contextconfig - The new login configurationpublic NamingResourcesImpl getNamingResources()
getNamingResources in interface Contextpublic void setNamingResources(NamingResourcesImpl namingResources)
setNamingResources in interface ContextnamingResources - The new naming resourcespublic String getPath()
public void setPath(String path)
public String getPublicId()
getPublicId in interface Contextpublic void setPublicId(String publicId)
setPublicId in interface ContextpublicId - The public identifierpublic boolean getReloadable()
getReloadable in interface Contextpublic boolean getOverride()
getOverride in interface Contextpublic String getOriginalDocBase()
public void setOriginalDocBase(String docBase)
docBase - The original document rootpublic ClassLoader getParentClassLoader()
getParentClassLoader in interface ContainergetParentClassLoader in class ContainerBaseContainer.getParent().Container.getParentClassLoader(). If no
parent has been set, return the system class loader.public boolean getPrivileged()
getPrivileged in interface Contextpublic void setPrivileged(boolean privileged)
setPrivileged in interface Contextprivileged - The new privileged flagpublic void setReloadable(boolean reloadable)
setReloadable in interface Contextreloadable - The new reloadable flagpublic void setOverride(boolean override)
setOverride in interface Contextoverride - The new override flagpublic void setReplaceWelcomeFiles(boolean replaceWelcomeFiles)
replaceWelcomeFiles - The new property valuepublic ServletContext getServletContext()
getServletContext in interface Contextpublic int getSessionTimeout()
getSessionTimeout in interface Contextpublic void setSessionTimeout(int timeout)
setSessionTimeout in interface Contexttimeout - The new default session timeoutpublic boolean getSwallowOutput()
getSwallowOutput in interface Contextpublic void setSwallowOutput(boolean swallowOutput)
setSwallowOutput in interface ContextswallowOutput - The new valuepublic long getUnloadDelay()
public void setUnloadDelay(long unloadDelay)
unloadDelay - The new valuepublic boolean getUnpackWAR()
public void setUnpackWAR(boolean unpackWAR)
public boolean getCopyXML()
public void setCopyXML(boolean copyXML)
public String getWrapperClass()
getWrapperClass in interface Contextpublic void setWrapperClass(String wrapperClassName)
setWrapperClass in interface ContextwrapperClassName - The new wrapper class nameIllegalArgumentException - if the specified wrapper class
cannot be found or is not a subclass of StandardWrapperpublic WebResourceRoot getResources()
ContextgetResources in interface Contextpublic void setResources(WebResourceRoot resources)
ContextsetResources in interface Contextresources - The newly associated Resourcespublic JspConfigDescriptor getJspConfigDescriptor()
ContextgetJspConfigDescriptor in interface Contextpublic void setJspConfigDescriptor(JspConfigDescriptor descriptor)
ContextsetJspConfigDescriptor in interface Contextpublic ThreadBindingListener getThreadBindingListener()
ContextgetThreadBindingListener in interface Contextpublic void setThreadBindingListener(ThreadBindingListener threadBindingListener)
ContextsetThreadBindingListener in interface Contextpublic boolean getJndiExceptionOnFailedWrite()
public void setJndiExceptionOnFailedWrite(boolean jndiExceptionOnFailedWrite)
jndiExceptionOnFailedWrite - public String getCharsetMapperClass()
public void setCharsetMapperClass(String mapper)
mapper - The new mapper classpublic String getWorkPath()
public String getWorkDir()
public void setWorkDir(String workDir)
workDir - The new work directorypublic boolean getClearReferencesStatic()
public void setClearReferencesStatic(boolean clearReferencesStatic)
clearReferencesStatic - The new flag valuepublic boolean getClearReferencesStopThreads()
public void setClearReferencesStopThreads(boolean clearReferencesStopThreads)
clearReferencesStopThreads - The new flag valuepublic boolean getClearReferencesStopTimerThreads()
public void setClearReferencesStopTimerThreads(boolean clearReferencesStopTimerThreads)
clearReferencesStopTimerThreads - The new flag valuepublic boolean getClearReferencesHttpClientKeepAliveThread()
public void setClearReferencesHttpClientKeepAliveThread(boolean clearReferencesHttpClientKeepAliveThread)
clearReferencesHttpClientKeepAliveThread - The new flag valuepublic boolean getRenewThreadsWhenStoppingContext()
public void setRenewThreadsWhenStoppingContext(boolean renewThreadsWhenStoppingContext)
public Boolean getFailCtxIfServletStartFails()
public void setFailCtxIfServletStartFails(Boolean failCtxIfServletStartFails)
protected boolean getComputedFailCtxIfServletStartFails()
public void addApplicationListener(String listener)
addApplicationListener in interface Contextlistener - Java class name of a listener classpublic void addApplicationParameter(ApplicationParameter parameter)
addApplicationParameter in interface Contextparameter - The new application parameterpublic void addChild(Container child)
addChild in interface ContaineraddChild in class ContainerBasechild - Child container to be addedIllegalArgumentException - if the proposed container is
not an implementation of Wrapperpublic void addConstraint(SecurityConstraint constraint)
addConstraint in interface Contextpublic void addErrorPage(ErrorPage errorPage)
addErrorPage in interface ContexterrorPage - The error page definition to be addedpublic void addFilterDef(FilterDef filterDef)
addFilterDef in interface ContextfilterDef - The filter definition to be addedpublic void addFilterMap(FilterMap filterMap)
addFilterMap in interface ContextfilterMap - The filter mapping to be addedIllegalArgumentException - if the specified filter name
does not match an existing filter definition, or the filter mapping
is malformedpublic void addFilterMapBefore(FilterMap filterMap)
addFilterMapBefore in interface ContextfilterMap - The filter mapping to be addedIllegalArgumentException - if the specified filter name
does not match an existing filter definition, or the filter mapping
is malformedpublic void addInstanceListener(String listener)
addInstanceListener in interface Contextlistener - Java class name of an InstanceListener classpublic void addLocaleEncodingMappingParameter(String locale, String encoding)
addLocaleEncodingMappingParameter in interface Contextlocale - locale to map an encoding forencoding - encoding to be used for a give localepublic void addMessageDestination(MessageDestination md)
md - New message destinationpublic void addMessageDestinationRef(MessageDestinationRef mdr)
mdr - New message destination referencepublic void addMimeMapping(String extension, String mimeType)
addMimeMapping in interface Contextextension - Filename extension being mappedmimeType - Corresponding MIME typepublic void addParameter(String name, String value)
addParameter in interface Contextname - Name of the new parametervalue - Value of the new parameterIllegalArgumentException - if the name or value is missing,
or if this context initialization parameter has already been
registeredpublic void addRoleMapping(String role, String link)
addRoleMapping in interface Contextrole - Security role used in the applicationlink - Actual security role to check forpublic void addSecurityRole(String role)
addSecurityRole in interface Contextrole - New security rolepublic void addServletMapping(String pattern, String name)
addServletMapping in interface Contextpattern - URL pattern to be mappedname - Name of the corresponding servlet to executeIllegalArgumentException - if the specified servlet name
is not known to this Contextpublic void addServletMapping(String pattern, String name, boolean jspWildCard)
addServletMapping in interface Contextpattern - URL pattern to be mappedname - Name of the corresponding servlet to executejspWildCard - true if name identifies the JspServlet
and pattern contains a wildcard; false otherwiseIllegalArgumentException - if the specified servlet name
is not known to this Contextpublic void addWatchedResource(String name)
addWatchedResource in interface Contextname - New watched resource file namepublic void addWelcomeFile(String name)
addWelcomeFile in interface Contextname - New welcome file namepublic void addWrapperLifecycle(String listener)
addWrapperLifecycle in interface Contextlistener - Java class name of a LifecycleListener classpublic void addWrapperListener(String listener)
addWrapperListener in interface Contextlistener - Java class name of a ContainerListener classpublic Wrapper createWrapper()
createWrapper in interface Contextpublic String[] findApplicationListeners()
findApplicationListeners in interface Contextpublic ApplicationParameter[] findApplicationParameters()
findApplicationParameters in interface Contextpublic SecurityConstraint[] findConstraints()
findConstraints in interface Contextpublic ErrorPage findErrorPage(int errorCode)
null.findErrorPage in interface ContexterrorCode - Error code to look uppublic ErrorPage findErrorPage(String exceptionType)
null.findErrorPage in interface ContextexceptionType - Exception type to look uppublic ErrorPage[] findErrorPages()
findErrorPages in interface Contextpublic FilterDef findFilterDef(String filterName)
null.findFilterDef in interface ContextfilterName - Filter name to look uppublic FilterDef[] findFilterDefs()
findFilterDefs in interface Contextpublic FilterMap[] findFilterMaps()
findFilterMaps in interface Contextpublic String[] findInstanceListeners()
findInstanceListeners in interface Contextpublic MessageDestination findMessageDestination(String name)
null.name - Name of the desired message destinationpublic MessageDestination[] findMessageDestinations()
public MessageDestinationRef findMessageDestinationRef(String name)
null.name - Name of the desired message destination refpublic MessageDestinationRef[] findMessageDestinationRefs()
public String findMimeMapping(String extension)
null.findMimeMapping in interface Contextextension - Extension to map to a MIME typepublic String[] findMimeMappings()
findMimeMappings in interface Contextpublic String findParameter(String name)
null.findParameter in interface Contextname - Name of the parameter to returnpublic String[] findParameters()
findParameters in interface Contextpublic String findRoleMapping(String role)
findRoleMapping in interface Contextrole - Security role to mappublic boolean findSecurityRole(String role)
true if the specified security role is defined
for this application; otherwise return false.findSecurityRole in interface Contextrole - Security role to verifypublic String[] findSecurityRoles()
findSecurityRoles in interface Contextpublic String findServletMapping(String pattern)
null.findServletMapping in interface Contextpattern - Pattern for which a mapping is requestedpublic String[] findServletMappings()
findServletMappings in interface Contextpublic String findStatusPage(int status)
null.findStatusPage in interface Contextstatus - HTTP status code to look uppublic int[] findStatusPages()
findStatusPages in interface Contextpublic boolean findWelcomeFile(String name)
true if the specified welcome file is defined
for this Context; otherwise return false.findWelcomeFile in interface Contextname - Welcome file to verifypublic String[] findWatchedResources()
findWatchedResources in interface Contextpublic String[] findWelcomeFiles()
findWelcomeFiles in interface Contextpublic String[] findWrapperLifecycles()
findWrapperLifecycles in interface Contextpublic String[] findWrapperListeners()
findWrapperListeners in interface Contextpublic void reload()
IMPLEMENTATION NOTE: This method is designed to deal with
reloads required by changes to classes in the underlying repositories
of our class loader and changes to the web.xml file. It does not handle
changes to any context.xml file. If the context.xml has changed, you
should stop this Context and create (and start) a new Context instance
instead. Note that there is additional code in
CoyoteAdapter#postParseRequest() to handle mapping requests
to paused Contexts.
reload in interface ContextIllegalStateException - if the reloadable
property is set to false.public void removeApplicationListener(String listener)
removeApplicationListener in interface Contextlistener - Java class name of the listener to be removedpublic void removeApplicationParameter(String name)
removeApplicationParameter in interface Contextname - Name of the application parameter to removepublic void removeChild(Container child)
removeChild in interface ContainerremoveChild in class ContainerBasechild - Child container to be addedIllegalArgumentException - if the proposed container is
not an implementation of Wrapperpublic void removeConstraint(SecurityConstraint constraint)
removeConstraint in interface Contextconstraint - Constraint to be removedpublic void removeErrorPage(ErrorPage errorPage)
removeErrorPage in interface ContexterrorPage - The error page definition to be removedpublic void removeFilterDef(FilterDef filterDef)
removeFilterDef in interface ContextfilterDef - Filter definition to be removedpublic void removeFilterMap(FilterMap filterMap)
removeFilterMap in interface ContextfilterMap - The filter mapping to be removedpublic void removeInstanceListener(String listener)
removeInstanceListener in interface Contextlistener - Class name of an InstanceListener class to be removedpublic void removeMessageDestination(String name)
name - Name of the message destination to removepublic void removeMessageDestinationRef(String name)
name - Name of the message destination ref to removepublic void removeMimeMapping(String extension)
removeMimeMapping in interface Contextextension - Extension to remove the mapping forpublic void removeParameter(String name)
removeParameter in interface Contextname - Name of the parameter to removepublic void removeRoleMapping(String role)
removeRoleMapping in interface Contextrole - Security role (as used in the application) to removepublic void removeSecurityRole(String role)
removeSecurityRole in interface Contextrole - Security role to removepublic void removeServletMapping(String pattern)
removeServletMapping in interface Contextpattern - URL pattern of the mapping to removepublic void removeWatchedResource(String name)
removeWatchedResource in interface Contextname - Name of the watched resource to be removedpublic void removeWelcomeFile(String name)
removeWelcomeFile in interface Contextname - Name of the welcome file to be removedpublic void removeWrapperLifecycle(String listener)
removeWrapperLifecycle in interface Contextlistener - Class name of a LifecycleListener class to be removedpublic void removeWrapperListener(String listener)
removeWrapperListener in interface Contextlistener - Class name of a ContainerListener class to be removedpublic long getProcessingTime()
public long getMaxTime()
public long getMinTime()
public int getRequestCount()
public int getErrorCount()
public String getRealPath(String path)
null.getRealPath in interface Contextpath - The path to the desired resourcepublic ServletRegistration.Dynamic dynamicServletAdded(Wrapper wrapper)
wrapper - The wrapper for the Servlet that was addedpublic void dynamicServletCreated(Servlet servlet)
servlet - public boolean filterStart()
true if all filter initialization completed
successfully, or false otherwise.public boolean filterStop()
true if all filter finalization completed
successfully, or false otherwise.public FilterConfig findFilterConfig(String name)
FilterConfig for the
specified filter name, if any; otherwise return null.name - Name of the desired filterpublic boolean listenerStart()
true if all listeners wre
initialized successfully, or false otherwise.public boolean listenerStop()
true if all events were sent successfully,
or false otherwise.public void resourcesStart()
throws LifecycleException
true if initialization was successfull,
or false otherwise.LifecycleExceptionpublic boolean resourcesStop()
public boolean loadOnStartup(Container[] children)
children - Array of wrappers for all currently defined
servlets (including those not declared load on startup)protected void startInternal()
throws LifecycleException
LifecycleBase.startInternal().startInternal in class ContainerBaseLifecycleException - if this component detects a fatal error
that prevents this component from being usedprotected void stopInternal()
throws LifecycleException
LifecycleBase.stopInternal().stopInternal in class ContainerBaseLifecycleException - if this component detects a fatal error
that prevents this component from being usedprotected void destroyInternal()
throws LifecycleException
destroyInternal in class ContainerBaseLifecycleExceptionpublic void backgroundProcess()
ContainerBasebackgroundProcess in interface ContainerbackgroundProcess in class ContainerBasepublic String toString()
protected String adjustURLPattern(String urlPattern)
urlPattern - The URL pattern to be adjusted (if needed)
and returnedpublic boolean isServlet22()
isServlet22 in interface Contextpublic Set<String> addServletSecurity(ServletRegistration.Dynamic registration, ServletSecurityElement servletSecurityElement)
ContextServletRegistration.DynamicaddServletSecurity in interface Contextregistration - servlet security was modified forservletSecurityElement - new security constraints for this servletprotected ClassLoader bindThread()
protected void unbindThread(ClassLoader oldContextClassLoader)
public ClassLoader bind(boolean usePrivilegedAction, ClassLoader originalClassLoader)
ContextThreadBindingListener is configured then
ThreadBindingListener.bind() will be called after the change has
been made.bind in interface ContextusePrivilegedAction - Should a PrivilegedAction be used when
obtaining the current thread context class loader and setting
the new one?originalClassLoader - The current class loader if known to save this method having to
look it uppublic void unbind(boolean usePrivilegedAction,
ClassLoader originalClassLoader)
ContextContext.bind(boolean, ClassLoader) was called. If
no original class loader is passed to this method then no change will be
made. If the class loader is changed and a ThreadBindingListener
is configured then ThreadBindingListener.unbind() will be called
before the change is made.unbind in interface ContextusePrivilegedAction - Should a PrivilegedAction be used when
setting the current thread context class loader?originalClassLoader - The class loader to restore as the thread context class loaderpublic NamingContextListener getNamingContextListener()
public void setNamingContextListener(NamingContextListener namingContextListener)
public boolean getPaused()
public boolean fireRequestInitEvent(ServletRequest request)
ContextServletRequestListeners that a request
has started.fireRequestInitEvent in interface Contexttrue if the listeners fire successfully, else
falsepublic boolean fireRequestDestroyEvent(ServletRequest request)
ContextServletRequestListeners that a request
has ended.fireRequestDestroyEvent in interface Contexttrue if the listeners fire successfully, else
falsepublic void addPostConstructMethod(String clazz, String method)
ContextaddPostConstructMethod in interface Contextclazz - Fully qualified class namemethod - Post construct method namepublic void removePostConstructMethod(String clazz)
ContextremovePostConstructMethod in interface Contextclazz - Fully qualified class namepublic void addPreDestroyMethod(String clazz, String method)
ContextaddPreDestroyMethod in interface Contextclazz - Fully qualified class namemethod - Post construct method namepublic void removePreDestroyMethod(String clazz)
ContextremovePreDestroyMethod in interface Contextclazz - Fully qualified class namepublic String findPostConstructMethod(String clazz)
ContextNULL will be
returned.findPostConstructMethod in interface Contextclazz - Fully qualified class nameNULL will
be returned.public String findPreDestroyMethod(String clazz)
ContextNULL will be returned.findPreDestroyMethod in interface Contextclazz - Fully qualified class nameNULL will be
returned.public Map<String,String> findPostConstructMethods()
ContextfindPostConstructMethods in interface Contextpublic Map<String,String> findPreDestroyMethods()
ContextfindPreDestroyMethods in interface Contextpublic String getDeploymentDescriptor()
public String[] getServlets()
protected String getObjectNameKeyProperties()
LifecycleMBeanBaseObjectName that will be used to register this component.getObjectNameKeyProperties in class LifecycleMBeanBaseObjectNameprotected void initInternal()
throws LifecycleException
LifecycleMBeanBaseinitInternal in class ContainerBaseLifecycleExceptionpublic void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object object) throws ListenerNotFoundException
removeNotificationListener in interface NotificationEmitterListenerNotFoundExceptionpublic MBeanNotificationInfo[] getNotificationInfo()
getNotificationInfo in interface NotificationBroadcasterpublic void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object object) throws IllegalArgumentException
addNotificationListener in interface NotificationBroadcasterIllegalArgumentExceptionpublic void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundException
removeNotificationListener in interface NotificationBroadcasterListenerNotFoundExceptionNotificationBroadcaster.removeNotificationListener(javax.management.NotificationListener)public String[] getWelcomeFiles()
public boolean getXmlNamespaceAware()
ContextgetXmlNamespaceAware in interface Contextpublic void setXmlNamespaceAware(boolean webXmlNamespaceAware)
ContextsetXmlNamespaceAware in interface ContextwebXmlNamespaceAware - true to enable namespace awarenesspublic void setXmlValidation(boolean webXmlValidation)
ContextsetXmlValidation in interface ContextwebXmlValidation - true to enable xml validationpublic boolean getXmlValidation()
ContextgetXmlValidation in interface Contextpublic void setXmlBlockExternal(boolean xmlBlockExternal)
ContextsetXmlBlockExternal in interface ContextxmlBlockExternal - true to block external entitiespublic boolean getXmlBlockExternal()
ContextgetXmlBlockExternal in interface Contextpublic void setTldValidation(boolean tldValidation)
ContextsetTldValidation in interface ContexttldValidation - true to enable xml validationpublic boolean getTldValidation()
ContextgetTldValidation in interface Contextpublic boolean isStateManageable()
public String getServer()
public String[] getJavaVMs()
public long getStartTime()
Copyright © 2000-2015 Apache Software Foundation. All Rights Reserved.