public class StandardContext extends ContainerBase implements Context, javax.management.NotificationEmitter
ContainerBase.ContainerBackgroundProcessor, ContainerBase.PrivilegedAddChild| Modifier and Type | Field and Description |
|---|---|
protected boolean |
allowLinking
Allow linking.
|
protected java.lang.String |
altDDName
The alternate deployment descriptor name.
|
protected java.lang.Object[] |
applicationEventListenersInstances
The set of instantiated application event listener objects.
|
protected java.lang.Object[] |
applicationLifecycleListenersInstances
The set of instantiated application lifecycle listener objects.
|
protected java.util.EventListener[] |
applicationListenerInstances
The set of application listener class names configured for this
application, in the order they were encountered in the web.xml file.
|
protected java.lang.String[] |
applicationListeners
The set of application listener class names configured for this
application, in the order they were encountered in the web.xml file.
|
protected ApplicationParameter[] |
applicationParameters
The set of application parameters defined for this application.
|
protected java.lang.Object[] |
applicationSessionLifecycleListenersInstances
The set of instantiated application session lifecycle listener objects.
|
protected Authenticator |
authenticator
The application authenticator for this Context.
|
protected boolean |
available
The application available flag for this Context.
|
protected javax.management.NotificationBroadcasterSupport |
broadcaster
The broadcaster that sends j2ee notifications.
|
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 boolean |
cachingAllowed
Caching allowed flag.
|
protected boolean |
caseSensitive
Case sensitivity.
|
protected CharsetMapper |
charsetMapper
The Locale to character set mapper for this application.
|
protected java.lang.String |
charsetMapperClass
The Java class name of the CharsetMapper class to be created.
|
protected java.lang.String |
configClass
The class name of the context configurator.
|
protected boolean |
configured
The "correctly configured" flag for this Context.
|
protected SecurityConstraint[] |
constraints
The security constraints for this web application.
|
protected ApplicationContext |
context
The ServletContext implementation associated with this Context.
|
protected boolean |
crossContext
Should we allow the
ServletContext.getContext() method
to access the context of other web applications in this server? |
protected static ThreadBindingListener |
DEFAULT_NAMING_LISTENER |
protected java.util.Set<SessionTrackingMode> |
defaultSessionTrackingModes
Session tracking modes.
|
protected java.lang.String |
displayName
The display name of this web application.
|
protected boolean |
distributable
The distributable flag for this web application.
|
protected java.lang.String |
docBase
The document root for this web application.
|
protected java.lang.String |
encodedPath
Encoded path.
|
protected java.lang.String |
engineName
Name of the engine.
|
protected java.util.HashMap<java.lang.String,ErrorPage> |
exceptionPages
The exception pages for this web application, keyed by fully qualified
class name of the Java exception.
|
protected boolean |
filesystemBased
Filesystem based flag.
|
protected java.util.HashMap<java.lang.String,ApplicationFilterConfig> |
filterConfigs
The set of filter configurations (and associated filter instances) we
have initialized, keyed by filter name.
|
protected java.util.HashMap<java.lang.String,FilterDef> |
filterDefs
The set of filter definitions for this application, keyed by
filter name.
|
protected int |
filterMapInsertPoint
Filter mappings added via
ServletContext may have to be inserted
before the mappings in the deploymenmt descriptor but must be inserted in
the order the ServletContext methods are called. |
protected FilterMap[] |
filterMaps
The set of filter mappings for this application, in the order
they were defined in the deployment descriptor with additional mappings
added via the
ServletContext possibly both before and after those
defined in the deployment descriptor. |
protected java.lang.String |
hostName
Associated host name.
|
protected boolean |
ignoreAnnotations
Ignore annotations.
|
protected static java.lang.String |
info
The descriptive information string for this implementation.
|
protected java.lang.String[] |
instanceListeners
The set of classnames of InstanceListeners that will be added
to each newly created Wrapper by
createWrapper(). |
protected InstanceManager |
instanceManager
Lifecycle provider.
|
protected java.lang.String |
j2EEApplication |
protected java.lang.String |
j2EEServer |
protected java.lang.String[] |
javaVMs
The Java virtual machines on which this module is running.
|
protected java.util.LinkedHashMap<java.lang.String,JspPropertyGroup> |
jspPropertyGroups
The set of JSP property groups defined for the webapp, keyed by pattern.
|
protected java.util.HashMap<java.lang.String,TagLibraryInfo> |
jspTagLibraries
The set of taglibs defined for the webapp, keyed by uri.
|
protected java.lang.Object[] |
listenersInstances
The set of instantiated listener objects.
|
protected static Logger |
log |
protected java.lang.String |
logicalName
The logical name of the webapp, if any which may be used in other descriptors.
|
protected LoginConfig |
loginConfig
The login configuration descriptor for this web application.
|
protected Mapper |
mapper
The mapper associated with this context.
|
protected java.util.HashMap<java.lang.String,java.lang.String> |
mimeMappings
The MIME mappings for this web application, keyed by extension.
|
protected javax.management.MBeanNotificationInfo[] |
notificationInfo |
protected ErrorPage |
okErrorPage
Special case: error page for status 200.
|
protected boolean |
override
The override flag for this web application.
|
protected java.util.HashMap<java.lang.String,java.lang.String> |
parameters
The context initialization parameters for this web application,
keyed by name.
|
protected boolean |
paused
The request processing pause flag (while reloading occurs)
|
protected boolean |
privileged
The privileged flag for this web application.
|
protected java.lang.String |
publicId
The public identifier of the DTD for the web application deployment
descriptor version we are currently parsing.
|
protected boolean |
replaceWelcomeFiles
Should the next call to
addWelcomeFile() cause replacement
of any existing welcome files? This will be set before processing the
web application's deployment descriptor, so that application specified
choices replace, rather than append to, those defined
in the global descriptor. |
protected java.util.HashSet<java.lang.String> |
restrictedApplicationListeners
The set of application listener class names configured for this
application that have been added from TLDs, and have a limited access to
the servlet context.
|
protected java.util.HashMap<java.lang.String,java.lang.String> |
roleMappings
The security role mappings for this application, keyed by role
name (as used within the application).
|
protected java.lang.String[] |
securityRoles
The security roles for this application, keyed by role name.
|
protected long |
sequenceNumber
The notification sequence number.
|
protected java.lang.String |
server
The J2EE Server ObjectName this module is deployed on.
|
protected java.util.HashMap<java.lang.String,java.lang.String> |
servletMappings
The servlet mappings for this web application, keyed by
matching pattern.
|
protected SessionCookie |
sessionCookie
The session cookie.
|
protected int |
sessionTimeout
The session timeout (in minutes) for this web application.
|
protected java.util.Set<SessionTrackingMode> |
sessionTrackingModes
Session tracking modes.
|
protected boolean |
starting
The application starting flag for this Context.
|
protected long |
startTime |
protected long |
startupTime |
protected java.util.HashMap<java.lang.Integer,ErrorPage> |
statusPages
The status code error pages for this web application, keyed by
HTTP status code (as an Integer).
|
protected java.util.HashMap<java.lang.String,java.lang.String> |
taglibs
The JSP tag libraries for this web application, keyed by URI
|
protected ThreadBindingListener |
threadBindingListener |
protected long |
tldScanTime |
protected long |
unloadDelay
Amount of ms that the container will wait for servlets to unload.
|
protected static URLEncoder |
urlEncoder
Array containing the safe characters set.
|
protected java.lang.String |
version
Version number.
|
protected int |
versionMajor
Version number.
|
protected int |
versionMinor
Version number.
|
protected javax.naming.directory.DirContext |
webappResources
Non proxied resources.
|
protected java.lang.String[] |
welcomeFiles
The welcome files for this application.
|
protected java.lang.String |
workDir
The pathname to the work directory for this context (relative to
the server's home if not absolute).
|
protected java.lang.Class<?> |
wrapperClass |
protected java.lang.String |
wrapperClassName
Java class name of the Wrapper class implementation we use.
|
protected java.lang.String[] |
wrapperLifecycles
The set of classnames of LifecycleListeners that will be added
to each newly created Wrapper by
createWrapper(). |
protected java.lang.String[] |
wrapperListeners
The set of classnames of ContainerListeners that will be added
to each newly created Wrapper by
createWrapper(). |
backgroundProcessorDelay, children, cluster, CONTAINER_ARRAY, controller, domain, initialized, lifecycle, LISTENER_ARRAY, listeners, loader, logger, logName, manager, mserver, name, oname, parent, parentClassLoader, pipeline, realm, resources, sm, startChildren, started, suffix, support, typeBIND_THREAD_EVENT, COMPLETE_CONFIG_EVENT, RELOAD_EVENT, UNBIND_THREAD_EVENTADD_CHILD_EVENT, ADD_MAPPER_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_MAPPER_EVENT, REMOVE_VALVE_EVENTAFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, DESTROY_EVENT, INIT_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 |
addApplicationFilterConfig(ApplicationFilterConfig filterConfig)
Add a filter definition to this Context.
|
void |
addApplicationListener(java.lang.String listener)
Add a new Listener class name to the set of Listeners
configured for this application.
|
protected void |
addApplicationListener(java.lang.String listener,
boolean restricted)
Add a new Listener class name to the set of Listeners
configured for this application.
|
<T extends java.util.EventListener> |
addApplicationListenerInstance(T listener)
Add a new Listener instance 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(java.lang.String listener)
Add the classname of an InstanceListener to be added to each
Wrapper appended to this Context.
|
void |
addJspMapping(java.lang.String pattern)
Add the given URL pattern as a jsp-property-group.
|
void |
addJspPropertyGroup(JspPropertyGroup propertyGroup)
Add the given jsp-property-group.
|
void |
addJspTagLibrary(java.lang.String uri,
TagLibraryInfo tagLibraryInfo)
Add the given JSP tag library metadata with a specified mapping.
|
void |
addJspTagLibrary(TagLibraryInfo tagLibraryInfo)
Add the given JSP tag library metadata.
|
void |
addLocaleEncodingMappingParameter(java.lang.String locale,
java.lang.String encoding)
Add a Locale Encoding Mapping (see Sec 5.4 of Servlet spec 2.4)
|
void |
addMimeMapping(java.lang.String extension,
java.lang.String mimeType)
Add a new MIME mapping, replacing any existing mapping for
the specified extension.
|
void |
addNotificationListener(javax.management.NotificationListener listener,
javax.management.NotificationFilter filter,
java.lang.Object object) |
void |
addParameter(java.lang.String name,
java.lang.String value)
Add a new context initialization parameter.
|
void |
addRoleMapping(java.lang.String role,
java.lang.String link)
Add a security role reference for this web application.
|
void |
addSecurityRole(java.lang.String role)
Add a new security role for this web application.
|
void |
addServletMapping(java.lang.String pattern,
java.lang.String name)
Add a new servlet mapping, replacing any existing mapping for
the specified pattern.
|
void |
addServletMapping(java.lang.String pattern,
java.lang.String name,
boolean jspWildCard)
Add a new servlet mapping, replacing any existing mapping for
the specified pattern.
|
void |
addSessionTrackingMode(java.lang.String trackingMode)
Add the given session tracking mode.
|
void |
addTaglib(java.lang.String uri,
java.lang.String location)
Add a JSP tag library for the specified URI.
|
void |
addWelcomeFile(java.lang.String name)
Add a new welcome file to the set recognized by this Context.
|
void |
addWrapperLifecycle(java.lang.String listener)
Add the classname of a LifecycleListener to be added to each
Wrapper appended to this Context.
|
void |
addWrapperListener(java.lang.String listener)
Add the classname of a ContainerListener to be added to each
Wrapper appended to this Context.
|
protected java.lang.String |
adjustURLPattern(java.lang.String urlPattern)
Adjust the URL pattern to begin with a leading slash, if appropriate
(i.e.
|
protected java.lang.ClassLoader |
bindThread()
Bind current thread, both for CL purposes and for JNDI ENC support
during : startup, shutdown and realoading of the context.
|
protected void |
checkUnusualURLPattern(java.lang.String urlPattern)
Check for unusual but valid
<url-pattern>s. |
boolean |
contextListenerStart()
Configure the set of instantiated application event listeners
for this Context.
|
protected boolean |
copy(java.io.File src,
java.io.File dest)
Copy a file.
|
void |
create() |
javax.management.ObjectName |
createObjectName(java.lang.String hostDomain,
javax.management.ObjectName parentName) |
Wrapper |
createWrapper()
Factory method to create and return a new Wrapper instance, of
the Java implementation class appropriate for this Context
implementation.
|
void |
destroy()
Destroy needs to clean up the context completely.
|
protected java.io.File |
engineBase()
Return a File object representing the base directory for the
entire servlet container (i.e.
|
protected boolean |
filterStart()
Configure and initialize the set of filters for this Context.
|
protected boolean |
filterStop()
Finalize and release the set of filters for this Context.
|
ApplicationFilterConfig |
findApplicationFilterConfig(java.lang.String name)
Return the application filter for the given name.
|
ApplicationFilterConfig[] |
findApplicationFilterConfigs()
Return the application filter for the given name.
|
java.lang.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(java.lang.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(java.lang.String name)
Find and return the initialized
FilterConfig for the
specified filter name, if any; otherwise return null. |
FilterDef |
findFilterDef(java.lang.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.
|
java.lang.String[] |
findInstanceListeners()
Return the set of InstanceListener classes that will be added to
newly created Wrappers automatically.
|
JspPropertyGroup[] |
findJspPropertyGroups()
Return the set of JSP property groups.
|
Context |
findMappingObject()
FIXME: Fooling introspection ...
|
java.lang.String |
findMimeMapping(java.lang.String extension)
Return the MIME type to which the specified extension is mapped,
if any; otherwise return
null. |
java.lang.String[] |
findMimeMappings()
Return the extensions for which MIME mappings are defined.
|
java.lang.String |
findParameter(java.lang.String name)
Return the value for the specified context initialization
parameter name, if any; otherwise return
null. |
java.lang.String[] |
findParameters()
Return the names of all defined context initialization parameters
for this Context.
|
java.lang.String |
findRoleMapping(java.lang.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(java.lang.String role)
Return
true if the specified security role is defined
for this application; otherwise return false. |
java.lang.String[] |
findSecurityRoles()
Return the security roles defined for this application.
|
java.lang.String |
findServletMapping(java.lang.String pattern)
Return the servlet name mapped by the specified pattern (if any);
otherwise return
null. |
java.lang.String[] |
findServletMappings()
Return the patterns of all defined servlet mappings for this
Context.
|
javax.naming.directory.DirContext |
findStaticResources()
Return the naming resources associated with this web application.
|
int[] |
findStatusPages()
Return the set of HTTP status codes for which error pages have
been specified.
|
java.lang.String |
findTaglib(java.lang.String uri)
Return the tag library descriptor location for the specified taglib
URI, if any; otherwise, return
null. |
java.lang.String[] |
findTaglibs()
Return the URIs of all tag libraries for which a tag library
descriptor location has been specified.
|
boolean |
findWelcomeFile(java.lang.String name)
Return
true if the specified welcome file is defined
for this Context; otherwise return false. |
java.lang.String[] |
findWelcomeFiles()
Return the set of welcome files defined for this Context.
|
java.lang.String[] |
findWrapperLifecycles()
Return the set of LifecycleListener classes that will be added to
newly created Wrappers automatically.
|
java.lang.String[] |
findWrapperListeners()
Return the set of ContainerListener classes that will be added to
newly created Wrappers automatically.
|
java.lang.String |
getAltDDName()
Return the alternate Deployment Descriptor name.
|
protected java.lang.String |
getAppBase()
Get app base.
|
java.lang.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.
|
java.lang.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.
|
java.lang.Object[] |
getApplicationSessionLifecycleListeners()
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()
Return the application authenticator for this Context.
|
boolean |
getAvailable()
Return the application available flag for this Context.
|
protected java.lang.String |
getBasePath()
Get base path.
|
int |
getCacheMaxSize()
Return the maximum size of the cache in KB.
|
int |
getCacheObjectMaxSize()
Return the maximum size of objects to be cached in KB.
|
int |
getCacheTTL()
Get cache TTL.
|
CharsetMapper |
getCharsetMapper()
Return the Locale to character set mapper for this Context.
|
java.lang.String |
getCharsetMapperClass()
Return the Locale to character set mapper class for this Context.
|
java.io.File |
getConfigBase()
Get config base.
|
java.lang.String |
getConfigClass()
Return the class name of the context configurator.
|
boolean |
getConfigured()
Return the "correctly configured" flag for this Context.
|
boolean |
getCookies()
Return the "use cookies for session ids" flag.
|
boolean |
getCrossContext()
Return the "allow crossing servlet contexts" flag.
|
protected java.lang.String |
getDefaultConfigFile()
Given a context path, get the config file name.
|
java.util.Set<SessionTrackingMode> |
getDefaultSessionTrackingModes() |
java.lang.String |
getDeploymentDescriptor()
JSR77 deploymentDescriptor attribute
|
java.lang.String |
getDisplayName()
Return the display name of this web application.
|
boolean |
getDistributable()
Return the distributable flag for this web application.
|
java.lang.String |
getDocBase()
Return the document root for this Context.
|
java.lang.String |
getEncodedPath()
Return the URL encoded context path, using UTF-8.
|
java.lang.String |
getEngineName() |
java.lang.String |
getHostname() |
boolean |
getIgnoreAnnotations()
Return the boolean on the annotations parsing.
|
java.lang.String |
getInfo()
Return descriptive information about this Container implementation and
the corresponding version number, in the format
<description>/<version>. |
InstanceManager |
getInstanceManager()
Used to create application instances.
|
java.lang.String |
getJ2EEApplication() |
java.lang.String |
getJ2EEServer() |
java.lang.String[] |
getJavaVMs() |
java.lang.String |
getLogicalName()
Return the logical name for this web application.
|
LoginConfig |
getLoginConfig()
Return the login configuration descriptor for this web application.
|
Mapper |
getMapper()
Get the mapper associated with the context.
|
javax.management.MBeanNotificationInfo[] |
getNotificationInfo() |
boolean |
getOverride()
Return the DefaultContext override flag for this web application.
|
java.lang.ClassLoader |
getParentClassLoader()
Return the parent class loader (if any) for this web application.
|
javax.management.ObjectName |
getParentName() |
java.lang.String |
getPath()
Return the context path for this Context.
|
boolean |
getPaused()
Return the request processing paused flag for this Context.
|
boolean |
getPrivileged()
Return the privileged flag for this web application.
|
long |
getProcessingTime()
Gets the cumulative processing times of all servlets in this
StandardContext.
|
java.lang.String |
getPublicId()
Return the public identifier of the deployment descriptor DTD that is
currently being parsed.
|
java.lang.String |
getServer() |
ServletContext |
getServletContext()
Return the servlet context for which this Context is a facade.
|
java.lang.String[] |
getServlets()
JSR77 servlets attribute
|
SessionCookie |
getSessionCookie()
Return the session cookie configuration.
|
int |
getSessionTimeout()
Return the default session timeout (in minutes) for this
web application.
|
java.util.Set<SessionTrackingMode> |
getSessionTrackingModes() |
long |
getStartTime()
Gets the time this context was started.
|
long |
getStartupTime()
Gets the time (in milliseconds) it took to start this context.
|
int |
getState() |
javax.naming.directory.DirContext |
getStaticResources()
Return the naming resources associated with this web application.
|
ThreadBindingListener |
getThreadBindingListener()
Get the associated ThreadBindingListener.
|
long |
getTldScanTime() |
long |
getUnloadDelay()
Return the value of the unloadDelay flag.
|
java.lang.String |
getVersion()
Return the Servlet API version defined for the webapp.
|
int |
getVersionMajor()
Return the Servlet API version defined for the webapp.
|
int |
getVersionMinor()
Return the Servlet API version defined for the webapp.
|
java.lang.String[] |
getWelcomeFiles()
Return the naming resources associated with this web application.
|
java.lang.String |
getWorkDir()
Return the work directory for this Context.
|
java.lang.String |
getWorkPath()
Get the absolute path to the work dir.
|
java.lang.String |
getWrapperClass()
Return the Java class name of the Wrapper implementation used
for servlets registered in this Context.
|
void |
init()
Init method, part of the MBean lifecycle.
|
boolean |
isAllowLinking()
Is linking allowed.
|
boolean |
isCachingAllowed()
Is caching allowed ?
|
boolean |
isCaseSensitive()
Is case sensitive ?
|
boolean |
isEventProvider() |
boolean |
isFilesystemBased()
Returns true if the resources associated with this context are
filesystem based.
|
boolean |
isInitialized()
Return true if the Context has been initialized.
|
boolean |
isReplaceWelcomeFiles()
Return the "replace welcome files" property.
|
protected boolean |
isRestricted(java.lang.Object listener)
Is the specified listener restricted ?
|
protected boolean |
isServlet22()
Are we processing a version 2.2 deployment descriptor?
|
boolean |
isStarting()
Return the application starting flag for this Context.
|
boolean |
isStateManageable()
Support for "stateManageable" JSR77
|
boolean |
isStatisticsProvider() |
boolean |
listenerStart()
Configure the set of instantiated application event listeners
for this Context.
|
boolean |
listenerStop()
Send an application stop event to all interested listeners.
|
void |
loadOnStartup(Container[] children)
Load and initialize all servlets marked "load on startup" in the
web application deployment descriptor.
|
protected void |
postContextAttributes()
Create mandatory servlet context attributes.
|
protected void |
postWorkDirectory()
Set the appropriate context attribute for our work directory.
|
void |
preDeregister() |
javax.management.ObjectName |
preRegister(javax.management.MBeanServer server,
javax.management.ObjectName name)
There are 2 cases:
1.The context is created and registered by internal APIS
2.
|
protected void |
preRegisterJMX() |
protected void |
registerJMX() |
void |
reload()
Reload this web application, if reloading is supported.
|
void |
removeApplicationListener(java.lang.String listener)
Remove the specified application listener class from the set of
listeners for this application.
|
void |
removeApplicationParameter(java.lang.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(java.lang.String listener)
Remove a class name from the set of InstanceListener classes that
will be added to newly created Wrappers.
|
void |
removeMimeMapping(java.lang.String extension)
Remove the MIME mapping for the specified extension, if it exists;
otherwise, no action is taken.
|
void |
removeNotificationListener(javax.management.NotificationListener listener)
Remove a JMX-NotificationListener
|
void |
removeNotificationListener(javax.management.NotificationListener listener,
javax.management.NotificationFilter filter,
java.lang.Object object) |
void |
removeParameter(java.lang.String name)
Remove the context initialization parameter with the specified
name, if it exists; otherwise, no action is taken.
|
void |
removeRoleMapping(java.lang.String role)
Remove any security role reference for the specified name
|
void |
removeSecurityRole(java.lang.String role)
Remove any security role with the specified name.
|
void |
removeServletMapping(java.lang.String pattern)
Remove any servlet mapping for the specified pattern, if it exists;
otherwise, no action is taken.
|
void |
removeTaglib(java.lang.String uri)
Remove the tag library location forthe specified tag library URI.
|
void |
removeWelcomeFile(java.lang.String name)
Remove the specified welcome file name from the list recognized
by this Context.
|
void |
removeWrapperLifecycle(java.lang.String listener)
Remove a class name from the set of LifecycleListener classes that
will be added to newly created Wrappers.
|
void |
removeWrapperListener(java.lang.String listener)
Remove a class name from the set of ContainerListener classes that
will be added to newly created Wrappers.
|
protected void |
resetContext() |
boolean |
resourcesStart()
Allocate resources, including proxy.
|
boolean |
resourcesStop()
Deallocate resources and destroy proxy.
|
void |
setAllowLinking(boolean allowLinking)
Set allow linking.
|
void |
setAltDDName(java.lang.String altDDName)
Set an alternate Deployment Descriptor name.
|
void |
setApplicationEventListeners(java.lang.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(java.lang.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 |
setApplicationSessionLifecycleListeners(java.lang.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 |
setAuthenticator(Authenticator authenticator)
Set the application authenticator for this Context.
|
void |
setAvailable(boolean available)
Set the application available flag for this Context.
|
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 |
setCaseSensitive(boolean caseSensitive)
Set case sensitivity.
|
void |
setCharsetMapper(CharsetMapper mapper)
Set the Locale to character set mapper for this Context.
|
void |
setCharsetMapperClass(java.lang.String mapper)
Set the Locale to character set mapper class for this Context.
|
void |
setConfigClass(java.lang.String configClass)
Set the class name of the context configurator.
|
void |
setConfigured(boolean configured)
Set the "correctly configured" flag for this Context.
|
void |
setCookies(boolean cookies)
Set the "use cookies for session ids" flag.
|
void |
setCrossContext(boolean crossContext)
Set the "allow crossing servlet contexts" flag.
|
void |
setDisplayName(java.lang.String displayName)
Set the display name of this web application.
|
void |
setDistributable(boolean distributable)
Set the distributable flag for this web application.
|
void |
setDocBase(java.lang.String docBase)
Set the document root for this Context.
|
void |
setEngineName(java.lang.String engineName) |
void |
setFilesystemBased(boolean filesystemBased)
Force setting if filesystem based.
|
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(java.lang.String j2EEApplication) |
void |
setJ2EEServer(java.lang.String j2EEServer) |
java.lang.String[] |
setJavaVMs(java.lang.String[] javaVMs) |
void |
setLoader(Loader loader)
Set the Loader with which this Context is associated.
|
void |
setLogicalName(java.lang.String logicalName)
Set the logical name for this web application.
|
void |
setLoginConfig(LoginConfig config)
Set the login configuration descriptor for this web application.
|
void |
setName(java.lang.String name)
Set a name string (suitable for use by humans) that describes this
Container.
|
void |
setOverride(boolean override)
Set the override flag for this web application.
|
void |
setPath(java.lang.String path)
Set the context path for this Context.
|
protected void |
setPaused(boolean paused)
Set the request processing paused flag for this Context.
|
void |
setPrivileged(boolean privileged)
Set the privileged flag for this web application.
|
void |
setPublicId(java.lang.String publicId)
Set the public identifier of the deployment descriptor DTD that is
currently being parsed.
|
void |
setReplaceWelcomeFiles(boolean replaceWelcomeFiles)
Set the "replace welcome files" property.
|
void |
setResources(javax.naming.directory.DirContext resources)
Set the resources DirContext object with which this Container is
associated.
|
java.lang.String |
setServer(java.lang.String server) |
void |
setSessionCookie(SessionCookie sessionCookie)
Set the session cookie configuration.
|
void |
setSessionTimeout(int timeout)
Set the default session timeout (in minutes) for this
web application.
|
void |
setSessionTrackingModes(java.util.Set<SessionTrackingMode> sessionTrackingModes) |
void |
setStarting(boolean starting)
Set the application starting flag for this Context.
|
void |
setStartupTime(long startupTime) |
void |
setThreadBindingListener(ThreadBindingListener threadBindingListener)
Get the associated ThreadBindingListener.
|
void |
setTldScanTime(long tldScanTime) |
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 |
setVersion(java.lang.String version)
Set the Servlet API version defined for the webapp.
|
void |
setWorkDir(java.lang.String workDir)
Set the work directory for this Context.
|
void |
setWrapperClass(java.lang.String wrapperClassName)
Set the Java class name of the Wrapper implementation used
for servlets registered in this Context.
|
void |
start()
Start this Context component.
|
void |
startRecursive() |
void |
stop()
Stop this Context component.
|
java.lang.String |
toString()
Return a String representation of this component.
|
protected void |
unbindThread(java.lang.ClassLoader oldContextClassLoader)
Unbind thread.
|
protected void |
validateFilterMap(FilterMap filterMap)
Validate the supplied FilterMap.
|
protected boolean |
validateURLPattern(java.lang.String urlPattern)
Validate the syntax of a proposed
<url-pattern>
for conformance with specification requirements. |
protected java.io.File |
workBase() |
addContainerListener, addLifecycleListener, addPropertyChangeListener, addValve, backgroundProcess, findChild, findChildren, findContainerListeners, findLifecycleListeners, fireContainerEvent, getBackgroundProcessorDelay, getBasic, getChildren, getCluster, getContainerSuffix, getDomain, getFirst, getJmxName, getJSR77Suffix, getLoader, getLogger, getManager, getMappingObject, getName, getObjectName, getParent, getPipeline, getRealm, getResources, getStartChildren, getType, getValveObjectNames, getValves, invoke, isStarted, logName, postDeregister, postRegister, removeContainerListener, removeLifecycleListener, removePropertyChangeListener, removeValve, setBackgroundProcessorDelay, setBasic, setCluster, setDomain, setManager, setParent, setParentClassLoader, setRealm, setStartChildren, threadStart, threadStopclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitaddContainerListener, addPropertyChangeListener, backgroundProcess, findChild, findChildren, findContainerListeners, fireContainerEvent, getBackgroundProcessorDelay, getCluster, getLoader, getLogger, getManager, getMappingObject, getName, getObjectName, getParent, getPipeline, getRealm, getResources, invoke, isStarted, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setManager, setParent, setParentClassLoader, setRealmprotected static Logger log
protected static final java.lang.String info
protected static URLEncoder urlEncoder
protected java.lang.String altDDName
protected InstanceManager instanceManager
protected java.lang.String hostName
protected java.lang.String[] applicationListeners
protected java.util.HashSet<java.lang.String> restrictedApplicationListeners
protected java.util.EventListener[] applicationListenerInstances
protected java.lang.Object[] applicationEventListenersInstances
protected java.lang.Object[] applicationLifecycleListenersInstances
protected java.lang.Object[] applicationSessionLifecycleListenersInstances
protected java.lang.Object[] listenersInstances
protected ApplicationParameter[] applicationParameters
protected Authenticator authenticator
protected boolean available
protected boolean starting
protected javax.management.NotificationBroadcasterSupport broadcaster
protected CharsetMapper charsetMapper
protected java.lang.String charsetMapperClass
protected boolean configured
protected SecurityConstraint[] constraints
protected ApplicationContext context
protected java.lang.String configClass
protected java.util.Set<SessionTrackingMode> defaultSessionTrackingModes
protected java.util.Set<SessionTrackingMode> sessionTrackingModes
protected boolean crossContext
ServletContext.getContext() method
to access the context of other web applications in this server?protected java.lang.String encodedPath
protected java.lang.String displayName
protected boolean distributable
protected java.lang.String docBase
protected java.util.HashMap<java.lang.String,ErrorPage> exceptionPages
protected java.util.HashMap<java.lang.String,ApplicationFilterConfig> filterConfigs
protected java.util.HashMap<java.lang.String,FilterDef> filterDefs
protected FilterMap[] filterMaps
ServletContext possibly both before and after those
defined in the deployment descriptor.protected int filterMapInsertPoint
ServletContext may have to be inserted
before the mappings in the deploymenmt descriptor but must be inserted in
the order the ServletContext methods are called. This isn't an
issue for the mappings added after the deployment descriptor - they are
just added to the end - but correctly the adding mappings before the
deployment descriptor mappings requires knowing where the last 'before'
mapping was added.protected boolean ignoreAnnotations
protected java.lang.String[] instanceListeners
createWrapper().protected java.util.LinkedHashMap<java.lang.String,JspPropertyGroup> jspPropertyGroups
protected java.util.HashMap<java.lang.String,TagLibraryInfo> jspTagLibraries
protected java.lang.String logicalName
protected LoginConfig loginConfig
protected Mapper mapper
protected java.util.HashMap<java.lang.String,java.lang.String> mimeMappings
protected ErrorPage okErrorPage
protected java.util.HashMap<java.lang.String,java.lang.String> parameters
protected boolean paused
protected java.lang.String publicId
protected java.lang.String version
protected int versionMinor
protected int versionMajor
protected boolean override
protected boolean privileged
protected boolean replaceWelcomeFiles
addWelcomeFile() cause replacement
of any existing welcome files? This will be set before processing the
web application's deployment descriptor, so that application specified
choices replace, rather than append to, those defined
in the global descriptor.protected java.util.HashMap<java.lang.String,java.lang.String> roleMappings
protected java.lang.String[] securityRoles
protected java.util.HashMap<java.lang.String,java.lang.String> servletMappings
protected int sessionTimeout
protected long sequenceNumber
protected SessionCookie sessionCookie
protected java.util.HashMap<java.lang.Integer,ErrorPage> statusPages
protected java.util.HashMap<java.lang.String,java.lang.String> taglibs
protected long unloadDelay
protected java.lang.String[] welcomeFiles
protected java.lang.String[] wrapperLifecycles
createWrapper().protected java.lang.String[] wrapperListeners
createWrapper().protected java.lang.String workDir
protected java.lang.String wrapperClassName
protected java.lang.Class<?> wrapperClass
protected boolean filesystemBased
protected boolean cachingAllowed
protected boolean caseSensitive
protected boolean allowLinking
protected int cacheMaxSize
protected int cacheObjectMaxSize
protected int cacheTTL
protected javax.naming.directory.DirContext webappResources
protected long startupTime
protected long startTime
protected long tldScanTime
protected java.lang.String engineName
protected java.lang.String j2EEApplication
protected java.lang.String j2EEServer
protected static final ThreadBindingListener DEFAULT_NAMING_LISTENER
protected ThreadBindingListener threadBindingListener
protected javax.management.MBeanNotificationInfo[] notificationInfo
protected java.lang.String server
protected java.lang.String[] javaVMs
public StandardContext()
public InstanceManager getInstanceManager()
ContextgetInstanceManager in interface Contextpublic void setInstanceManager(InstanceManager instanceManager)
ContextsetInstanceManager in interface ContextinstanceManager - The instance managerpublic java.lang.String getEncodedPath()
ContextgetEncodedPath in interface Contextpublic void setName(java.lang.String name)
ContainerBasesetName in interface ContainersetName in class ContainerBasename - New name of this containerpublic boolean isCachingAllowed()
public void setCachingAllowed(boolean cachingAllowed)
public void setCaseSensitive(boolean caseSensitive)
public boolean isCaseSensitive()
public void setAllowLinking(boolean allowLinking)
public boolean isAllowLinking()
public void setCacheTTL(int cacheTTL)
public int getCacheTTL()
public int getCacheMaxSize()
public void setCacheMaxSize(int cacheMaxSize)
public int getCacheObjectMaxSize()
public void setCacheObjectMaxSize(int cacheObjectMaxSize)
public boolean isFilesystemBased()
public void setFilesystemBased(boolean filesystemBased)
public java.lang.Object[] getApplicationEventListeners()
getApplicationEventListeners in interface Contextjava.lang.IllegalStateException - if this method is called before
this application has started, or after it has been stoppedpublic void setApplicationEventListeners(java.lang.Object[] listeners)
setApplicationEventListeners in interface Contextlisteners - The set of instantiated listener objects.public java.lang.Object[] getApplicationSessionLifecycleListeners()
getApplicationSessionLifecycleListeners in interface Contextjava.lang.IllegalStateException - if this method is called before
this application has started, or after it has been stoppedpublic void setApplicationSessionLifecycleListeners(java.lang.Object[] listeners)
setApplicationSessionLifecycleListeners in interface Contextlisteners - The set of instantiated listener objects.public java.lang.Object[] getApplicationLifecycleListeners()
getApplicationLifecycleListeners in interface Contextjava.lang.IllegalStateException - if this method is called before
this application has started, or after it has been stoppedpublic void setApplicationLifecycleListeners(java.lang.Object[] listeners)
setApplicationLifecycleListeners in interface Contextlisteners - The set of instantiated listener objects.public Authenticator getAuthenticator()
getAuthenticator in interface Contextpublic void setAuthenticator(Authenticator authenticator)
setAuthenticator in interface Contextauthenticator - The new application authenticatorpublic boolean getAvailable()
getAvailable in interface Contextpublic void setAvailable(boolean available)
setAvailable in interface Contextavailable - The new application available flagpublic boolean isStarting()
isStarting in interface Contextpublic void setStarting(boolean starting)
setStarting in interface Contextstarting - The new application starting flagpublic CharsetMapper getCharsetMapper()
getCharsetMapper in interface Contextpublic void setCharsetMapper(CharsetMapper mapper)
setCharsetMapper in interface Contextmapper - The new mapperpublic java.lang.String getConfigClass()
public void setConfigClass(java.lang.String configClass)
configClass - The class name of the listener.public boolean getConfigured()
getConfigured in interface Contextpublic void setConfigured(boolean configured)
setConfigured in interface Contextconfigured - The new correctly configured flagpublic boolean getCookies()
getCookies in interface Contextpublic void setCookies(boolean cookies)
setCookies in interface Contextcookies - The new flagpublic boolean getCrossContext()
getCrossContext in interface Contextpublic void setCrossContext(boolean crossContext)
setCrossContext in interface ContextcrossContext - The new cross contexts flagpublic long getStartupTime()
public void setStartupTime(long startupTime)
public long getTldScanTime()
public void setTldScanTime(long tldScanTime)
public java.lang.String getDisplayName()
getDisplayName in interface Contextpublic java.lang.String getAltDDName()
getAltDDName in interface Contextpublic void setAltDDName(java.lang.String altDDName)
setAltDDName in interface Contextpublic void setDisplayName(java.lang.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 java.lang.String getDocBase()
getDocBase in interface Contextpublic void setDocBase(java.lang.String docBase)
setDocBase in interface ContextdocBase - The new document rootpublic java.lang.String getInfo()
<description>/<version>.getInfo in interface ContainergetInfo in class ContainerBasepublic java.lang.String getEngineName()
public void setEngineName(java.lang.String engineName)
public java.lang.String getJ2EEApplication()
public void setJ2EEApplication(java.lang.String j2EEApplication)
public java.lang.String getJ2EEServer()
public void setJ2EEServer(java.lang.String j2EEServer)
public void setLoader(Loader loader)
setLoader in interface ContainersetLoader in class ContainerBaseloader - The newly associated loaderpublic boolean getIgnoreAnnotations()
getIgnoreAnnotations in interface Contextpublic void setIgnoreAnnotations(boolean ignoreAnnotations)
setIgnoreAnnotations in interface ContextignoreAnnotations - The boolean on the annotations parsingpublic void setSessionCookie(SessionCookie sessionCookie)
setSessionCookie in interface ContextsessionCookie - The new valuepublic SessionCookie getSessionCookie()
getSessionCookie in interface Contextpublic java.lang.String getLogicalName()
getLogicalName in interface Contextpublic void setLogicalName(java.lang.String logicalName)
setLogicalName in interface ContextlogicalName - The new logical namepublic LoginConfig getLoginConfig()
getLoginConfig in interface Contextpublic void setLoginConfig(LoginConfig config)
setLoginConfig in interface Contextconfig - The new login configurationpublic Mapper getMapper()
public java.lang.String getPath()
public void setPath(java.lang.String path)
IMPLEMENTATION NOTE: The context path is used as the "name" of a Context, because it must be unique.
public java.lang.String getPublicId()
getPublicId in interface Contextpublic void setPublicId(java.lang.String publicId)
setPublicId in interface ContextpublicId - The public identifierpublic java.lang.String getVersion()
getVersion in interface Contextpublic int getVersionMajor()
getVersionMajor in interface Contextpublic int getVersionMinor()
getVersionMinor in interface Contextpublic void setVersion(java.lang.String version)
setVersion in interface Contextversion - The versionpublic boolean getOverride()
getOverride in interface Contextpublic java.lang.ClassLoader getParentClassLoader()
getParentClassLoader in interface ContainergetParentClassLoader in class ContainerBasepublic boolean getPrivileged()
getPrivileged in interface Contextpublic void setPrivileged(boolean privileged)
setPrivileged in interface Contextprivileged - The new privileged flagpublic void setOverride(boolean override)
setOverride in interface Contextoverride - The new override flagpublic java.util.Set<SessionTrackingMode> getDefaultSessionTrackingModes()
public java.util.Set<SessionTrackingMode> getSessionTrackingModes()
public void setSessionTrackingModes(java.util.Set<SessionTrackingMode> sessionTrackingModes)
public void addSessionTrackingMode(java.lang.String trackingMode)
ContextaddSessionTrackingMode in interface Contextpublic boolean isReplaceWelcomeFiles()
public 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 long getUnloadDelay()
public void setUnloadDelay(long unloadDelay)
unloadDelay - The new valuepublic java.lang.String getWrapperClass()
getWrapperClass in interface Contextpublic void setWrapperClass(java.lang.String wrapperClassName)
setWrapperClass in interface ContextwrapperClassName - The new wrapper class namejava.lang.IllegalArgumentException - if the specified wrapper class
cannot be found or is not a subclass of StandardWrapperpublic void setResources(javax.naming.directory.DirContext resources)
setResources in interface ContainersetResources in class ContainerBaseresources - The newly associated DirContextpublic ThreadBindingListener getThreadBindingListener()
getThreadBindingListener in interface Contextpublic void setThreadBindingListener(ThreadBindingListener threadBindingListener)
setThreadBindingListener in interface Contextpublic java.lang.String getCharsetMapperClass()
public void setCharsetMapperClass(java.lang.String mapper)
mapper - The new mapper classpublic java.lang.String getWorkPath()
public java.lang.String getWorkDir()
public void setWorkDir(java.lang.String workDir)
workDir - The new work directorypublic void addApplicationListener(java.lang.String listener)
addApplicationListener in interface Contextlistener - Java class name of a listener classprotected void addApplicationListener(java.lang.String listener,
boolean restricted)
listener - Java class name of a listener classpublic <T extends java.util.EventListener> void addApplicationListenerInstance(T listener)
addApplicationListenerInstance in interface Contextlistener - Java instance of a listenerpublic 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 addedjava.lang.IllegalArgumentException - 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 addApplicationFilterConfig(ApplicationFilterConfig filterConfig)
filterDef - The filter 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 addedjava.lang.IllegalArgumentException - 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 addedjava.lang.IllegalArgumentException - if the specified filter name
does not match an existing filter definition, or the filter mapping
is malformedprotected void validateFilterMap(FilterMap filterMap)
public void addInstanceListener(java.lang.String listener)
addInstanceListener in interface Contextlistener - Java class name of an InstanceListener classpublic void addJspMapping(java.lang.String pattern)
addJspMapping in interface Contextpattern - URL pattern to be mappedpublic void addJspPropertyGroup(JspPropertyGroup propertyGroup)
addJspPropertyGroup in interface Contextpattern - URL pattern to be mappedpublic void addJspTagLibrary(TagLibraryInfo tagLibraryInfo)
addJspTagLibrary in interface ContexttagLibrayInfo - the tag library info that will be addedpublic void addJspTagLibrary(java.lang.String uri,
TagLibraryInfo tagLibraryInfo)
addJspTagLibrary in interface Contexturi - the tag library URItagLibrayInfo - the tag library info that will be addedpublic void addLocaleEncodingMappingParameter(java.lang.String locale,
java.lang.String encoding)
addLocaleEncodingMappingParameter in interface Contextlocale - locale to map an encoding forencoding - encoding to be used for a give localepublic void addMimeMapping(java.lang.String extension,
java.lang.String mimeType)
addMimeMapping in interface Contextextension - Filename extension being mappedmimeType - Corresponding MIME typepublic void addParameter(java.lang.String name,
java.lang.String value)
addParameter in interface Contextname - Name of the new parametervalue - Value of the new parameterjava.lang.IllegalArgumentException - if the name or value is missing,
or if this context initialization parameter has already been
registeredpublic void addRoleMapping(java.lang.String role,
java.lang.String link)
addRoleMapping in interface Contextrole - Security role used in the applicationlink - Actual security role to check forpublic void addSecurityRole(java.lang.String role)
addSecurityRole in interface Contextrole - New security rolepublic void addServletMapping(java.lang.String pattern,
java.lang.String name)
addServletMapping in interface Contextpattern - URL pattern to be mappedname - Name of the corresponding servlet to executejava.lang.IllegalArgumentException - if the specified servlet name
is not known to this Contextpublic void addServletMapping(java.lang.String pattern,
java.lang.String name,
boolean jspWildCard)
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 otherwisejava.lang.IllegalArgumentException - if the specified servlet name
is not known to this Contextpublic void addTaglib(java.lang.String uri,
java.lang.String location)
public void addWelcomeFile(java.lang.String name)
addWelcomeFile in interface Contextname - New welcome file namepublic void addWrapperLifecycle(java.lang.String listener)
addWrapperLifecycle in interface Contextlistener - Java class name of a LifecycleListener classpublic void addWrapperListener(java.lang.String listener)
addWrapperListener in interface Contextlistener - Java class name of a ContainerListener classpublic Wrapper createWrapper()
createWrapper in interface Contextpublic ApplicationFilterConfig findApplicationFilterConfig(java.lang.String name)
public ApplicationFilterConfig[] findApplicationFilterConfigs()
public java.lang.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(java.lang.String exceptionType)
null.findErrorPage in interface ContextexceptionType - Exception type to look uppublic ErrorPage[] findErrorPages()
findErrorPages in interface Contextpublic FilterDef findFilterDef(java.lang.String filterName)
null.findFilterDef in interface ContextfilterName - Filter name to look uppublic FilterDef[] findFilterDefs()
findFilterDefs in interface Contextpublic FilterMap[] findFilterMaps()
findFilterMaps in interface Contextpublic java.lang.String[] findInstanceListeners()
findInstanceListeners in interface Contextpublic JspPropertyGroup[] findJspPropertyGroups()
findJspPropertyGroups in interface Contextpublic Context findMappingObject()
public java.lang.String findMimeMapping(java.lang.String extension)
null.findMimeMapping in interface Contextextension - Extension to map to a MIME typepublic java.lang.String[] findMimeMappings()
findMimeMappings in interface Contextpublic java.lang.String findParameter(java.lang.String name)
null.findParameter in interface Contextname - Name of the parameter to returnpublic java.lang.String[] findParameters()
findParameters in interface Contextpublic java.lang.String findRoleMapping(java.lang.String role)
findRoleMapping in interface Contextrole - Security role to mappublic boolean findSecurityRole(java.lang.String role)
true if the specified security role is defined
for this application; otherwise return false.findSecurityRole in interface Contextrole - Security role to verifypublic java.lang.String[] findSecurityRoles()
findSecurityRoles in interface Contextpublic java.lang.String findServletMapping(java.lang.String pattern)
null.findServletMapping in interface Contextpattern - Pattern for which a mapping is requestedpublic java.lang.String[] findServletMappings()
findServletMappings in interface Contextpublic int[] findStatusPages()
findStatusPages in interface Contextpublic java.lang.String findTaglib(java.lang.String uri)
null.findTaglib in interface Contexturi - URI, relative to the web.xml filepublic java.lang.String[] findTaglibs()
findTaglibs in interface Contextpublic boolean findWelcomeFile(java.lang.String name)
true if the specified welcome file is defined
for this Context; otherwise return false.findWelcomeFile in interface Contextname - Welcome file to verifypublic java.lang.String[] findWelcomeFiles()
findWelcomeFiles in interface Contextpublic java.lang.String[] findWrapperLifecycles()
findWrapperLifecycles in interface Contextpublic java.lang.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. It does not handle changes to the web application deployment descriptor. If that has occurred, you should stop this Context and create (and start) a new Context instance instead.
public void removeApplicationListener(java.lang.String listener)
removeApplicationListener in interface Contextlistener - Java class name of the listener to be removedpublic void removeApplicationParameter(java.lang.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 addedjava.lang.IllegalArgumentException - 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(java.lang.String listener)
removeInstanceListener in interface Contextlistener - Class name of an InstanceListener class to be removedpublic void removeMimeMapping(java.lang.String extension)
removeMimeMapping in interface Contextextension - Extension to remove the mapping forpublic void removeParameter(java.lang.String name)
removeParameter in interface Contextname - Name of the parameter to removepublic void removeRoleMapping(java.lang.String role)
removeRoleMapping in interface Contextrole - Security role (as used in the application) to removepublic void removeSecurityRole(java.lang.String role)
removeSecurityRole in interface Contextrole - Security role to removepublic void removeServletMapping(java.lang.String pattern)
removeServletMapping in interface Contextpattern - URL pattern of the mapping to removepublic void removeTaglib(java.lang.String uri)
removeTaglib in interface Contexturi - URI, relative to the web.xml filepublic void removeWelcomeFile(java.lang.String name)
removeWelcomeFile in interface Contextname - Name of the welcome file to be removedpublic void removeWrapperLifecycle(java.lang.String listener)
removeWrapperLifecycle in interface Contextlistener - Class name of a LifecycleListener class to be removedpublic void removeWrapperListener(java.lang.String listener)
removeWrapperListener in interface Contextlistener - Class name of a ContainerListener class to be removedpublic long getProcessingTime()
protected boolean filterStart()
true if all filter initialization completed
successfully, or false otherwise.protected boolean filterStop()
true if all filter finalization completed
successfully, or false otherwise.public FilterConfig findFilterConfig(java.lang.String name)
FilterConfig for the
specified filter name, if any; otherwise return null.name - Name of the desired filterpublic boolean contextListenerStart()
true if all listeners wre
initialized successfully, or false otherwise.
Only context listeners are actually set in stone at this point,
all others are stored in a temporary location.public 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()
public void loadOnStartup(Container[] children)
children - Array of wrappers for all currently defined
servlets (including those not declared load on startup)public void start()
throws LifecycleException
start in interface Lifecyclestart in class ContainerBaseLifecycleException - if a startup error occurspublic void stop()
throws LifecycleException
stop in interface Lifecyclestop in class ContainerBaseLifecycleException - if a shutdown error occurspublic void destroy()
throws java.lang.Exception
destroy in class ContainerBasejava.lang.Exceptionprotected void resetContext()
throws java.lang.Exception,
javax.management.MBeanRegistrationException
java.lang.Exceptionjavax.management.MBeanRegistrationExceptionpublic java.lang.String toString()
toString in class java.lang.Objectprotected java.lang.String adjustURLPattern(java.lang.String urlPattern)
urlPattern - The URL pattern to be adjusted (if needed)
and returnedprotected boolean isRestricted(java.lang.Object listener)
protected boolean isServlet22()
protected java.io.File engineBase()
protected java.io.File workBase()
protected java.lang.ClassLoader bindThread()
protected void unbindThread(java.lang.ClassLoader oldContextClassLoader)
protected java.lang.String getBasePath()
protected java.lang.String getAppBase()
public java.io.File getConfigBase()
protected java.lang.String getDefaultConfigFile()
protected boolean copy(java.io.File src,
java.io.File dest)
public boolean getPaused()
protected void postContextAttributes()
public java.lang.String getHostname()
protected void postWorkDirectory()
protected void setPaused(boolean paused)
paused - The new request processing paused flagprotected boolean validateURLPattern(java.lang.String urlPattern)
<url-pattern>
for conformance with specification requirements.urlPattern - URL pattern to be validatedprotected void checkUnusualURLPattern(java.lang.String urlPattern)
<url-pattern>s.
See Bugzilla 34805, 43079 & 43080public java.lang.String getDeploymentDescriptor()
public java.lang.String[] getServlets()
public javax.management.ObjectName createObjectName(java.lang.String hostDomain,
javax.management.ObjectName parentName)
throws javax.management.MalformedObjectNameException
createObjectName in class ContainerBasejavax.management.MalformedObjectNameExceptionprotected void preRegisterJMX()
protected void registerJMX()
public javax.management.ObjectName preRegister(javax.management.MBeanServer server,
javax.management.ObjectName name)
throws java.lang.Exception
preRegister in interface javax.management.MBeanRegistrationpreRegister in class ContainerBaseserver - The servername - The object namejava.lang.Exception - If an error occurspublic void preDeregister()
throws java.lang.Exception
preDeregister in interface javax.management.MBeanRegistrationpreDeregister in class ContainerBasejava.lang.Exceptionpublic void init()
throws java.lang.Exception
ContainerBaseinit in class ContainerBasejava.lang.Exceptionpublic boolean isInitialized()
ContextisInitialized in interface Contextpublic javax.management.ObjectName getParentName()
throws javax.management.MalformedObjectNameException
getParentName in class ContainerBasejavax.management.MalformedObjectNameExceptionpublic void create()
throws java.lang.Exception
java.lang.Exceptionpublic void removeNotificationListener(javax.management.NotificationListener listener,
javax.management.NotificationFilter filter,
java.lang.Object object)
throws javax.management.ListenerNotFoundException
removeNotificationListener in interface javax.management.NotificationEmitterjavax.management.ListenerNotFoundExceptionpublic javax.management.MBeanNotificationInfo[] getNotificationInfo()
getNotificationInfo in interface javax.management.NotificationBroadcasterpublic void addNotificationListener(javax.management.NotificationListener listener,
javax.management.NotificationFilter filter,
java.lang.Object object)
throws java.lang.IllegalArgumentException
addNotificationListener in interface javax.management.NotificationBroadcasterjava.lang.IllegalArgumentExceptionpublic void removeNotificationListener(javax.management.NotificationListener listener)
throws javax.management.ListenerNotFoundException
removeNotificationListener in interface javax.management.NotificationBroadcasterjavax.management.ListenerNotFoundExceptionNotificationBroadcaster.removeNotificationListener(javax.management.NotificationListener)public javax.naming.directory.DirContext getStaticResources()
public javax.naming.directory.DirContext findStaticResources()
public java.lang.String[] getWelcomeFiles()
public boolean isStateManageable()
public void startRecursive()
throws LifecycleException
LifecycleExceptionpublic int getState()
public java.lang.String getServer()
public java.lang.String setServer(java.lang.String server)
public java.lang.String[] getJavaVMs()
public java.lang.String[] setJavaVMs(java.lang.String[] javaVMs)
public long getStartTime()
public boolean isEventProvider()
public boolean isStatisticsProvider()