ContextConfig (Apache Tomcat 7.0.67 API Documentation)

java.lang.Object
- org.apache.catalina.startup.ContextConfig

All Implemented Interfaces:

LifecycleListener
```
public class ContextConfig
extends java.lang.Object
implements LifecycleListener
```
Startup event listener for a Context that configures the properties of that Context, and the associated defined servlets.

Author:

Craig R. McClanahan, Jean-Francois Arcand

Field Summary

Fields
Modifier and Type	Field and Description
`protected static java.util.Properties`	`authenticators` The set of Authenticators that we know how to configure.
`protected Context`	`context` The Context we are associated with.
`protected java.util.Map<java.lang.String,Authenticator>`	`customAuthenticators` Custom mappings of login methods to authenticators
`protected java.lang.String`	`defaultContextXml` Deprecated. Unnecessary
`protected java.lang.String`	`defaultWebXml` The default web application's deployment descriptor location.
`protected static long`	`deploymentCount` Deployment count.
`protected static LoginConfig`	`DUMMY_LOGIN_CONFIG`
`protected boolean`	`handlesTypesAnnotations` Flag that indicates if at least one `HandlesTypes` entry is present that represents an annotation.
`protected boolean`	`handlesTypesNonAnnotations` Flag that indicates if at least one `HandlesTypes` entry is present that represents a non-annotation.
`protected static java.util.Map<Host,org.apache.catalina.startup.ContextConfig.DefaultWebXmlCacheEntry>`	`hostWebXmlCache` Cache of default web.xml fragments per Host
`protected java.util.Map<ServletContainerInitializer,java.util.Set<java.lang.Class<?>>>`	`initializerClassMap` Map of ServletContainerInitializer to classes they expressed interest in.
`protected java.util.Map<java.lang.String,org.apache.catalina.startup.ContextConfig.JavaClassCacheEntry>`	`javaClassCache` Cache of JavaClass objects (byte code) by fully qualified class name.
`protected boolean`	`ok` Track any fatal errors during startup configuration processing.
`protected java.lang.String`	`originalDocBase` Original docBase.
`protected static StringManager`	`sm` The string resources for this package.
`protected java.util.Map<java.lang.Class<?>,java.util.Set<ServletContainerInitializer>>`	`typeInitializerMap` Map of Types to ServletContainerInitializer that are interested in those types.
`protected Digester`	`webDigester` The `Digester` we will use to process web application deployment descriptor files.
`protected Digester`	`webFragmentDigester` The `Digester` we will use to process web fragment deployment descriptor files.
`protected WebRuleSet`	`webFragmentRuleSet`
`protected WebRuleSet`	`webRuleSet`

Constructor Summary

Constructors
Constructor and Description

ContextConfig()

Constructors
Constructor and Description
`ContextConfig()`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`antiLocking()`
`protected void`	`applicationAnnotationsConfig()` Process the application classes annotations, if it exists.
`protected void`	`authenticatorConfig()` Set up an Authenticator automatically if required, and one has not already been configured.
`protected void`	`beforeStart()` Process a "before start" event for this Context.
`protected void`	`checkHandlesTypes(JavaClass javaClass)` For classes packaged with the web application, the class and each super class needs to be checked for a match with `HandlesTypes` or for an annotation that matches `HandlesTypes`.
`protected void`	`configureStart()` Process a "contextConfig" event for this Context.
`protected void`	`configureStop()` Process a "stop" event for this Context.
`protected void`	`contextConfig(Digester digester)` Process the default configuration file, if it exists.
`protected Digester`	`createContextDigester()` Create (if necessary) and return a Digester configured to process the context configuration descriptor for an application.
`protected WebXml`	`createWebXml()`
`void`	`createWebXmlDigester(boolean namespaceAware, boolean validation)` Create and return a Digester configured to process the web application deployment descriptor (web.xml).
`protected void`	`destroy()` Process a "destroy" event for this Context.
`protected void`	`fixDocBase()` Adjust docBase.
`protected java.lang.String`	`getBaseDir()`
`protected java.io.File`	`getConfigBase()` Deprecated. Unused - will be removed in 8.0.x
`protected org.xml.sax.InputSource`	`getContextWebXmlSource()` Identify the application web.xml to be used and obtain an input source for it.
`java.lang.String`	`getDefaultContextXml()` Deprecated. Never changed from default
`java.lang.String`	`getDefaultWebXml()` Return the location of the default deployment descriptor
`protected org.xml.sax.InputSource`	`getGlobalWebXmlSource()` Identify the default web.xml to be used and obtain an input source for it.
`protected java.io.File`	`getHostConfigBase()`
`protected org.xml.sax.InputSource`	`getHostWebXmlSource()` Identify the host web.xml to be used and obtain an input source for it.
`protected org.xml.sax.InputSource`	`getWebXmlSource(java.lang.String filename, java.lang.String path)`
`protected void`	`init()` Process a "init" event for this Context.
`void`	`lifecycleEvent(LifecycleEvent event)` Process events for an associated Context.
`protected void`	`parseWebXml(org.xml.sax.InputSource source, WebXml dest, boolean fragment)` Parses the given source and stores the parsed data in the given web.xml representation.
`protected void`	`processAnnotations(java.util.Set<WebXml> fragments, boolean handlesTypesOnly)`
`protected void`	`processAnnotationsFile(java.io.File file, WebXml fragment, boolean handlesTypesOnly)`
`protected void`	`processAnnotationsJar(java.net.URL url, WebXml fragment, boolean handlesTypesOnly)`
`protected void`	`processAnnotationsJndi(java.net.URL url, WebXml fragment, boolean handlesTypesOnly)`
`protected void`	`processAnnotationsStream(java.io.InputStream is, WebXml fragment, boolean handlesTypesOnly)`
`protected java.lang.String[]`	`processAnnotationsStringArray(ElementValue ev)`
`protected void`	`processAnnotationsUrl(java.net.URL url, WebXml fragment, boolean handlesTypesOnly)`
`protected void`	`processAnnotationWebFilter(java.lang.String className, AnnotationEntry ae, WebXml fragment)` process filter annotation and merge with existing one!
`protected java.util.Map<java.lang.String,java.lang.String>`	`processAnnotationWebInitParams(ElementValue ev)`
`protected void`	`processAnnotationWebServlet(java.lang.String className, AnnotationEntry ae, WebXml fragment)`
`protected void`	`processContextConfig(Digester digester, java.net.URL contextXml)` Process a context.xml.
`protected java.util.Map<java.lang.String,WebXml>`	`processJarsForWebFragments(WebXml application)` Scan /WEB-INF/lib for JARs and for each one found add it and any /META-INF/web-fragment.xml to the resulting Map. web-fragment.xml files will be parsed before being added to the map.
`protected void`	`processResourceJARs(java.util.Set<WebXml> fragments)` Scan JARs that contain web-fragment.xml files that will be used to configure this application to see if they also contain static resources.
`protected void`	`processServletContainerInitializers()` Scan JARs for ServletContainerInitializer implementations.
`void`	`setCustomAuthenticators(java.util.Map<java.lang.String,Authenticator> customAuthenticators)` Sets custom mappings of login methods to authenticators.
`void`	`setDefaultContextXml(java.lang.String path)` Deprecated. Unused
`void`	`setDefaultWebXml(java.lang.String path)` Set the location of the default deployment descriptor
`protected void`	`validateSecurityRoles()` Validate the usage of security role names in the web application deployment descriptor.
`protected void`	`webConfig()` Scan the web.xml files that apply to the web application and merge them using the rules defined in the spec.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - sm
```
protected static final StringManager sm
```
    The string resources for this package.
  - DUMMY_LOGIN_CONFIG
```
protected static final LoginConfig DUMMY_LOGIN_CONFIG
```
  - authenticators
```
protected static final java.util.Properties authenticators
```
    The set of Authenticators that we know how to configure. The key is the name of the implemented authentication method, and the value is the fully qualified Java class name of the corresponding Valve.
  - deploymentCount
```
protected static long deploymentCount
```
    Deployment count.
  - hostWebXmlCache
```
protected static final java.util.Map<Host,org.apache.catalina.startup.ContextConfig.DefaultWebXmlCacheEntry> hostWebXmlCache
```
    Cache of default web.xml fragments per Host
  - customAuthenticators
```
protected java.util.Map<java.lang.String,Authenticator> customAuthenticators
```
    Custom mappings of login methods to authenticators
  - context
```
protected Context context
```
    The Context we are associated with.
  - defaultContextXml
```
@Deprecated
protected java.lang.String defaultContextXml
```
    Deprecated. Unnecessary
    
    The default web application's context file location.
  - defaultWebXml
```
protected java.lang.String defaultWebXml
```
    The default web application's deployment descriptor location.
  - ok
```
protected boolean ok
```
    Track any fatal errors during startup configuration processing.
  - originalDocBase
```
protected java.lang.String originalDocBase
```
    Original docBase.
  - initializerClassMap
```
protected final java.util.Map<ServletContainerInitializer,java.util.Set<java.lang.Class<?>>> initializerClassMap
```
    Map of ServletContainerInitializer to classes they expressed interest in.
  - typeInitializerMap
```
protected final java.util.Map<java.lang.Class<?>,java.util.Set<ServletContainerInitializer>> typeInitializerMap
```
    Map of Types to ServletContainerInitializer that are interested in those types.
  - javaClassCache
```
protected final java.util.Map<java.lang.String,org.apache.catalina.startup.ContextConfig.JavaClassCacheEntry> javaClassCache
```
    Cache of JavaClass objects (byte code) by fully qualified class name. Only populated if it is necessary to scan the super types and interfaces as part of the processing for HandlesTypes.
  - handlesTypesAnnotations
```
protected boolean handlesTypesAnnotations
```
    Flag that indicates if at least one HandlesTypes entry is present that represents an annotation.
  - handlesTypesNonAnnotations
```
protected boolean handlesTypesNonAnnotations
```
    Flag that indicates if at least one HandlesTypes entry is present that represents a non-annotation.
  - webDigester
```
protected Digester webDigester
```
    The Digester we will use to process web application deployment descriptor files.
  - webRuleSet
```
protected WebRuleSet webRuleSet
```
  - webFragmentDigester
```
protected Digester webFragmentDigester
```
    The Digester we will use to process web fragment deployment descriptor files.
  - webFragmentRuleSet
```
protected WebRuleSet webFragmentRuleSet
```
- Constructor Detail
  - ContextConfig
```
public ContextConfig()
```
- Method Detail
  - getDefaultWebXml
```
public java.lang.String getDefaultWebXml()
```
    Return the location of the default deployment descriptor
  - setDefaultWebXml
```
public void setDefaultWebXml(java.lang.String path)
```
    Set the location of the default deployment descriptor
    
    Parameters:
    path - Absolute/relative path to the default web.xml
  - getDefaultContextXml
```
@Deprecated
public java.lang.String getDefaultContextXml()
```
    Deprecated. Never changed from default
    
    Return the location of the default context file
  - setDefaultContextXml
```
@Deprecated
public void setDefaultContextXml(java.lang.String path)
```
    Deprecated. Unused
    
    Set the location of the default context file
    
    Parameters:
    path - Absolute/relative path to the default context.xml
  - setCustomAuthenticators
```
public void setCustomAuthenticators(java.util.Map<java.lang.String,Authenticator> customAuthenticators)
```
    Sets custom mappings of login methods to authenticators.
    
    Parameters:
    customAuthenticators - Custom mappings of login methods to authenticators
  - lifecycleEvent
```
public void lifecycleEvent(LifecycleEvent event)
```
    Process events for an associated Context.
    
    Specified by:
    
    lifecycleEvent in interface LifecycleListener
    
    Parameters:
    event - The lifecycle event that has occurred
  - applicationAnnotationsConfig
```
protected void applicationAnnotationsConfig()
```
    Process the application classes annotations, if it exists.
  - authenticatorConfig
```
protected void authenticatorConfig()
```
    Set up an Authenticator automatically if required, and one has not already been configured.
  - createWebXmlDigester
```
public void createWebXmlDigester(boolean namespaceAware,
                        boolean validation)
```
    Create and return a Digester configured to process the web application deployment descriptor (web.xml).
  - createContextDigester
```
protected Digester createContextDigester()
```
    Create (if necessary) and return a Digester configured to process the context configuration descriptor for an application.
  - getBaseDir
```
protected java.lang.String getBaseDir()
```
  - contextConfig
```
protected void contextConfig(Digester digester)
```
    Process the default configuration file, if it exists.
  - processContextConfig
```
protected void processContextConfig(Digester digester,
                        java.net.URL contextXml)
```
    Process a context.xml.
  - fixDocBase
```
protected void fixDocBase()
                   throws java.io.IOException
```
    Adjust docBase.
    
    Throws:
    
    java.io.IOException
  - antiLocking
```
protected void antiLocking()
```
  - init
```
protected void init()
```
    Process a "init" event for this Context.
  - beforeStart
```
protected void beforeStart()
```
    Process a "before start" event for this Context.
  - configureStart
```
protected void configureStart()
```
    Process a "contextConfig" event for this Context.
  - configureStop
```
protected void configureStop()
```
    Process a "stop" event for this Context.
  - destroy
```
protected void destroy()
```
    Process a "destroy" event for this Context.
  - validateSecurityRoles
```
protected void validateSecurityRoles()
```
    Validate the usage of security role names in the web application deployment descriptor. If any problems are found, issue warning messages (for backwards compatibility) and add the missing roles. (To make these problems fatal instead, simply set the ok instance variable to false as well).
  - getConfigBase
```
@Deprecated
protected java.io.File getConfigBase()
```
    Deprecated. Unused - will be removed in 8.0.x
    
    Get config base.
  - getHostConfigBase
```
protected java.io.File getHostConfigBase()
```
  - webConfig
```
protected void webConfig()
```
    Scan the web.xml files that apply to the web application and merge them using the rules defined in the spec. For the global web.xml files, where there is duplicate configuration, the most specific level wins. ie an application's web.xml takes precedence over the host level or global web.xml file.
  - createWebXml
```
protected WebXml createWebXml()
```
  - processServletContainerInitializers
```
protected void processServletContainerInitializers()
```
    Scan JARs for ServletContainerInitializer implementations.
  - processResourceJARs
```
protected void processResourceJARs(java.util.Set<WebXml> fragments)
```
    Scan JARs that contain web-fragment.xml files that will be used to configure this application to see if they also contain static resources. If static resources are found, add them to the context. Resources are added in web-fragment.xml priority order.
  - getGlobalWebXmlSource
```
protected org.xml.sax.InputSource getGlobalWebXmlSource()
```
    Identify the default web.xml to be used and obtain an input source for it.
  - getHostWebXmlSource
```
protected org.xml.sax.InputSource getHostWebXmlSource()
```
    Identify the host web.xml to be used and obtain an input source for it.
  - getContextWebXmlSource
```
protected org.xml.sax.InputSource getContextWebXmlSource()
```
    Identify the application web.xml to be used and obtain an input source for it.
  - getWebXmlSource
```
protected org.xml.sax.InputSource getWebXmlSource(java.lang.String filename,
                                      java.lang.String path)
```
    Parameters:
    filename - Name of the file (possibly with one or more leading path segments) to read
    path - Location that filename is relative to
  - parseWebXml
```
protected void parseWebXml(org.xml.sax.InputSource source,
               WebXml dest,
               boolean fragment)
```
    Parses the given source and stores the parsed data in the given web.xml representation. The byte stream will be closed at the end of the parse operation.
    
    Parameters:
    source - Input source containing the XML data to be parsed
    dest - The object representation of common elements of web.xml and web-fragment.xml
    fragment - Specifies whether the source is web-fragment.xml or web.xml
  - processJarsForWebFragments
```
protected java.util.Map<java.lang.String,WebXml> processJarsForWebFragments(WebXml application)
```
    Scan /WEB-INF/lib for JARs and for each one found add it and any /META-INF/web-fragment.xml to the resulting Map. web-fragment.xml files will be parsed before being added to the map. Every JAR will be added and null will be used if no web-fragment.xml was found. Any JARs known not contain fragments will be skipped.
    
    Returns:
    A map of JAR name to processed web fragment (if any)
  - processAnnotations
```
protected void processAnnotations(java.util.Set<WebXml> fragments,
                      boolean handlesTypesOnly)
```
  - processAnnotationsUrl
```
protected void processAnnotationsUrl(java.net.URL url,
                         WebXml fragment,
                         boolean handlesTypesOnly)
```
  - processAnnotationsJar
```
protected void processAnnotationsJar(java.net.URL url,
                         WebXml fragment,
                         boolean handlesTypesOnly)
```
  - processAnnotationsJndi
```
protected void processAnnotationsJndi(java.net.URL url,
                          WebXml fragment,
                          boolean handlesTypesOnly)
```
  - processAnnotationsFile
```
protected void processAnnotationsFile(java.io.File file,
                          WebXml fragment,
                          boolean handlesTypesOnly)
```
  - processAnnotationsStream
```
protected void processAnnotationsStream(java.io.InputStream is,
                            WebXml fragment,
                            boolean handlesTypesOnly)
                                 throws ClassFormatException,
                                        java.io.IOException
```
    Throws:
    
    ClassFormatException
    
    java.io.IOException
  - checkHandlesTypes
```
protected void checkHandlesTypes(JavaClass javaClass)
```
    For classes packaged with the web application, the class and each super class needs to be checked for a match with HandlesTypes or for an annotation that matches HandlesTypes.
    
    Parameters:
    javaClass -
  - processAnnotationWebServlet
```
protected void processAnnotationWebServlet(java.lang.String className,
                               AnnotationEntry ae,
                               WebXml fragment)
```
  - processAnnotationWebFilter
```
protected void processAnnotationWebFilter(java.lang.String className,
                              AnnotationEntry ae,
                              WebXml fragment)
```
    process filter annotation and merge with existing one! FIXME: refactoring method too long and has redundant subroutines with processAnnotationWebServlet!
    
    Parameters:
    className -
    ae -
    fragment -
  - processAnnotationsStringArray
```
protected java.lang.String[] processAnnotationsStringArray(ElementValue ev)
```
  - processAnnotationWebInitParams
```
protected java.util.Map<java.lang.String,java.lang.String> processAnnotationWebInitParams(ElementValue ev)
```

Class ContextConfig

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sm

DUMMY_LOGIN_CONFIG

authenticators

deploymentCount

hostWebXmlCache

customAuthenticators

context

defaultContextXml

defaultWebXml

ok

originalDocBase

initializerClassMap

typeInitializerMap

javaClassCache

handlesTypesAnnotations

handlesTypesNonAnnotations

webDigester

webRuleSet

webFragmentDigester

webFragmentRuleSet

Constructor Detail

ContextConfig

Method Detail

getDefaultWebXml

setDefaultWebXml

getDefaultContextXml

setDefaultContextXml

setCustomAuthenticators

lifecycleEvent

applicationAnnotationsConfig

authenticatorConfig

createWebXmlDigester

createContextDigester

getBaseDir

contextConfig

processContextConfig

fixDocBase

antiLocking

init

beforeStart

configureStart

configureStop

destroy

validateSecurityRoles

getConfigBase

getHostConfigBase

webConfig

createWebXml

processServletContainerInitializers

processResourceJARs

getGlobalWebXmlSource

getHostWebXmlSource

getContextWebXmlSource

getWebXmlSource

parseWebXml

processJarsForWebFragments

processAnnotations

processAnnotationsUrl

processAnnotationsJar

processAnnotationsJndi

processAnnotationsFile

processAnnotationsStream

checkHandlesTypes

processAnnotationWebServlet

processAnnotationWebFilter

processAnnotationsStringArray

processAnnotationWebInitParams