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, type
BIND_THREAD_EVENT, COMPLETE_CONFIG_EVENT, RELOAD_EVENT, UNBIND_THREAD_EVENT
ADD_CHILD_EVENT, ADD_MAPPER_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_MAPPER_EVENT, REMOVE_VALVE_EVENT
AFTER_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, threadStop
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addContainerListener, 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, setRealm
protected 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()
Context
getInstanceManager
in interface Context
public void setInstanceManager(InstanceManager instanceManager)
Context
setInstanceManager
in interface Context
instanceManager
- The instance managerpublic java.lang.String getEncodedPath()
Context
getEncodedPath
in interface Context
public void setName(java.lang.String name)
ContainerBase
setName
in interface Container
setName
in class ContainerBase
name
- 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 Context
java.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 Context
listeners
- The set of instantiated listener objects.public java.lang.Object[] getApplicationSessionLifecycleListeners()
getApplicationSessionLifecycleListeners
in interface Context
java.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 Context
listeners
- The set of instantiated listener objects.public java.lang.Object[] getApplicationLifecycleListeners()
getApplicationLifecycleListeners
in interface Context
java.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 Context
listeners
- The set of instantiated listener objects.public Authenticator getAuthenticator()
getAuthenticator
in interface Context
public void setAuthenticator(Authenticator authenticator)
setAuthenticator
in interface Context
authenticator
- The new application authenticatorpublic boolean getAvailable()
getAvailable
in interface Context
public void setAvailable(boolean available)
setAvailable
in interface Context
available
- The new application available flagpublic boolean isStarting()
isStarting
in interface Context
public void setStarting(boolean starting)
setStarting
in interface Context
starting
- The new application starting flagpublic CharsetMapper getCharsetMapper()
getCharsetMapper
in interface Context
public void setCharsetMapper(CharsetMapper mapper)
setCharsetMapper
in interface Context
mapper
- 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 Context
public void setConfigured(boolean configured)
setConfigured
in interface Context
configured
- The new correctly configured flagpublic boolean getCookies()
getCookies
in interface Context
public void setCookies(boolean cookies)
setCookies
in interface Context
cookies
- The new flagpublic boolean getCrossContext()
getCrossContext
in interface Context
public void setCrossContext(boolean crossContext)
setCrossContext
in interface Context
crossContext
- 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 Context
public java.lang.String getAltDDName()
getAltDDName
in interface Context
public void setAltDDName(java.lang.String altDDName)
setAltDDName
in interface Context
public void setDisplayName(java.lang.String displayName)
setDisplayName
in interface Context
displayName
- The new display namepublic boolean getDistributable()
getDistributable
in interface Context
public void setDistributable(boolean distributable)
setDistributable
in interface Context
distributable
- The new distributable flagpublic java.lang.String getDocBase()
getDocBase
in interface Context
public void setDocBase(java.lang.String docBase)
setDocBase
in interface Context
docBase
- The new document rootpublic java.lang.String getInfo()
<description>/<version>
.getInfo
in interface Container
getInfo
in class ContainerBase
public 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 Container
setLoader
in class ContainerBase
loader
- The newly associated loaderpublic boolean getIgnoreAnnotations()
getIgnoreAnnotations
in interface Context
public void setIgnoreAnnotations(boolean ignoreAnnotations)
setIgnoreAnnotations
in interface Context
ignoreAnnotations
- The boolean on the annotations parsingpublic void setSessionCookie(SessionCookie sessionCookie)
setSessionCookie
in interface Context
sessionCookie
- The new valuepublic SessionCookie getSessionCookie()
getSessionCookie
in interface Context
public java.lang.String getLogicalName()
getLogicalName
in interface Context
public void setLogicalName(java.lang.String logicalName)
setLogicalName
in interface Context
logicalName
- The new logical namepublic LoginConfig getLoginConfig()
getLoginConfig
in interface Context
public void setLoginConfig(LoginConfig config)
setLoginConfig
in interface Context
config
- 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 Context
public void setPublicId(java.lang.String publicId)
setPublicId
in interface Context
publicId
- The public identifierpublic java.lang.String getVersion()
getVersion
in interface Context
public int getVersionMajor()
getVersionMajor
in interface Context
public int getVersionMinor()
getVersionMinor
in interface Context
public void setVersion(java.lang.String version)
setVersion
in interface Context
version
- The versionpublic boolean getOverride()
getOverride
in interface Context
public java.lang.ClassLoader getParentClassLoader()
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 setOverride(boolean override)
setOverride
in interface Context
override
- 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)
Context
addSessionTrackingMode
in interface Context
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 long getUnloadDelay()
public void setUnloadDelay(long unloadDelay)
unloadDelay
- The new valuepublic java.lang.String getWrapperClass()
getWrapperClass
in interface Context
public void setWrapperClass(java.lang.String wrapperClassName)
setWrapperClass
in interface Context
wrapperClassName
- 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 Container
setResources
in class ContainerBase
resources
- The newly associated DirContextpublic ThreadBindingListener getThreadBindingListener()
getThreadBindingListener
in interface Context
public void setThreadBindingListener(ThreadBindingListener threadBindingListener)
setThreadBindingListener
in interface Context
public 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 Context
listener
- 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 Context
listener
- Java instance of a listenerpublic 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 addedjava.lang.IllegalArgumentException
- if the proposed container is
not an implementation of Wrapperpublic void addConstraint(SecurityConstraint constraint)
addConstraint
in interface Context
public void addErrorPage(ErrorPage errorPage)
addErrorPage
in interface Context
errorPage
- 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 Context
filterDef
- The filter definition to be addedpublic void addFilterMap(FilterMap filterMap)
addFilterMap
in interface Context
filterMap
- 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 Context
filterMap
- 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 Context
listener
- Java class name of an InstanceListener classpublic void addJspMapping(java.lang.String pattern)
addJspMapping
in interface Context
pattern
- URL pattern to be mappedpublic void addJspPropertyGroup(JspPropertyGroup propertyGroup)
addJspPropertyGroup
in interface Context
pattern
- URL pattern to be mappedpublic void addJspTagLibrary(TagLibraryInfo tagLibraryInfo)
addJspTagLibrary
in interface Context
tagLibrayInfo
- the tag library info that will be addedpublic void addJspTagLibrary(java.lang.String uri, TagLibraryInfo tagLibraryInfo)
addJspTagLibrary
in interface Context
uri
- 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 Context
locale
- 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 Context
extension
- Filename extension being mappedmimeType
- Corresponding MIME typepublic void addParameter(java.lang.String name, java.lang.String value)
addParameter
in interface Context
name
- 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 Context
role
- Security role used in the applicationlink
- Actual security role to check forpublic void addSecurityRole(java.lang.String role)
addSecurityRole
in interface Context
role
- New security rolepublic void addServletMapping(java.lang.String pattern, java.lang.String name)
addServletMapping
in interface Context
pattern
- 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 Context
name
- New welcome file namepublic void addWrapperLifecycle(java.lang.String listener)
addWrapperLifecycle
in interface Context
listener
- Java class name of a LifecycleListener classpublic void addWrapperListener(java.lang.String listener)
addWrapperListener
in interface Context
listener
- Java class name of a ContainerListener classpublic Wrapper createWrapper()
createWrapper
in interface Context
public ApplicationFilterConfig findApplicationFilterConfig(java.lang.String name)
public ApplicationFilterConfig[] findApplicationFilterConfigs()
public java.lang.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 uppublic ErrorPage findErrorPage(java.lang.String exceptionType)
null
.findErrorPage
in interface Context
exceptionType
- Exception type to look uppublic ErrorPage[] findErrorPages()
findErrorPages
in interface Context
public FilterDef findFilterDef(java.lang.String filterName)
null
.findFilterDef
in interface Context
filterName
- Filter name to look uppublic FilterDef[] findFilterDefs()
findFilterDefs
in interface Context
public FilterMap[] findFilterMaps()
findFilterMaps
in interface Context
public java.lang.String[] findInstanceListeners()
findInstanceListeners
in interface Context
public JspPropertyGroup[] findJspPropertyGroups()
findJspPropertyGroups
in interface Context
public Context findMappingObject()
public java.lang.String findMimeMapping(java.lang.String extension)
null
.findMimeMapping
in interface Context
extension
- Extension to map to a MIME typepublic java.lang.String[] findMimeMappings()
findMimeMappings
in interface Context
public java.lang.String findParameter(java.lang.String name)
null
.findParameter
in interface Context
name
- Name of the parameter to returnpublic java.lang.String[] findParameters()
findParameters
in interface Context
public java.lang.String findRoleMapping(java.lang.String role)
findRoleMapping
in interface Context
role
- 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 Context
role
- Security role to verifypublic java.lang.String[] findSecurityRoles()
findSecurityRoles
in interface Context
public java.lang.String findServletMapping(java.lang.String pattern)
null
.findServletMapping
in interface Context
pattern
- Pattern for which a mapping is requestedpublic java.lang.String[] findServletMappings()
findServletMappings
in interface Context
public int[] findStatusPages()
findStatusPages
in interface Context
public java.lang.String findTaglib(java.lang.String uri)
null
.findTaglib
in interface Context
uri
- URI, relative to the web.xml filepublic java.lang.String[] findTaglibs()
findTaglibs
in interface Context
public boolean findWelcomeFile(java.lang.String name)
true
if the specified welcome file is defined
for this Context; otherwise return false
.findWelcomeFile
in interface Context
name
- Welcome file to verifypublic java.lang.String[] findWelcomeFiles()
findWelcomeFiles
in interface Context
public java.lang.String[] findWrapperLifecycles()
findWrapperLifecycles
in interface Context
public java.lang.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. 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 Context
listener
- Java class name of the listener to be removedpublic void removeApplicationParameter(java.lang.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 addedjava.lang.IllegalArgumentException
- 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(java.lang.String listener)
removeInstanceListener
in interface Context
listener
- Class name of an InstanceListener class to be removedpublic void removeMimeMapping(java.lang.String extension)
removeMimeMapping
in interface Context
extension
- Extension to remove the mapping forpublic void removeParameter(java.lang.String name)
removeParameter
in interface Context
name
- Name of the parameter to removepublic void removeRoleMapping(java.lang.String role)
removeRoleMapping
in interface Context
role
- Security role (as used in the application) to removepublic void removeSecurityRole(java.lang.String role)
removeSecurityRole
in interface Context
role
- Security role to removepublic void removeServletMapping(java.lang.String pattern)
removeServletMapping
in interface Context
pattern
- URL pattern of the mapping to removepublic void removeTaglib(java.lang.String uri)
removeTaglib
in interface Context
uri
- URI, relative to the web.xml filepublic void removeWelcomeFile(java.lang.String name)
removeWelcomeFile
in interface Context
name
- Name of the welcome file to be removedpublic void removeWrapperLifecycle(java.lang.String listener)
removeWrapperLifecycle
in interface Context
listener
- Class name of a LifecycleListener class to be removedpublic void removeWrapperListener(java.lang.String listener)
removeWrapperListener
in interface Context
listener
- 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 Lifecycle
start
in class ContainerBase
LifecycleException
- if a startup error occurspublic void stop() throws LifecycleException
stop
in interface Lifecycle
stop
in class ContainerBase
LifecycleException
- if a shutdown error occurspublic void destroy() throws java.lang.Exception
destroy
in class ContainerBase
java.lang.Exception
protected void resetContext() throws java.lang.Exception, javax.management.MBeanRegistrationException
java.lang.Exception
javax.management.MBeanRegistrationException
public java.lang.String toString()
toString
in class java.lang.Object
protected 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 ContainerBase
javax.management.MalformedObjectNameException
protected 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.MBeanRegistration
preRegister
in class ContainerBase
server
- The servername
- The object namejava.lang.Exception
- If an error occurspublic void preDeregister() throws java.lang.Exception
preDeregister
in interface javax.management.MBeanRegistration
preDeregister
in class ContainerBase
java.lang.Exception
public void init() throws java.lang.Exception
ContainerBase
init
in class ContainerBase
java.lang.Exception
public boolean isInitialized()
Context
isInitialized
in interface Context
public javax.management.ObjectName getParentName() throws javax.management.MalformedObjectNameException
getParentName
in class ContainerBase
javax.management.MalformedObjectNameException
public void create() throws java.lang.Exception
java.lang.Exception
public void removeNotificationListener(javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object object) throws javax.management.ListenerNotFoundException
removeNotificationListener
in interface javax.management.NotificationEmitter
javax.management.ListenerNotFoundException
public javax.management.MBeanNotificationInfo[] getNotificationInfo()
getNotificationInfo
in interface javax.management.NotificationBroadcaster
public void addNotificationListener(javax.management.NotificationListener listener, javax.management.NotificationFilter filter, java.lang.Object object) throws java.lang.IllegalArgumentException
addNotificationListener
in interface javax.management.NotificationBroadcaster
java.lang.IllegalArgumentException
public void removeNotificationListener(javax.management.NotificationListener listener) throws javax.management.ListenerNotFoundException
removeNotificationListener
in interface javax.management.NotificationBroadcaster
javax.management.ListenerNotFoundException
NotificationBroadcaster.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
LifecycleException
public 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()