|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.catalina.core.ContainerBase org.apache.catalina.core.StandardContext
Standard implementation of the Context interface. Each child container must be a Wrapper implementation to process the requests directed to a particular servlet.
Nested Class Summary |
Nested classes inherited from class org.apache.catalina.core.ContainerBase |
ContainerBase.ContainerBackgroundProcessor, ContainerBase.PrivilegedAddChild |
Field Summary | |
protected boolean |
allowLinking
Allow linking. |
protected int |
cacheMaxSize
Cache max size in KB. |
protected int |
cacheTTL
Cache TTL in ms. |
protected boolean |
caseSensitive
Case sensitivity. |
Fields inherited from class org.apache.catalina.core.ContainerBase |
backgroundProcessorDelay, children, cluster, controller, debug, domain, initialized, lifecycle, listeners, loader, logger, manager, mserver, name, oname, parent, parentClassLoader, pipeline, realm, resources, sm, started, suffix, support, type |
Fields inherited from interface org.apache.catalina.Context |
RELOAD_EVENT |
Fields inherited from interface org.apache.catalina.Container |
ADD_CHILD_EVENT, ADD_MAPPER_EVENT, ADD_VALVE_EVENT, REMOVE_CHILD_EVENT, REMOVE_MAPPER_EVENT, REMOVE_VALVE_EVENT |
Fields inherited from interface org.apache.catalina.Lifecycle |
AFTER_START_EVENT, AFTER_STOP_EVENT, BEFORE_START_EVENT, BEFORE_STOP_EVENT, START_EVENT, STOP_EVENT |
Constructor Summary | |
StandardContext()
Create a new StandardContext component with the default basic Valve. |
Method Summary | |
void |
addApplicationListener(java.lang.String listener)
Add a new Listener class name to the set of Listeners configured for this application. |
void |
addApplicationParameter(ApplicationParameter parameter)
Add a new application parameter for this application. |
void |
addChild(Container child)
Add a child Container, only if the proposed child is an implementation of Wrapper. |
void |
addConstraint(SecurityConstraint constraint)
Add a security constraint to the set for this web application. |
void |
addEjb(ContextEjb ejb)
Add an EJB resource reference for this web application. |
void |
addEnvironment(ContextEnvironment environment)
Add an environment entry for this web application. |
java.lang.String |
addEnvironment(java.lang.String envName,
java.lang.String type)
Add an environment entry 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. |
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 |
addLocaleEncodingMappingParameter(java.lang.String locale,
java.lang.String encoding)
Add a Locale Encoding Mapping (see Sec 5.4 of Servlet spec 2.4) |
void |
addLocalEjb(ContextLocalEjb ejb)
Add a local EJB resource reference for this web application. |
void |
addMessageDestination(MessageDestination md)
Add a message destination for this web application. |
void |
addMessageDestinationRef(MessageDestinationRef mdr)
Add a message destination reference for this web application. |
void |
addMimeMapping(java.lang.String extension,
java.lang.String mimeType)
Add a new MIME mapping, replacing any existing mapping for the specified extension. |
void |
addParameter(java.lang.String name,
java.lang.String value)
Add a new context initialization parameter. |
void |
addResource(ContextResource resource)
Add a resource reference for this web application. |
java.lang.String |
addResource(java.lang.String resourceName,
java.lang.String type)
Add a resource reference for this web application. |
void |
addResourceEnvRef(java.lang.String name,
java.lang.String type)
Add a resource environment reference for this web application. |
void |
addResourceLink(ContextResourceLink resourceLink)
Add a resource link for this web application. |
java.lang.String |
addResourceLink(java.lang.String resourceLinkName,
java.lang.String global,
java.lang.String name,
java.lang.String type)
Add a resource link for this web application. |
void |
addResourceParams(ResourceParams resourceParameters)
Add resource parameters for this web application. |
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 |
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. |
void |
backgroundProcess()
Execute a periodic task, such as reloading, etc. |
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. |
boolean |
filterStart()
Configure and initialize the set of filters for this Context. |
boolean |
filterStop()
Finalize and release the set of filters for this Context. |
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. |
ContextEjb |
findEjb(java.lang.String name)
Return the EJB resource reference with the specified name, if any; otherwise, return null . |
ContextEjb[] |
findEjbs()
Return the defined EJB resource references for this application. |
ContextEnvironment |
findEnvironment(java.lang.String name)
Return the environment entry with the specified name, if any; otherwise, return null . |
ContextEnvironment[] |
findEnvironments()
Return the set of defined environment entries 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. |
javax.servlet.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. |
ContextLocalEjb |
findLocalEjb(java.lang.String name)
Return the local EJB resource reference with the specified name, if any; otherwise, return null . |
ContextLocalEjb[] |
findLocalEjbs()
Return the defined local EJB resource references for this application. |
Context |
findMappingObject()
FIXME: Fooling introspection ... |
MessageDestination |
findMessageDestination(java.lang.String name)
Return the message destination with the specified name, if any; otherwise, return null . |
MessageDestinationRef |
findMessageDestinationRef(java.lang.String name)
Return the message destination ref with the specified name, if any; otherwise, return null . |
MessageDestinationRef[] |
findMessageDestinationRefs()
Return the set of defined message destination refs for this web application. |
MessageDestination[] |
findMessageDestinations()
Return the set of defined message destinations for this web application. |
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. |
ContextResource |
findResource(java.lang.String name)
Return the resource reference with the specified name, if any; otherwise return null . |
java.lang.String |
findResourceEnvRef(java.lang.String name)
Return the resource environment reference type for the specified name, if any; otherwise return null . |
java.lang.String[] |
findResourceEnvRefs()
Return the set of resource environment reference names for this web application. |
ContextResourceLink |
findResourceLink(java.lang.String name)
Return the resource link with the specified name, if any; otherwise return null . |
ContextResourceLink[] |
findResourceLinks()
Return the defined resource links for this application. |
ContextResource[] |
findResources()
Return the defined resource references for this application. |
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. |
java.lang.String |
findStatusPage(int status)
Return the context-relative URI of the error page for the specified HTTP status code, if any; otherwise return null . |
int[] |
findStatusPages()
Return the set of HTTP status codes for which error pages have been specified. |
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. |
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. |
boolean |
getAvailable()
Return the application available flag for this Context. |
int |
getCacheMaxSize()
Return the maximum size of the cache 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.lang.String |
getCompilerClasspath()
Return the compiler classpath. |
java.lang.String |
getConfigFile()
Return the path to a file to save this Context information. |
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.lang.String |
getDefaultWebXml()
|
boolean |
getDelegate()
Return the "follow standard delegation model" flag used to configure our ClassLoader. |
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 |
getEngineName()
|
java.lang.String[] |
getEnvironments()
Return the MBean Names of the set of defined environment entries for this web application |
java.lang.String |
getHostname()
|
java.lang.String |
getInfo()
Return descriptive information about this Container implementation and the corresponding version number, in the format <description>/<version> . |
java.lang.String |
getJ2EEApplication()
|
java.lang.String |
getJ2EEServer()
|
java.lang.String[] |
getJavaVMs()
|
LoginConfig |
getLoginConfig()
Return the login configuration descriptor for this web application. |
int |
getManagerChecksFrequency()
Return the frequency of manager checks. |
Mapper |
getMapper()
Get the mapper associated with the context. |
NamingResources |
getNamingResources()
Return the naming resources associated with this web application. |
boolean |
getOverride()
Return the DefaultContext override flag 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. |
java.lang.String |
getPublicId()
Return the public identifier of the deployment descriptor DTD that is currently being parsed. |
boolean |
getReloadable()
Return the reloadable flag for this web application. |
java.lang.String[] |
getResourceLinks()
Return the MBean Names of all the defined resource links for this application |
java.lang.String[] |
getResourceNames()
Return the MBean Names of all the defined resource references for this application. |
java.lang.String |
getServer()
|
javax.servlet.ServletContext |
getServletContext()
Return the servlet context for which this Context is a facade. |
java.lang.String[] |
getServlets()
JSR77 servlets attribute |
int |
getSessionTimeout()
Return the default session timeout (in minutes) for this web application. |
long |
getStartTime()
|
long |
getStartupTime()
|
int |
getState()
|
javax.naming.directory.DirContext |
getStaticResources()
Return the naming resources associated with this web application. |
boolean |
getSwallowOutput()
Return the value of the swallowOutput flag. |
boolean |
getTldNamespaceAware()
Get the server.xml |
long |
getTldScanTime()
|
boolean |
getTldValidation()
Get the server.xml |
boolean |
getUnpackWAR()
Unpack WAR flag accessor. |
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. |
boolean |
getXmlNamespaceAware()
Get the server.xml |
boolean |
getXmlValidation()
Get the server.xml |
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 |
isLazy()
|
boolean |
isReplaceWelcomeFiles()
Return the "replace welcome files" property. |
protected boolean |
isServlet22()
Are we processing a version 2.2 deployment descriptor? |
boolean |
isStateManageable()
Support for "stateManageable" JSR77 |
boolean |
isStatisticsProvider()
|
boolean |
isUseNaming()
Returns true if the internal naming support is used. |
boolean |
listenerStart()
Configure the set of instantiated application event listeners for this Context. |
boolean |
listenerStop()
Send an application stop event to all interested listeners. |
void |
loadOnStartup(Container[] children)
Load and initialize all servlets marked "load on startup" in the web application deployment descriptor. |
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. |
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 |
removeEjb(java.lang.String name)
Remove any EJB resource reference with the specified name. |
void |
removeEnvironment(java.lang.String name)
Remove any environment entry with the specified name. |
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 |
removeLocalEjb(java.lang.String name)
Remove any local EJB resource reference with the specified name. |
void |
removeMessageDestination(java.lang.String name)
Remove any message destination with the specified name. |
void |
removeMessageDestinationRef(java.lang.String name)
Remove any message destination ref with the specified name. |
void |
removeMimeMapping(java.lang.String extension)
Remove the MIME mapping for the specified extension, if it exists; otherwise, no action is taken. |
void |
removeParameter(java.lang.String name)
Remove the context initialization parameter with the specified name, if it exists; otherwise, no action is taken. |
void |
removeResource(java.lang.String name)
Remove any resource reference with the specified name. |
void |
removeResourceEnvRef(java.lang.String name)
Remove any resource environment reference with the specified name. |
void |
removeResourceLink(java.lang.String name)
Remove any resource link with the specified name. |
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. |
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 |
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 |
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 |
setCompilerClasspath(java.lang.String compilerClasspath)
Set the compiler classpath. |
void |
setConfigFile(java.lang.String configFile)
Set the path to a file to save this Context information. |
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 |
setDefaultWebXml(java.lang.String defaultWebXml)
Set the location of the default web xml that will be used. |
void |
setDelegate(boolean delegate)
Set the "follow standard delegation model" flag used to configure our ClassLoader. |
void |
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 |
setJ2EEApplication(java.lang.String j2EEApplication)
|
void |
setJ2EEServer(java.lang.String j2EEServer)
|
java.lang.String[] |
setJavaVMs(java.lang.String[] javaVMs)
|
void |
setLazy(boolean lazy)
|
void |
setLoader(Loader loader)
Set the Loader with which this Context is associated. |
void |
setLoginConfig(LoginConfig config)
Set the login configuration descriptor for this web application. |
void |
setManagerChecksFrequency(int managerChecksFrequency)
Set the manager checks frequency. |
void |
setName(java.lang.String name)
Set a name string (suitable for use by humans) that describes this Container. |
void |
setNamingResources(NamingResources namingResources)
Set the naming resources for this web application. |
void |
setOverride(boolean override)
Set the DefaultContext override flag for this web application. |
void |
setPath(java.lang.String path)
Set the context path 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 |
setReloadable(boolean reloadable)
Set the reloadable flag for this web application. |
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 |
setSessionTimeout(int timeout)
Set the default session timeout (in minutes) for this web application. |
void |
setStartupTime(long startupTime)
|
void |
setSwallowOutput(boolean swallowOutput)
Set the value of the swallowOutput flag. |
void |
setTldNamespaceAware(boolean tldNamespaceAware)
Set the namespace aware feature of the XML parser used when parsing xml instances. |
void |
setTldScanTime(long tldScanTime)
|
void |
setTldValidation(boolean tldValidation)
Set the validation feature of the XML parser used when parsing tlds files. |
void |
setUnpackWAR(boolean unpackWAR)
Unpack WAR flag mutator. |
void |
setUseNaming(boolean useNaming)
Enables or disables naming. |
void |
setWorkDir(java.lang.String workDir)
Set the work directory for this Context. |
void |
setWrapperClass(java.lang.String wrapperClass)
Set the Java class name of the Wrapper implementation used for servlets registered in this Context. |
void |
setXmlNamespaceAware(boolean webXmlNamespaceAware)
Set the namespace aware feature of the XML parser used when parsing xml instances. |
void |
setXmlValidation(boolean webXmlValidation)
Set the validation feature of the XML parser used when parsing xml instances. |
void |
start()
Start this Context component. |
void |
startRecursive()
|
void |
stop()
Stop this Context component. |
void |
stopNew()
Stop this Context component. |
java.lang.String |
toString()
Return a String representation of this component. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.apache.catalina.Container |
addContainerListener, addPropertyChangeListener, findChild, findChildren, findContainerListeners, getBackgroundProcessorDelay, getCluster, getLoader, getLogger, getManager, getMappingObject, getName, getParent, getParentClassLoader, getPipeline, getRealm, getResources, invoke, removeContainerListener, removePropertyChangeListener, setBackgroundProcessorDelay, setCluster, setLogger, setManager, setParent, setParentClassLoader, setRealm |
Field Detail |
protected boolean caseSensitive
protected boolean allowLinking
protected int cacheMaxSize
protected int cacheTTL
Constructor Detail |
public StandardContext()
Method Detail |
public void setName(java.lang.String name)
Container
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 boolean getDelegate()
public void setDelegate(boolean delegate)
delegate
- The new flagpublic boolean isUseNaming()
public void setUseNaming(boolean useNaming)
public boolean isFilesystemBased()
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[] 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 boolean getAvailable()
getAvailable
in interface Context
public void setAvailable(boolean available)
setAvailable
in interface Context
available
- The new application available flagpublic CharsetMapper getCharsetMapper()
getCharsetMapper
in interface Context
public void setCharsetMapper(CharsetMapper mapper)
setCharsetMapper
in interface Context
mapper
- The new mapperpublic java.lang.String getConfigFile()
getConfigFile
in interface Context
public void setConfigFile(java.lang.String configFile)
setConfigFile
in interface Context
configFile
- The path to a file to save this Context information.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 java.lang.String getDefaultWebXml()
public void setDefaultWebXml(java.lang.String defaultWebXml)
defaultWebXml
- public 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 java.lang.String getCompilerClasspath()
public void setCompilerClasspath(java.lang.String compilerClasspath)
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 boolean isLazy()
public void setLazy(boolean lazy)
public int getManagerChecksFrequency()
public void setManagerChecksFrequency(int managerChecksFrequency)
managerChecksFrequency
- the new manager checks frequencypublic 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 LoginConfig getLoginConfig()
getLoginConfig
in interface Context
public void setLoginConfig(LoginConfig config)
setLoginConfig
in interface Context
config
- The new login configurationpublic Mapper getMapper()
getMapper
in interface Context
public NamingResources getNamingResources()
getNamingResources
in interface Context
public void setNamingResources(NamingResources namingResources)
setNamingResources
in interface Context
namingResources
- The new naming resourcespublic java.lang.String getPath()
getPath
in interface Context
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.
setPath
in interface Context
path
- The new context pathpublic java.lang.String getPublicId()
getPublicId
in interface Context
public void setPublicId(java.lang.String publicId)
setPublicId
in interface Context
publicId
- The public identifierpublic boolean getReloadable()
getReloadable
in interface Context
public boolean getOverride()
getOverride
in interface Context
public boolean getPrivileged()
getPrivileged
in interface Context
public void setPrivileged(boolean privileged)
setPrivileged
in interface Context
privileged
- The new privileged flagpublic void setReloadable(boolean reloadable)
setReloadable
in interface Context
reloadable
- The new reloadable flagpublic void setOverride(boolean override)
setOverride
in interface Context
override
- The new override flagpublic boolean isReplaceWelcomeFiles()
public void setReplaceWelcomeFiles(boolean replaceWelcomeFiles)
replaceWelcomeFiles
- The new property valuepublic javax.servlet.ServletContext getServletContext()
getServletContext
in interface Context
public int getSessionTimeout()
getSessionTimeout
in interface Context
public void setSessionTimeout(int timeout)
setSessionTimeout
in interface Context
timeout
- The new default session timeoutpublic boolean getSwallowOutput()
public void setSwallowOutput(boolean swallowOutput)
public boolean getUnpackWAR()
public void setUnpackWAR(boolean unpackWAR)
public java.lang.String getWrapperClass()
getWrapperClass
in interface Context
public void setWrapperClass(java.lang.String wrapperClass)
setWrapperClass
in interface Context
wrapperClass
- The new wrapper classpublic void setResources(javax.naming.directory.DirContext resources)
setResources
in interface Container
setResources
in class ContainerBase
resources
- The newly associated DirContextpublic 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 classpublic 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 added
java.lang.IllegalArgumentException
- if the proposed container is
not an implementation of Wrapperpublic void addConstraint(SecurityConstraint constraint)
addConstraint
in interface Context
public void addEjb(ContextEjb ejb)
addEjb
in interface Context
ejb
- New EJB resource referencepublic void addEnvironment(ContextEnvironment environment)
addEnvironment
in interface Context
environment
- New environment entrypublic void addResourceParams(ResourceParams resourceParameters)
resourceParameters
- New resource parameterspublic void addErrorPage(ErrorPage errorPage)
addErrorPage
in interface Context
errorPage
- The error page definition to be addedpublic void addFilterDef(FilterDef filterDef)
addFilterDef
in interface Context
filterDef
- The filter definition to be addedpublic void addFilterMap(FilterMap filterMap)
addFilterMap
in interface Context
filterMap
- The filter mapping to be added
java.lang.IllegalArgumentException
- if the specified filter name
does not match an existing filter definition, or the filter mapping
is malformedpublic 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 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 addLocalEjb(ContextLocalEjb ejb)
addLocalEjb
in interface Context
ejb
- New EJB resource referencepublic void addMessageDestination(MessageDestination md)
md
- New message destinationpublic void addMessageDestinationRef(MessageDestinationRef mdr)
mdr
- New message destination referencepublic 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 parameter
java.lang.IllegalArgumentException
- if the name or value is missing,
or if this context initialization parameter has already been
registeredpublic void addResource(ContextResource resource)
addResource
in interface Context
resource
- New resource referencepublic void addResourceEnvRef(java.lang.String name, java.lang.String type)
addResourceEnvRef
in interface Context
name
- The resource environment reference nametype
- The resource environment reference typepublic void addResourceLink(ContextResourceLink resourceLink)
addResourceLink
in interface Context
resourceLink
- New resource linkpublic 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 execute
java.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 otherwise
java.lang.IllegalArgumentException
- if the specified servlet name
is not known to this Contextpublic void addTaglib(java.lang.String uri, java.lang.String location)
addTaglib
in interface Context
uri
- URI, relative to the web.xml file, of this tag librarylocation
- Location of the tag library descriptorpublic 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 java.lang.String[] findApplicationListeners()
findApplicationListeners
in interface Context
public ApplicationParameter[] findApplicationParameters()
findApplicationParameters
in interface Context
public SecurityConstraint[] findConstraints()
findConstraints
in interface Context
public ContextEjb findEjb(java.lang.String name)
null
.
findEjb
in interface Context
name
- Name of the desired EJB resource referencepublic ContextEjb[] findEjbs()
findEjbs
in interface Context
public ContextEnvironment findEnvironment(java.lang.String name)
null
.
findEnvironment
in interface Context
name
- Name of the desired environment entrypublic ContextEnvironment[] findEnvironments()
findEnvironments
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 ContextLocalEjb findLocalEjb(java.lang.String name)
null
.
findLocalEjb
in interface Context
name
- Name of the desired EJB resource referencepublic ContextLocalEjb[] findLocalEjbs()
findLocalEjbs
in interface Context
public Context findMappingObject()
public MessageDestination findMessageDestination(java.lang.String name)
null
.
name
- Name of the desired message destinationpublic MessageDestination[] findMessageDestinations()
public MessageDestinationRef findMessageDestinationRef(java.lang.String name)
null
.
name
- Name of the desired message destination refpublic MessageDestinationRef[] findMessageDestinationRefs()
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 ContextResource findResource(java.lang.String name)
null
.
findResource
in interface Context
name
- Name of the desired resource referencepublic java.lang.String findResourceEnvRef(java.lang.String name)
null
.
findResourceEnvRef
in interface Context
name
- Name of the desired resource environment referencepublic java.lang.String[] findResourceEnvRefs()
findResourceEnvRefs
in interface Context
public ContextResourceLink findResourceLink(java.lang.String name)
null
.
findResourceLink
in interface Context
name
- Name of the desired resource linkpublic ContextResourceLink[] findResourceLinks()
findResourceLinks
in interface Context
public ContextResource[] findResources()
findResources
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 java.lang.String findStatusPage(int status)
null
.
findStatusPage
in interface Context
status
- HTTP status code to look uppublic 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.
reload
in interface Context
java.lang.IllegalStateException
- if the reloadable
property is set to false
.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 added
java.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 removeEjb(java.lang.String name)
removeEjb
in interface Context
name
- Name of the EJB resource reference to removepublic void removeEnvironment(java.lang.String name)
removeEnvironment
in interface Context
name
- Name of the environment entry to removepublic 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 removeLocalEjb(java.lang.String name)
removeLocalEjb
in interface Context
name
- Name of the EJB resource reference to removepublic void removeMessageDestination(java.lang.String name)
name
- Name of the message destination to removepublic void removeMessageDestinationRef(java.lang.String name)
name
- Name of the message destination ref to removepublic 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 removeResource(java.lang.String name)
removeResource
in interface Context
name
- Name of the resource reference to removepublic void removeResourceEnvRef(java.lang.String name)
removeResourceEnvRef
in interface Context
name
- Name of the resource environment reference to removepublic void removeResourceLink(java.lang.String name)
removeResourceLink
in interface Context
name
- Name of the resource link 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 boolean filterStart()
true
if all filter initialization completed
successfully, or false
otherwise.
public boolean filterStop()
true
if all filter finalization completed
successfully, or false
otherwise.
public javax.servlet.FilterConfig findFilterConfig(java.lang.String name)
FilterConfig
for the
specified filter name, if any; otherwise return null
.
name
- Name of the desired filterpublic boolean listenerStart()
true
if all listeners wre
initialized successfully, or false
otherwise.
public boolean listenerStop()
true
if all events were sent successfully,
or false
otherwise.
public boolean resourcesStart()
true
if initialization was successfull,
or false
otherwise.
public boolean resourcesStop()
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 stopNew() throws LifecycleException
LifecycleException
- if a shutdown 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
public java.lang.String toString()
public void backgroundProcess()
backgroundProcess
in interface Container
backgroundProcess
in class ContainerBase
protected java.lang.String adjustURLPattern(java.lang.String urlPattern)
urlPattern
- The URL pattern to be adjusted (if needed)
and returnedprotected boolean isServlet22()
protected java.io.File engineBase()
protected java.lang.String getDefaultConfigFile()
public boolean getPaused()
public java.lang.String getHostname()
public java.lang.String[] getEnvironments()
public java.lang.String[] getResourceNames()
public java.lang.String[] getResourceLinks()
public java.lang.String addEnvironment(java.lang.String envName, java.lang.String type) throws javax.management.MalformedObjectNameException
envName
- New environment entry name
javax.management.MalformedObjectNameException
public java.lang.String addResource(java.lang.String resourceName, java.lang.String type) throws javax.management.MalformedObjectNameException
resourceName
- New resource reference name
javax.management.MalformedObjectNameException
public java.lang.String addResourceLink(java.lang.String resourceLinkName, java.lang.String global, java.lang.String name, java.lang.String type) throws javax.management.MalformedObjectNameException
resourceLinkName
- New resource link name
javax.management.MalformedObjectNameException
public 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
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
- name
-
java.lang.Exception
public 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 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 javax.naming.directory.DirContext getStaticResources()
public javax.naming.directory.DirContext findStaticResources()
public java.lang.String[] getWelcomeFiles()
public void setXmlValidation(boolean webXmlValidation)
setXmlValidation
in interface Context
webXmlValidation
- true to enable xml instance validationpublic boolean getXmlValidation()
getXmlValidation
in interface Context
public boolean getXmlNamespaceAware()
getXmlNamespaceAware
in interface Context
public void setXmlNamespaceAware(boolean webXmlNamespaceAware)
setXmlNamespaceAware
in interface Context
webXmlNamespaceAware
- true to enable namespace awarenesspublic void setTldValidation(boolean tldValidation)
setTldValidation
in interface Context
public boolean getTldValidation()
getTldValidation
in interface Context
public boolean getTldNamespaceAware()
getTldNamespaceAware
in interface Context
public void setTldNamespaceAware(boolean tldNamespaceAware)
setTldNamespaceAware
in interface Context
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()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |