public class StandardContext extends ContainerBase implements Context, NotificationEmitter
ContainerBase.ContainerBackgroundProcessor, ContainerBase.PrivilegedAddChild
Lifecycle.SingleUse
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 boolean |
allowLinking
Allow linking.
|
protected int |
cacheMaxSize
Cache max size in KB.
|
protected int |
cacheObjectMaxSize
Cache object max size in KB.
|
protected int |
cacheTTL
Cache TTL in ms.
|
protected ApplicationContext |
context
The ServletContext implementation associated with this Context.
|
protected static URLEncoder |
urlEncoder
Array containing the safe characters set.
|
accessLog, backgroundProcessorDelay, children, cluster, listeners, loader, logger, logName, manager, name, parent, parentClassLoader, pipeline, resources, sm, startChildren, startStopExecutor, support
mserver
ADD_WELCOME_FILE_EVENT, CHANGE_SESSION_ID_EVENT, CLEAR_WELCOME_FILES_EVENT, RELOAD_EVENT, REMOVE_WELCOME_FILE_EVENT
ADD_CHILD_EVENT, ADD_MAPPER_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_MAPPER_EVENT, REMOVE_VALVE_EVENT
AFTER_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(ApplicationListener listener)
Add a new Listener class name to the set of Listeners configured for this
application.
|
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)
Add a JMX NotificationListener
|
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 |
addResourceJarUrl(URL url)
Add a URL for a JAR that contains static resources in a
META-INF/resources directory that should be included in the static
resources for this context.
|
void |
addResourcesDirContext(DirContext altDirContext)
Add a DirContext for a JAR that contains static resources in a
META-INF/resources directory that should be included in the static
resources for this context.
|
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(ApplicationServletRegistration 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.
|
protected ClassLoader |
bindThread()
Bind current thread, both for CL purposes and for JNDI ENC support
during : startup, shutdown and reloading 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.
|
void |
decrementInProgressAsyncCount() |
protected void |
destroyInternal()
Destroy needs to clean up the context completely.
|
ServletRegistration.Dynamic |
dynamicServletAdded(Wrapper wrapper)
Deprecated.
This will be removed in Tomcat 9. The registration should be
created directly.
|
void |
dynamicServletCreated(Servlet servlet)
Hook to track which Servlets were created via
ServletContext.createServlet(Class) . |
protected File |
engineBase() |
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.
|
Context |
findMappingObject()
Deprecated.
|
MessageDestination |
findMessageDestination(String name) |
MessageDestinationRef |
findMessageDestinationRef(String name) |
MessageDestinationRef[] |
findMessageDestinationRefs() |
MessageDestination[] |
findMessageDestinations() |
String |
findMimeMapping(String extension) |
String[] |
findMimeMappings() |
String |
findParameter(String name) |
String[] |
findParameters() |
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) |
String[] |
findSecurityRoles() |
String |
findServletMapping(String pattern) |
String[] |
findServletMappings() |
DirContext |
findStaticResources()
Deprecated.
|
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() |
boolean |
findWelcomeFile(String name) |
String[] |
findWelcomeFiles() |
String[] |
findWrapperLifecycles() |
String[] |
findWrapperListeners() |
boolean |
fireRequestDestroyEvent(ServletRequest request)
Notify all
ServletRequestListener s that a request
has ended. |
boolean |
fireRequestInitEvent(ServletRequest request)
Notify all
ServletRequestListener s that a request
has started. |
boolean |
getAddWebinfClassesResources() |
String |
getAliases() |
boolean |
getAllowCasualMultipartParsing()
Returns
true if requests mapped to servlets without
"multipart config" to parse multipart/form-data requests anyway. |
boolean |
getAllowMultipleLeadingForwardSlashInPath()
When returning a context path from
HttpServletRequest.getContextPath() , is it allowed to
contain multiple leading '/' characters? |
String |
getAltDDName()
Return the alternate Deployment Descriptor name.
|
boolean |
getAntiJARLocking() |
boolean |
getAntiResourceLocking() |
protected String |
getAppBase() |
Object[] |
getApplicationEventListeners()
Return the set of initialized application event listener objects,
in the order they were specified in the web application deployment
descriptor, for this application.
|
Object[] |
getApplicationLifecycleListeners()
Return the set of initialized application lifecycle listener objects,
in the order they were specified in the web application deployment
descriptor, for this application.
|
Authenticator |
getAuthenticator() |
boolean |
getAvailable() |
String |
getBaseName() |
protected String |
getBasePath() |
int |
getCacheMaxSize() |
int |
getCacheObjectMaxSize() |
int |
getCacheTTL() |
String |
getCharset(Locale locale)
Obtain the character set name to use with the given Locale.
|
CharsetMapper |
getCharsetMapper() |
String |
getCharsetMapperClass() |
boolean |
getClearReferencesHttpClientKeepAliveThread() |
boolean |
getClearReferencesObjectStreamClassCaches() |
boolean |
getClearReferencesRmiTargets() |
boolean |
getClearReferencesStatic()
Deprecated.
This option will be removed in Tomcat 8.5
|
boolean |
getClearReferencesStopThreads() |
boolean |
getClearReferencesStopTimerThreads() |
boolean |
getClearReferencesThreadLocals() |
String |
getCompilerClasspath()
Deprecated.
|
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.
|
boolean |
getCookies()
Return the "use cookies for session ids" flag.
|
boolean |
getCopyXML()
Flag which indicates if bundled context.xml files should be copied to the
config folder.
|
boolean |
getCreateUploadTargets()
Will Tomcat attempt to create an upload target used by this web
application if it does not exist when the web application attempts to use
it?
|
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.
|
String |
getDeploymentDescriptor()
JSR77 deploymentDescriptor attribute
|
boolean |
getDispatchersUseEncodedPaths()
Are paths used in calls to obtain a request dispatcher expected to be
encoded?
|
String |
getDisplayName()
Return the display name of this web application.
|
boolean |
getDistributable()
Get the distributable flag for this web application.
|
String |
getDocBase()
Obtain the document root for this Context.
|
int |
getEffectiveMajorVersion() |
int |
getEffectiveMinorVersion() |
String |
getEncodedPath()
Return the URL encoded context path
|
int |
getErrorCount()
Gets the cumulative error count of all servlets in this
StandardContext.
|
Boolean |
getFailCtxIfServletStartFails() |
boolean |
getFireRequestListenersOnForwards() |
String |
getHostname()
Deprecated.
Unused. Will be removed in Tomcat 8.0.x.
|
boolean |
getIgnoreAnnotations()
Determine if annotations parsing is currently disabled
|
String |
getInfo()
Return descriptive information about this Container implementation and
the corresponding version number, in the format
<description>/<version> . |
long |
getInProgressAsyncCount() |
InstanceManager |
getInstanceManager() |
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() |
JspConfigDescriptor |
getJspConfigDescriptor() |
boolean |
getLogEffectiveWebXml()
Should the effective web.xml for this context be logged on context start?
|
LoginConfig |
getLoginConfig() |
Mapper |
getMapper() |
boolean |
getMapperContextRootRedirectEnabled()
Determines if requests for a web application context root will be
redirected (adding a trailing slash) by the Mapper.
|
boolean |
getMapperDirectoryRedirectEnabled()
Determines if requests for a directory will be redirected (adding a
trailing slash) by the Mapper.
|
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.
|
NamingResources |
getNamingResources() |
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() |
boolean |
getOverride() |
ClassLoader |
getParentClassLoader()
Return the parent class loader (if any) for this web application.
|
String |
getPath() |
boolean |
getPaused()
Is this Context paused whilst it is reloaded?
|
boolean |
getPreemptiveAuthentication() |
boolean |
getPrivileged() |
long |
getProcessingTime()
Gets the cumulative processing times of all servlets in this
StandardContext.
|
boolean |
getProcessTlds() |
String |
getPublicId() |
String |
getRealPath(String path)
Return the real path for a given virtual path, if possible; otherwise
return
null . |
boolean |
getReloadable() |
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.
|
boolean |
getSendRedirectBody() |
String |
getServer() |
ServletContext |
getServletContext() |
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() |
long |
getStartTime()
Gets the time this context was started.
|
long |
getStartupTime()
Gets the time (in milliseconds) it took to start this context.
|
DirContext |
getStaticResources()
Deprecated.
|
boolean |
getSwallowAbortedUploads()
Returns
true if remaining request data will be read
(swallowed) even the request violates a data size constraint. |
boolean |
getSwallowOutput() |
boolean |
getTldNamespaceAware()
*.tld files are always parsed using a namespace aware parser.
|
long |
getTldScanTime() |
boolean |
getTldValidation()
Will the parsing of *.tld files for this Context be performed by a
validating parser?
|
long |
getUnloadDelay() |
boolean |
getUnpackWAR() |
boolean |
getUseHttpOnly()
Gets the value of the use HttpOnly cookies for session cookies flag.
|
boolean |
getUseRelativeRedirects()
Will HTTP 1.1 and later location headers generated by a call to
HttpServletResponse.sendRedirect(String) use
relative or absolute redirects. |
boolean |
getValidateClientProvidedNewSessionId()
Will client provided session IDs be validated (see
Context.setValidateClientProvidedNewSessionId(boolean) ) before use? |
String |
getWebappVersion() |
String[] |
getWelcomeFiles() |
String |
getWorkDir() |
String |
getWorkPath()
Get the absolute path to the work dir.
|
String |
getWrapperClass() |
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?
|
void |
incrementInProgressAsyncCount() |
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 |
isAllowLinking() |
boolean |
isCachingAllowed() |
boolean |
isEventProvider()
Deprecated.
|
boolean |
isFilesystemBased()
Deprecated.
|
boolean |
isReplaceWelcomeFiles()
Deprecated.
|
boolean |
isResourceOnlyServlet(String servletName)
Checks the named Servlet to see if it expects a resource to be present.
|
boolean |
isSaveConfig()
Deprecated.
|
boolean |
isServlet22()
Are we processing a version 2.2 deployment descriptor?
|
boolean |
isStateManageable() |
boolean |
isStatisticsProvider()
Deprecated.
|
boolean |
isUseNaming() |
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.
|
boolean |
resourcesStart()
Allocate resources, including proxy.
|
boolean |
resourcesStop()
Deallocate resources and destroy proxy.
|
void |
setAddWebinfClassesResources(boolean addWebinfClassesResources) |
void |
setAliases(String aliases)
Set the current alias configuration.
|
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 |
setAllowLinking(boolean allowLinking)
Set allow linking.
|
void |
setAllowMultipleLeadingForwardSlashInPath(boolean allowMultipleLeadingForwardSlashInPath)
Configure if, when returning a context path from
HttpServletRequest.getContextPath() , the return value
is allowed to contain multiple leading '/' characters. |
void |
setAltDDName(String altDDName)
Set an alternate Deployment Descriptor name.
|
void |
setAntiJARLocking(boolean antiJARLocking)
Set the antiJARLocking feature for this Context.
|
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 |
setCacheMaxSize(int cacheMaxSize)
Set the maximum size of the cache in KB.
|
void |
setCacheObjectMaxSize(int cacheObjectMaxSize)
Set the maximum size of objects to be placed the cache in KB.
|
void |
setCacheTTL(int cacheTTL)
Set cache TTL.
|
void |
setCachingAllowed(boolean cachingAllowed)
Set caching allowed flag.
|
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 |
setClearReferencesObjectStreamClassCaches(boolean clearReferencesObjectStreamClassCaches) |
void |
setClearReferencesRmiTargets(boolean clearReferencesRmiTargets) |
void |
setClearReferencesStatic(boolean clearReferencesStatic)
Deprecated.
This option will be removed in Tomcat 8.5
|
void |
setClearReferencesStopThreads(boolean clearReferencesStopThreads)
Set the clearReferencesStopThreads feature for this Context.
|
void |
setClearReferencesStopTimerThreads(boolean clearReferencesStopTimerThreads)
Set the clearReferencesStopTimerThreads feature for this Context.
|
void |
setClearReferencesThreadLocals(boolean clearReferencesThreadLocals) |
void |
setCompilerClasspath(String compilerClasspath)
Deprecated.
|
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 |
setCookies(boolean cookies)
Set the "use cookies for session ids" flag.
|
void |
setCopyXML(boolean copyXML)
Allows copying a bundled context.xml file to the host configuration base
folder on deployment.
|
void |
setCreateUploadTargets(boolean createUploadTargets)
Configure whether Tomcat will attempt to create an upload target used by
this web application if it does not exist when the web application
attempts to use it.
|
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 |
setDispatchersUseEncodedPaths(boolean dispatchersUseEncodedPaths)
Are paths used in calls to obtain a request dispatcher expected to be
encoded?
|
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 |
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 |
setMapperContextRootRedirectEnabled(boolean mapperContextRootRedirectEnabled)
If enabled, requests for a web application context root will be
redirected (adding a trailing slash) by the Mapper.
|
void |
setMapperDirectoryRedirectEnabled(boolean mapperDirectoryRedirectEnabled)
If enabled, requests for a directory will be redirected (adding a
trailing slash) by the Mapper.
|
void |
setNamingContextListener(NamingContextListener namingContextListener)
Naming context listener setter.
|
void |
setNamingResources(NamingResources 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 |
setProcessTlds(boolean newProcessTlds)
Sets the process TLDs attribute.
|
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(DirContext resources)
Set the resources DirContext object with which this Container is
associated.
|
void |
setSaveConfig(boolean saveConfig)
Deprecated.
|
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 |
setTldNamespaceAware(boolean tldNamespaceAware)
*.tld files are always parsed using a namespace aware parser.
|
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 |
setUseRelativeRedirects(boolean useRelativeRedirects)
Controls whether HTTP 1.1 and later location headers generated by a call
to
HttpServletResponse.sendRedirect(String)
will use relative or absolute redirects. |
void |
setValidateClientProvidedNewSessionId(boolean validateClientProvidedNewSessionId)
When a client provides the ID for a new session, should that ID be
validated?
|
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() . |
void |
startRecursive()
Deprecated.
|
protected void |
stopInternal()
Stop this component and implement the requirements
of
LifecycleBase.stopInternal() . |
String |
toString() |
protected void |
unbindThread(ClassLoader oldContextClassLoader)
Unbind thread and restore the specified context classloader.
|
boolean |
wasCreatedDynamicServlet(Servlet servlet) |
addContainerListener, addPropertyChangeListener, addValve, findChild, findChildren, findContainerListeners, fireContainerEvent, getAccessLog, getBackgroundProcessorDelay, getChildren, getCluster, getClusterInternal, getDomainInternal, getLoader, getLoaderInternal, getLogger, getManager, getManagerInternal, getMappingObject, getName, getParent, getPipeline, getRealm, getRealmInternal, getResources, getResourcesInternal, getStartChildren, getStartStopThreads, invoke, logAccess, logName, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setLoader, setManager, setName, setParent, setParentClassLoader, setRealm, setStartChildren, setStartStopThreads, threadStart, threadStop
getDomain, getObjectName, postDeregister, postRegister, preDeregister, preRegister, register, setDomain, unregister
addLifecycleListener, destroy, findLifecycleListeners, fireLifecycleEvent, getState, getStateName, getThrowOnFailure, init, removeLifecycleListener, setState, setState, setThrowOnFailure, start, stop
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addContainerListener, addPropertyChangeListener, findChild, findChildren, findContainerListeners, fireContainerEvent, getAccessLog, getBackgroundProcessorDelay, getCluster, getLoader, getLogger, getManager, getMappingObject, getName, getObjectName, getParent, getPipeline, getRealm, getResources, getStartStopThreads, invoke, logAccess, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setLoader, setManager, setName, setParent, setParentClassLoader, setRealm, setStartStopThreads
addLifecycleListener, destroy, findLifecycleListeners, getState, getStateName, init, removeLifecycleListener, start, stop
protected static URLEncoder urlEncoder
protected boolean allowCasualMultipartParsing
protected ApplicationContext context
protected boolean allowLinking
protected int cacheMaxSize
protected int cacheObjectMaxSize
protected int cacheTTL
public StandardContext()
public void setCreateUploadTargets(boolean createUploadTargets)
Context
setCreateUploadTargets
in interface Context
createUploadTargets
- true
if Tomcat should attempt to
create the upload target, otherwise false
public boolean getCreateUploadTargets()
Context
getCreateUploadTargets
in interface Context
true
if Tomcat will attempt to create an upload target
otherwise false
public void incrementInProgressAsyncCount()
incrementInProgressAsyncCount
in interface Context
public void decrementInProgressAsyncCount()
decrementInProgressAsyncCount
in interface Context
public long getInProgressAsyncCount()
public void setAllowMultipleLeadingForwardSlashInPath(boolean allowMultipleLeadingForwardSlashInPath)
Context
HttpServletRequest.getContextPath()
, the return value
is allowed to contain multiple leading '/' characters.setAllowMultipleLeadingForwardSlashInPath
in interface Context
allowMultipleLeadingForwardSlashInPath
- The new value for the flagpublic boolean getAllowMultipleLeadingForwardSlashInPath()
Context
HttpServletRequest.getContextPath()
, is it allowed to
contain multiple leading '/' characters?getAllowMultipleLeadingForwardSlashInPath
in interface Context
true
if multiple leading '/' characters are allowed,
otherwise false
public void setDispatchersUseEncodedPaths(boolean dispatchersUseEncodedPaths)
Context
setDispatchersUseEncodedPaths
in interface Context
dispatchersUseEncodedPaths
- true
to use encoded paths,
otherwise false
public boolean getDispatchersUseEncodedPaths()
The default value for this implementation is true
.
getDispatchersUseEncodedPaths
in interface Context
true
if encoded paths will be used, otherwise
false
public void setUseRelativeRedirects(boolean useRelativeRedirects)
Context
HttpServletResponse.sendRedirect(String)
will use relative or absolute redirects.
Relative redirects are more efficient but may not work with reverse proxies that change the context path. It should be noted that it is not recommended to use a reverse proxy to change the context path because of the multiple issues it creates.
Absolute redirects should work with reverse proxies that change the
context path but may cause issues with the
RemoteIpFilter
if the filter is
changing the scheme and/or port.
setUseRelativeRedirects
in interface Context
useRelativeRedirects
- true
to use relative redirects and
false
to use absolute redirectspublic boolean getUseRelativeRedirects()
HttpServletResponse.sendRedirect(String)
use
relative or absolute redirects.
The default value for this implementation is true
.
getUseRelativeRedirects
in interface Context
true
if relative redirects will be used false
if
absolute redirects are used.Context.setUseRelativeRedirects(boolean)
public void setMapperContextRootRedirectEnabled(boolean mapperContextRootRedirectEnabled)
Context
setMapperContextRootRedirectEnabled
in interface Context
mapperContextRootRedirectEnabled
- Should the redirects be enabled?public boolean getMapperContextRootRedirectEnabled()
The default value for this implementation is false
.
getMapperContextRootRedirectEnabled
in interface Context
true
if the Mapper level redirect is enabled for this
Context.public void setMapperDirectoryRedirectEnabled(boolean mapperDirectoryRedirectEnabled)
Context
setMapperDirectoryRedirectEnabled
in interface Context
mapperDirectoryRedirectEnabled
- Should the redirects be enabled?public boolean getMapperDirectoryRedirectEnabled()
The default value for this implementation is false
.
getMapperDirectoryRedirectEnabled
in interface Context
true
if the Mapper level redirect is enabled for this
Context.public void setValidateClientProvidedNewSessionId(boolean validateClientProvidedNewSessionId)
Context
/
setValidateClientProvidedNewSessionId
in interface Context
validateClientProvidedNewSessionId
- true
if validation should be appliedpublic boolean getValidateClientProvidedNewSessionId()
Context.setValidateClientProvidedNewSessionId(boolean)
) before use?
The default value for this implementation is true
.
getValidateClientProvidedNewSessionId
in interface Context
true
if validation will be applied. Otherwise, false
public void setContainerSciFilter(String containerSciFilter)
Context
Matcher.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 Context
containerSciFilter
- The regular expression against which the fully
qualified class name of each container provided
SCI should be checkedpublic String getContainerSciFilter()
Context
Matcher.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 Context
public boolean getSendRedirectBody()
getSendRedirectBody
in interface Context
public void setSendRedirectBody(boolean sendRedirectBody)
Context
setSendRedirectBody
in interface Context
sendRedirectBody
- true
to send a response body for redirectspublic boolean getPreemptiveAuthentication()
getPreemptiveAuthentication
in interface Context
public void setPreemptiveAuthentication(boolean preemptiveAuthentication)
Context
setPreemptiveAuthentication
in interface Context
preemptiveAuthentication
- true
to perform authentication even outside
security constraintspublic void setFireRequestListenersOnForwards(boolean enable)
Context
setFireRequestListenersOnForwards
in interface Context
enable
- true
to fire request listeners when forwardingpublic boolean getFireRequestListenersOnForwards()
getFireRequestListenersOnForwards
in interface Context
public void setAddWebinfClassesResources(boolean addWebinfClassesResources)
public boolean getAddWebinfClassesResources()
public void setWebappVersion(String webappVersion)
Context
setWebappVersion
in interface Context
webappVersion
- The webapp version associated with the context,
which should be uniquepublic String getWebappVersion()
getWebappVersion
in interface Context
public String getBaseName()
getBaseName
in interface Context
public String getResourceOnlyServlets()
Context
getResourceOnlyServlets
in interface Context
public void setResourceOnlyServlets(String resourceOnlyServlets)
Context
setResourceOnlyServlets
in interface Context
resourceOnlyServlets
- The Servlet names comma separated listpublic boolean isResourceOnlyServlet(String servletName)
Context
isResourceOnlyServlet
in interface Context
servletName
- Name of the Servlet (as per web.xml) to checktrue
if the Servlet expects a resource,
otherwise false
public int getEffectiveMajorVersion()
getEffectiveMajorVersion
in interface Context
public void setEffectiveMajorVersion(int effectiveMajorVersion)
Context
setEffectiveMajorVersion
in interface Context
effectiveMajorVersion
- Set the version numberpublic int getEffectiveMinorVersion()
getEffectiveMinorVersion
in interface Context
public void setEffectiveMinorVersion(int effectiveMinorVersion)
Context
setEffectiveMinorVersion
in interface Context
effectiveMinorVersion
- Set the version numberpublic void setLogEffectiveWebXml(boolean logEffectiveWebXml)
Context
setLogEffectiveWebXml
in interface Context
logEffectiveWebXml
- set to true
to log the complete
web.xml that will be used for the webapppublic boolean getLogEffectiveWebXml()
Context
getLogEffectiveWebXml
in interface Context
public Authenticator getAuthenticator()
getAuthenticator
in interface Context
Authenticator
that is used by this context. This is
always non-null
for a started Contextpublic JarScanner getJarScanner()
Context
getJarScanner
in interface Context
public void setJarScanner(JarScanner jarScanner)
Context
setJarScanner
in interface Context
jarScanner
- The Jar Scanner to be used for this context.public InstanceManager getInstanceManager()
getInstanceManager
in interface Context
public void setInstanceManager(InstanceManager instanceManager)
Context
setInstanceManager
in interface Context
instanceManager
- the new instance manager instancepublic String getEncodedPath()
Context
getEncodedPath
in interface Context
public boolean isCachingAllowed()
public void setCachingAllowed(boolean cachingAllowed)
cachingAllowed
- true
to permit cachingpublic void setAllowLinking(boolean allowLinking)
allowLinking
- true
to permit linkingpublic boolean isAllowLinking()
public 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 Context
allowCasualMultipartParsing
- 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 Context
true
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 Context
swallowAbortedUploads
- 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 Context
true
if data will be swallowed (default),
false
otherwise.public void setCacheTTL(int cacheTTL)
cacheTTL
- Time between cache entry revalidation in millisecondspublic int getCacheTTL()
public int getCacheMaxSize()
public void setCacheMaxSize(int cacheMaxSize)
cacheMaxSize
- Maximum size of the cache in KBpublic int getCacheObjectMaxSize()
public void setCacheObjectMaxSize(int cacheObjectMaxSize)
cacheObjectMaxSize
- Maximum size of the objects in the cache in KBpublic String getAliases()
public void addResourceJarUrl(URL url)
addResourceJarUrl
in interface Context
url
- URL of resource JARpublic void addResourcesDirContext(DirContext altDirContext)
altDirContext
- static resources to be added to this contextpublic void setAliases(String aliases)
aliases
- List of aliases for this contextpublic void addServletContainerInitializer(ServletContainerInitializer sci, Set<Class<?>> classes)
addServletContainerInitializer
in interface Context
sci
- The instance to addclasses
- The classes in which the initializer expressed an
interestpublic boolean getDelegate()
true
if classloading delegates to the parent classloader firstpublic void setDelegate(boolean delegate)
delegate
- The new flagpublic boolean isUseNaming()
public void setUseNaming(boolean useNaming)
useNaming
- true
to enable the naming environment@Deprecated public boolean isFilesystemBased()
true
if the resources associated with this context are
filesystem based.public Object[] getApplicationEventListeners()
getApplicationEventListeners
in interface Context
IllegalStateException
- if this method is called before
this application has started, or after it has been stoppedpublic void setApplicationEventListeners(Object[] listeners)
setApplicationEventListeners
in interface Context
listeners
- The set of instantiated listener objects.public void addApplicationEventListener(Object listener)
listener
- The listener to addpublic Object[] getApplicationLifecycleListeners()
getApplicationLifecycleListeners
in interface Context
IllegalStateException
- if this method is called before
this application has started, or after it has been stoppedpublic void setApplicationLifecycleListeners(Object[] listeners)
setApplicationLifecycleListeners
in interface Context
listeners
- The set of instantiated listener objects.public void addApplicationLifecycleListener(Object listener)
listener
- The listener to addpublic boolean getAntiJARLocking()
public boolean getAntiResourceLocking()
public void setAntiJARLocking(boolean antiJARLocking)
antiJARLocking
- The new flag valuepublic void setAntiResourceLocking(boolean antiResourceLocking)
antiResourceLocking
- The new flag valuepublic boolean getAvailable()
getAvailable
in interface Context
public CharsetMapper getCharsetMapper()
getCharsetMapper
in interface Context
public void setCharsetMapper(CharsetMapper mapper)
setCharsetMapper
in interface Context
mapper
- The new mapperpublic String getCharset(Locale locale)
Context
getCharset
in interface Context
locale
- The locale for which the mapped character set should be
returnedpublic URL getConfigFile()
Context
getConfigFile
in interface Context
public void setConfigFile(URL configFile)
Context
setConfigFile
in interface Context
configFile
- The URL of the XML descriptor for this context.public boolean getConfigured()
Context
getConfigured
in interface Context
true
if the Context has been correctly configured,
otherwise false
public void setConfigured(boolean configured)
setConfigured
in interface Context
configured
- The new correctly configured flagpublic boolean getCookies()
Context
getCookies
in interface Context
true
if it is permitted to use cookies to track
session IDs for this web application, otherwise
false
public void setCookies(boolean cookies)
setCookies
in interface Context
cookies
- The new flagpublic String getSessionCookieName()
getSessionCookieName
in interface Context
public void setSessionCookieName(String sessionCookieName)
setSessionCookieName
in interface Context
sessionCookieName
- The name to usepublic boolean getUseHttpOnly()
getUseHttpOnly
in interface Context
true
if the HttpOnly flag should be set on session
cookiespublic void setUseHttpOnly(boolean useHttpOnly)
setUseHttpOnly
in interface Context
useHttpOnly
- Set to true
to use HttpOnly cookies
for session cookiespublic String getSessionCookieDomain()
getSessionCookieDomain
in interface Context
public void setSessionCookieDomain(String sessionCookieDomain)
setSessionCookieDomain
in interface Context
sessionCookieDomain
- The domain to usepublic String getSessionCookiePath()
getSessionCookiePath
in interface Context
public void setSessionCookiePath(String sessionCookiePath)
setSessionCookiePath
in interface Context
sessionCookiePath
- The path to usepublic boolean getSessionCookiePathUsesTrailingSlash()
Context
getSessionCookiePathUsesTrailingSlash
in interface Context
true
if the slash is added, otherwise
false
public void setSessionCookiePathUsesTrailingSlash(boolean sessionCookiePathUsesTrailingSlash)
Context
setSessionCookiePathUsesTrailingSlash
in interface Context
sessionCookiePathUsesTrailingSlash
- true
if the
slash is should be added,
otherwise false
public boolean getCrossContext()
getCrossContext
in interface Context
true
if cross-contest requests are allowed from this
web applications, otherwise false
public void setCrossContext(boolean crossContext)
setCrossContext
in interface Context
crossContext
- 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 String getDisplayName()
Context
getDisplayName
in interface Context
public String getAltDDName()
Context
getAltDDName
in interface Context
public void setAltDDName(String altDDName)
setAltDDName
in interface Context
altDDName
- The new name@Deprecated public String getCompilerClasspath()
@Deprecated public void setCompilerClasspath(String compilerClasspath)
compilerClasspath
- The new compiler classpathpublic void setDisplayName(String displayName)
setDisplayName
in interface Context
displayName
- The new display namepublic boolean getDistributable()
Context
getDistributable
in interface Context
public void setDistributable(boolean distributable)
setDistributable
in interface Context
distributable
- The new distributable flagpublic String getDocBase()
Context
getDocBase
in interface Context
public void setDocBase(String docBase)
Context
setDocBase
in interface Context
docBase
- The new document rootpublic String getInfo()
<description>/<version>
.getInfo
in interface Container
getInfo
in class ContainerBase
<description>/<version>
.public String getJ2EEApplication()
public void setJ2EEApplication(String j2EEApplication)
public String getJ2EEServer()
public void setJ2EEServer(String j2EEServer)
public boolean getIgnoreAnnotations()
Context
getIgnoreAnnotations
in interface Context
public void setIgnoreAnnotations(boolean ignoreAnnotations)
setIgnoreAnnotations
in interface Context
ignoreAnnotations
- The boolean on the annotations parsingpublic LoginConfig getLoginConfig()
getLoginConfig
in interface Context
public void setLoginConfig(LoginConfig config)
setLoginConfig
in interface Context
config
- The new login configurationpublic Mapper getMapper()
public NamingResources getNamingResources()
getNamingResources
in interface Context
public void setNamingResources(NamingResources namingResources)
setNamingResources
in interface Context
namingResources
- The new naming resourcespublic String getPath()
public void setPath(String path)
public String getPublicId()
getPublicId
in interface Context
public void setPublicId(String publicId)
setPublicId
in interface Context
publicId
- The public identifierpublic boolean getReloadable()
getReloadable
in interface Context
public boolean getOverride()
getOverride
in interface Context
public String getOriginalDocBase()
public void setOriginalDocBase(String docBase)
docBase
- The original document rootpublic ClassLoader getParentClassLoader()
ContainerBase
getParentClassLoader
in interface Container
getParentClassLoader
in class ContainerBase
public boolean getPrivileged()
getPrivileged
in interface Context
public void setPrivileged(boolean privileged)
setPrivileged
in interface Context
privileged
- The new privileged flagpublic void setReloadable(boolean reloadable)
setReloadable
in interface Context
reloadable
- The new reloadable flagpublic void setOverride(boolean override)
setOverride
in interface Context
override
- The new override flag@Deprecated public boolean isReplaceWelcomeFiles()
public void setReplaceWelcomeFiles(boolean replaceWelcomeFiles)
replaceWelcomeFiles
- The new property valuepublic ServletContext getServletContext()
getServletContext
in interface Context
public int getSessionTimeout()
getSessionTimeout
in interface Context
public void setSessionTimeout(int timeout)
setSessionTimeout
in interface Context
timeout
- The new default session timeoutpublic boolean getSwallowOutput()
getSwallowOutput
in interface Context
public void setSwallowOutput(boolean swallowOutput)
setSwallowOutput
in interface Context
swallowOutput
- The new valuepublic long getUnloadDelay()
public void setUnloadDelay(long unloadDelay)
unloadDelay
- The new valuepublic boolean getUnpackWAR()
public void setUnpackWAR(boolean unpackWAR)
unpackWAR
- true
to unpack WARs on deploymentpublic boolean getCopyXML()
true
if the META-INF/context.xml
file included
in a WAR will be copied to the host configuration base folder on deploymentpublic void setCopyXML(boolean copyXML)
copyXML
- the new flag valuepublic String getWrapperClass()
getWrapperClass
in interface Context
public void setWrapperClass(String wrapperClassName)
setWrapperClass
in interface Context
wrapperClassName
- The new wrapper class nameIllegalArgumentException
- if the specified wrapper class
cannot be found or is not a subclass of StandardWrapperpublic void setResources(DirContext resources)
setResources
in interface Container
setResources
in class ContainerBase
resources
- The newly associated DirContextpublic JspConfigDescriptor getJspConfigDescriptor()
getJspConfigDescriptor
in interface Context
public boolean getJndiExceptionOnFailedWrite()
public void setJndiExceptionOnFailedWrite(boolean jndiExceptionOnFailedWrite)
jndiExceptionOnFailedWrite
- false
to avoid an exceptionpublic 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 getClearReferencesRmiTargets()
public void setClearReferencesRmiTargets(boolean clearReferencesRmiTargets)
@Deprecated public boolean isSaveConfig()
@Deprecated public void setSaveConfig(boolean saveConfig)
saveConfig
- New flag value@Deprecated public boolean getClearReferencesStatic()
@Deprecated 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 getClearReferencesObjectStreamClassCaches()
public void setClearReferencesObjectStreamClassCaches(boolean clearReferencesObjectStreamClassCaches)
public boolean getClearReferencesThreadLocals()
public void setClearReferencesThreadLocals(boolean clearReferencesThreadLocals)
public Boolean getFailCtxIfServletStartFails()
public void setFailCtxIfServletStartFails(Boolean failCtxIfServletStartFails)
protected boolean getComputedFailCtxIfServletStartFails()
public void addApplicationListener(String listener)
Context
addApplicationListener
in interface Context
listener
- Java class name of a listener classpublic void addApplicationListener(ApplicationListener listener)
Context
The ApplicationListener
class is used to pass an additional
parameter that allows to differentiate listeners to Web Application added
via configuration (web.xml or annotations) vs. ones added by frameworks,
such as listeners declared in JSP tag libraries (TLD files) that are
added by Jasper JSP Engine.
The recommended method to call for the first use case is
Context.addApplicationListener(String)
. The recommended replacement for
the second use case is to use addListener(...)
methods in
ServletContext
.
addApplicationListener
in interface Context
listener
- Definition of a listener, including its java class name.public void addApplicationParameter(ApplicationParameter parameter)
addApplicationParameter
in interface Context
parameter
- The new application parameterpublic void addChild(Container child)
addChild
in interface Container
addChild
in class ContainerBase
child
- Child container to be addedIllegalArgumentException
- if the proposed container is
not an implementation of Wrapperpublic void addConstraint(SecurityConstraint constraint)
addConstraint
in interface Context
constraint
- The security constraint that should be addedpublic void addErrorPage(ErrorPage errorPage)
addErrorPage
in interface Context
errorPage
- The error page definition to be addedpublic void addFilterDef(FilterDef filterDef)
addFilterDef
in interface Context
filterDef
- The filter definition to be addedpublic void addFilterMap(FilterMap filterMap)
addFilterMap
in interface Context
filterMap
- 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 Context
filterMap
- 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 Context
listener
- Java class name of an InstanceListener classpublic void addLocaleEncodingMappingParameter(String locale, String encoding)
addLocaleEncodingMappingParameter
in interface Context
locale
- 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 Context
extension
- Filename extension being mappedmimeType
- Corresponding MIME typepublic void addParameter(String name, String value)
addParameter
in interface Context
name
- 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 Context
role
- Security role used in the applicationlink
- Actual security role to check forpublic void addSecurityRole(String role)
addSecurityRole
in interface Context
role
- New security rolepublic void addServletMapping(String pattern, String name)
addServletMapping
in interface Context
pattern
- 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 Context
pattern
- 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 Context
name
- New watched resource file namepublic void addWelcomeFile(String name)
addWelcomeFile
in interface Context
name
- New welcome file namepublic void addWrapperLifecycle(String listener)
addWrapperLifecycle
in interface Context
listener
- Java class name of a LifecycleListener classpublic void addWrapperListener(String listener)
addWrapperListener
in interface Context
listener
- Java class name of a ContainerListener classpublic Wrapper createWrapper()
createWrapper
in interface Context
public String[] findApplicationListeners()
findApplicationListeners
in interface Context
public ApplicationParameter[] findApplicationParameters()
findApplicationParameters
in interface Context
public SecurityConstraint[] findConstraints()
findConstraints
in interface Context
public ErrorPage findErrorPage(int errorCode)
null
.findErrorPage
in interface Context
errorCode
- Error code to look upnull
.public ErrorPage findErrorPage(String exceptionType)
null
.findErrorPage
in interface Context
exceptionType
- Exception type to look upnull
.public ErrorPage[] findErrorPages()
findErrorPages
in interface Context
public FilterDef findFilterDef(String filterName)
null
.findFilterDef
in interface Context
filterName
- Filter name to look upnull
.public FilterDef[] findFilterDefs()
findFilterDefs
in interface Context
public FilterMap[] findFilterMaps()
findFilterMaps
in interface Context
public String[] findInstanceListeners()
findInstanceListeners
in interface Context
@Deprecated public Context findMappingObject()
public MessageDestination findMessageDestination(String name)
name
- Name of the desired message destinationnull
.public MessageDestination[] findMessageDestinations()
public MessageDestinationRef findMessageDestinationRef(String name)
name
- Name of the desired message destination refnull
.public MessageDestinationRef[] findMessageDestinationRefs()
public String findMimeMapping(String extension)
findMimeMapping
in interface Context
extension
- Extension to map to a MIME typenull
.public String[] findMimeMappings()
findMimeMappings
in interface Context
public String findParameter(String name)
findParameter
in interface Context
name
- Name of the parameter to returnnull
.public String[] findParameters()
findParameters
in interface Context
public String findRoleMapping(String role)
findRoleMapping
in interface Context
role
- Security role to mappublic boolean findSecurityRole(String role)
findSecurityRole
in interface Context
role
- Security role to verifytrue
if the specified security role is defined
for this application; otherwise return false
.public String[] findSecurityRoles()
findSecurityRoles
in interface Context
public String findServletMapping(String pattern)
findServletMapping
in interface Context
pattern
- Pattern for which a mapping is requestednull
.public String[] findServletMappings()
findServletMappings
in interface Context
public String findStatusPage(int status)
null
.findStatusPage
in interface Context
status
- HTTP status code to look upnull
.public int[] findStatusPages()
findStatusPages
in interface Context
public boolean findWelcomeFile(String name)
findWelcomeFile
in interface Context
name
- Welcome file to verifytrue
if the specified welcome file is defined
for this Context; otherwise return false
.public String[] findWatchedResources()
findWatchedResources
in interface Context
public String[] findWelcomeFiles()
findWelcomeFiles
in interface Context
public String[] findWrapperLifecycles()
findWrapperLifecycles
in interface Context
public String[] findWrapperListeners()
findWrapperListeners
in interface Context
public 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 Context
IllegalStateException
- if the reloadable
property is set to false
.public void removeApplicationListener(String listener)
removeApplicationListener
in interface Context
listener
- Java class name of the listener to be removedpublic void removeApplicationParameter(String name)
removeApplicationParameter
in interface Context
name
- Name of the application parameter to removepublic void removeChild(Container child)
removeChild
in interface Container
removeChild
in class ContainerBase
child
- Child container to be addedIllegalArgumentException
- if the proposed container is
not an implementation of Wrapperpublic void removeConstraint(SecurityConstraint constraint)
removeConstraint
in interface Context
constraint
- Constraint to be removedpublic void removeErrorPage(ErrorPage errorPage)
removeErrorPage
in interface Context
errorPage
- The error page definition to be removedpublic void removeFilterDef(FilterDef filterDef)
removeFilterDef
in interface Context
filterDef
- Filter definition to be removedpublic void removeFilterMap(FilterMap filterMap)
removeFilterMap
in interface Context
filterMap
- The filter mapping to be removedpublic void removeInstanceListener(String listener)
removeInstanceListener
in interface Context
listener
- 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 Context
extension
- Extension to remove the mapping forpublic void removeParameter(String name)
removeParameter
in interface Context
name
- Name of the parameter to removepublic void removeRoleMapping(String role)
removeRoleMapping
in interface Context
role
- Security role (as used in the application) to removepublic void removeSecurityRole(String role)
removeSecurityRole
in interface Context
role
- Security role to removepublic void removeServletMapping(String pattern)
removeServletMapping
in interface Context
pattern
- URL pattern of the mapping to removepublic void removeWatchedResource(String name)
removeWatchedResource
in interface Context
name
- Name of the watched resource to be removedpublic void removeWelcomeFile(String name)
removeWelcomeFile
in interface Context
name
- Name of the welcome file to be removedpublic void removeWrapperLifecycle(String listener)
removeWrapperLifecycle
in interface Context
listener
- Class name of a LifecycleListener class to be removedpublic void removeWrapperListener(String listener)
removeWrapperListener
in interface Context
listener
- 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 Context
path
- The path to the desired resourcenull
.@Deprecated public ServletRegistration.Dynamic dynamicServletAdded(Wrapper wrapper)
wrapper
- The wrapper for which the registration should be created.public void dynamicServletCreated(Servlet servlet)
ServletContext.createServlet(Class)
.servlet
- the created Servletpublic boolean wasCreatedDynamicServlet(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 boolean resourcesStart()
true
if initialization was successfull,
or false
otherwise.public boolean resourcesStop()
true
if no error occurredpublic boolean loadOnStartup(Container[] children)
children
- Array of wrappers for all currently defined
servlets (including those not declared load on startup)true
if load on startup was considered successfulprotected void startInternal() throws LifecycleException
LifecycleBase.startInternal()
.startInternal
in class ContainerBase
LifecycleException
- if this component detects a fatal error
that prevents this component from being usedprotected void stopInternal() throws LifecycleException
LifecycleBase.stopInternal()
.stopInternal
in class ContainerBase
LifecycleException
- if this component detects a fatal error
that prevents this component from being usedprotected void destroyInternal() throws LifecycleException
destroyInternal
in class ContainerBase
LifecycleException
- If the destruction failspublic void backgroundProcess()
ContainerBase
backgroundProcess
in interface Container
backgroundProcess
in class ContainerBase
protected String adjustURLPattern(String urlPattern)
urlPattern
- The URL pattern to be adjusted (if needed)
and returnedpublic boolean isServlet22()
isServlet22
in interface Context
true
if running a legacy Servlet 2.2 applicationpublic Set<String> addServletSecurity(ApplicationServletRegistration registration, ServletSecurityElement servletSecurityElement)
Context
ServletRegistration.Dynamic
addServletSecurity
in interface Context
registration
- Servlet security was modified forservletSecurityElement
- new security constraints for this Servletprotected File engineBase()
protected ClassLoader bindThread()
protected void unbindThread(ClassLoader oldContextClassLoader)
oldContextClassLoader
- the previous classloaderprotected String getBasePath()
protected String getAppBase()
public NamingContextListener getNamingContextListener()
public void setNamingContextListener(NamingContextListener namingContextListener)
namingContextListener
- the new naming context listenerpublic boolean getPaused()
Context
@Deprecated public String getHostname()
public boolean fireRequestInitEvent(ServletRequest request)
Context
ServletRequestListener
s that a request
has started.fireRequestInitEvent
in interface Context
request
- The request object that will be passed to the listenertrue
if the listeners fire successfully, else
false
public boolean fireRequestDestroyEvent(ServletRequest request)
Context
ServletRequestListener
s that a request
has ended.fireRequestDestroyEvent
in interface Context
request
- The request object that will be passed to the listenertrue
if the listeners fire successfully, else
false
public void addPostConstructMethod(String clazz, String method)
Context
addPostConstructMethod
in interface Context
clazz
- Fully qualified class namemethod
- Post construct method namepublic void removePostConstructMethod(String clazz)
Context
removePostConstructMethod
in interface Context
clazz
- Fully qualified class namepublic void addPreDestroyMethod(String clazz, String method)
Context
addPreDestroyMethod
in interface Context
clazz
- Fully qualified class namemethod
- Post construct method namepublic void removePreDestroyMethod(String clazz)
Context
removePreDestroyMethod
in interface Context
clazz
- Fully qualified class namepublic String findPostConstructMethod(String clazz)
Context
NULL
will be
returned.findPostConstructMethod
in interface Context
clazz
- Fully qualified class nameNULL
will
be returned.public String findPreDestroyMethod(String clazz)
Context
NULL
will be returned.findPreDestroyMethod
in interface Context
clazz
- Fully qualified class nameNULL
will be
returned.public Map<String,String> findPostConstructMethods()
Context
findPostConstructMethods
in interface Context
public Map<String,String> findPreDestroyMethods()
Context
findPreDestroyMethods
in interface Context
public String getDeploymentDescriptor()
public String[] getServlets()
protected String getObjectNameKeyProperties()
LifecycleMBeanBase
ObjectName
that will be used to register this component.getObjectNameKeyProperties
in class LifecycleMBeanBase
ObjectName
protected void initInternal() throws LifecycleException
LifecycleMBeanBase
initInternal
in class ContainerBase
LifecycleException
- If the initialisation failspublic void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object object) throws ListenerNotFoundException
removeNotificationListener
in interface NotificationEmitter
ListenerNotFoundException
public MBeanNotificationInfo[] getNotificationInfo()
getNotificationInfo
in interface NotificationBroadcaster
public void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object object) throws IllegalArgumentException
public void removeNotificationListener(NotificationListener listener) throws ListenerNotFoundException
removeNotificationListener
in interface NotificationBroadcaster
ListenerNotFoundException
NotificationBroadcaster.removeNotificationListener(javax.management.NotificationListener)
@Deprecated public DirContext getStaticResources()
@Deprecated public DirContext findStaticResources()
public String[] getWelcomeFiles()
public boolean getXmlNamespaceAware()
Context
getXmlNamespaceAware
in interface Context
public void setXmlNamespaceAware(boolean webXmlNamespaceAware)
Context
setXmlNamespaceAware
in interface Context
webXmlNamespaceAware
- true to enable namespace awarenesspublic void setXmlValidation(boolean webXmlValidation)
Context
setXmlValidation
in interface Context
webXmlValidation
- true to enable xml validationpublic boolean getXmlValidation()
Context
getXmlValidation
in interface Context
public boolean getTldNamespaceAware()
Context
getTldNamespaceAware
in interface Context
true
public void setTldNamespaceAware(boolean tldNamespaceAware)
Context
setTldNamespaceAware
in interface Context
tldNamespaceAware
- ignoredpublic void setXmlBlockExternal(boolean xmlBlockExternal)
Context
setXmlBlockExternal
in interface Context
xmlBlockExternal
- true to block external entitiespublic boolean getXmlBlockExternal()
Context
getXmlBlockExternal
in interface Context
public void setTldValidation(boolean tldValidation)
Context
setTldValidation
in interface Context
tldValidation
- true to enable xml validationpublic boolean getTldValidation()
Context
getTldValidation
in interface Context
public void setProcessTlds(boolean newProcessTlds)
newProcessTlds
- The new valuepublic boolean getProcessTlds()
public boolean isStateManageable()
@Deprecated public void startRecursive() throws LifecycleException
LifecycleException
public String getServer()
public String[] getJavaVMs()
public long getStartTime()
@Deprecated public boolean isEventProvider()
@Deprecated public boolean isStatisticsProvider()
Copyright © 2000-2021 Apache Software Foundation. All Rights Reserved.