## org.springframework.web.context
Interface ConfigurableWebApplicationContext

All Superinterfaces:
  ApplicationContext, ApplicationEventPublisher, BeanFactory, ConfigurableApplicationContext, EnvironmentCapable, HierarchicalBeanFactory, Lifecycle, ListableBeanFactory, MessageSource, ResourceLoader, ResourcePatternResolver, WebApplicationContext

All Known Implementing Classes:
  AbstractRefreshableWebApplicationContext, AnnotationConfigWebApplicationContext, GenericWebApplicationContext, StaticWebApplicationContext, XmlWebApplicationContext

    public interface ConfigurableWebApplicationContext

extends WebApplicationContext, ConfigurableApplicationContext

Interface to be implemented by configurable web application contexts. Supported by `ContextLoader` and `FrameworkServlet`.

Note: The setters of this interface need to be called before an invocation of the `ConfigurableApplicationContext.refresh()` method inherited from `ConfigurableApplicationContext`. They do not cause an initialization of the context on their own.

Since:
  05.12.2003
Author:
  Juergen Hoeller
See Also:
  `ConfigurableApplicationContext.refresh()`, `ContextLoader.createWebApplicationContext(javax.servlet.ServletContext)`, `FrameworkServlet.createWebApplicationContext(org.springframework.context.ApplicationContext)`

Field Summary
`static String` `APPLICATION_CONTEXT_ID_PREFIX` Prefix for ApplicationContext ids that refer to context path and/or servlet name.
`static String` `SERVLET_CONFIG_BEAN_NAME` Name of the ServletConfig environment bean in the factory.

Fields inherited from interface org.springframework.web.context.WebApplicationContext
`CONTEXT_ATTRIBUTES_BEAN_NAME, CONTEXT_PARAMETERS_BEAN_NAME, ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE, SCOPE_APPLICATION, SCOPE_GLOBAL_SESSION, SCOPE_REQUEST, SCOPE_SESSION, SERVLET_CONTEXT_BEAN_NAME`

Fields inherited from interface org.springframework.context.ConfigurableApplicationContext
`CONFIG_LOCATION_DELIMITERS, CONVERSION_SERVICE_BEAN_NAME, ENVIRONMENT_BEAN_NAME, LOAD_TIME_WEAVER_BEAN_NAME, SYSTEM_ENVIRONMENT_BEAN_NAME, SYSTEM_PROPERTIES_BEAN_NAME`

Fields inherited from interface org.springframework.beans.factory.BeanFactory
`FACTORY_BEAN_PREFIX`

Fields inherited from interface org.springframework.core.io.support.ResourcePatternResolver
`CLASSPATH_ALL_URL_PREFIX`

Fields inherited from interface org.springframework.core.io.ResourceLoader
`CLASSPATH_URL_PREFIX`

Method Summary
`String[]` `getConfigLocations()` Return the config locations for this web application context, or `null` if none specified.
`ConfigurableWebEnvironment` `getEnvironment()` Return the `ConfigurableWebEnvironment` used by this web application context.
`String` `getNamespace()` Return the namespace for this web application context, if any.
`ServletConfig` `getServletConfig()` Return the ServletConfig for this web application context, if any.
`void` `setConfigLocation(String configLocation)` Set the config locations for this web application context in init-param style, i.e.
`void` `setConfigLocations(String[] configLocations)` Set the config locations for this web application context.
`void` `setNamespace(String namespace)` Set the namespace for this web application context, to be used for building a default context config location.
`void` `setServletConfig(ServletConfig servletConfig)` Set the ServletConfig for this web application context.
`void` `setServletContext(ServletContext servletContext)` Set the ServletContext for this web application context.

Methods inherited from interface org.springframework.web.context.WebApplicationContext
`getServletContext`

Methods inherited from interface org.springframework.context.ConfigurableApplicationContext
`addApplicationListener, addBeanFactoryPostProcessor, close, getBeanFactory, isActive, refresh, registerShutdownHook, setEnvironment, setId, setParent`

Methods inherited from interface org.springframework.context.ApplicationContext
`getAutowireCapableBeanFactory, getDisplayName, getId, getParent, getStartupDate`

Methods inherited from interface org.springframework.beans.factory.ListableBeanFactory
`containsBeanDefinition, findAnnotationOnBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation`

Methods inherited from interface org.springframework.beans.factory.HierarchicalBeanFactory
`containsLocalBean, getParentBeanFactory`

Methods inherited from interface org.springframework.beans.factory.BeanFactory
`containsBean, getAliases, getBean, getBean, getBean, getBean, getType, isPrototype, isSingleton, isTypeMatch`

Methods inherited from interface org.springframework.context.MessageSource
`getMessage, getMessage, getMessage`

Methods inherited from interface org.springframework.context.ApplicationEventPublisher
`publishEvent`

Methods inherited from interface org.springframework.core.io.support.ResourcePatternResolver
`getResources`

Methods inherited from interface org.springframework.core.io.ResourceLoader
`getClassLoader, getResource`

Methods inherited from interface org.springframework.context.Lifecycle
`isRunning, start, stop`

Field Detail

### APPLICATION_CONTEXT_ID_PREFIX

    static final String APPLICATION_CONTEXT_ID_PREFIX

  Prefix for ApplicationContext ids that refer to context path and/or servlet name.

### SERVLET_CONFIG_BEAN_NAME

    static final String SERVLET_CONFIG_BEAN_NAME

  Name of the ServletConfig environment bean in the factory.

  See Also:
    `ServletConfig`, Constant Field Values

Method Detail

### setServletContext

    void setServletContext(ServletContext servletContext)

  Set the ServletContext for this web application context.

  Does not cause an initialization of the context: refresh needs to be called after the setting of all configuration properties.

  See Also:
    `ConfigurableApplicationContext.refresh()`

### setServletConfig

    void setServletConfig(ServletConfig servletConfig)

  Set the ServletConfig for this web application context. Only called for a WebApplicationContext that belongs to a specific Servlet.

  See Also:
    `ConfigurableApplicationContext.refresh()`

### getServletConfig

    ServletConfig getServletConfig()

  Return the ServletConfig for this web application context, if any.

### getEnvironment

    ConfigurableWebEnvironment getEnvironment()

  Return the `ConfigurableWebEnvironment` used by this web application context.

  Specified by:
    `getEnvironment` in interface `ConfigurableApplicationContext`
  Specified by:
    `getEnvironment` in interface `EnvironmentCapable`

### setNamespace

    void setNamespace(String namespace)

  Set the namespace for this web application context, to be used for building a default context config location. The root web application context does not have a namespace.

### getNamespace

    String getNamespace()

  Return the namespace for this web application context, if any.

### setConfigLocation

    void setConfigLocation(String configLocation)

  Set the config locations for this web application context in init-param style, i.e. with distinct locations separated by commas, semicolons or whitespace.

  If not set, the implementation is supposed to use a default for the given namespace or the root web application context, as appropriate.

### setConfigLocations

    void setConfigLocations(String[] configLocations)

  Set the config locations for this web application context.

  If not set, the implementation is supposed to use a default for the given namespace or the root web application context, as appropriate.

### getConfigLocations

    String[] getConfigLocations()

  Return the config locations for this web application context, or `null` if none specified.