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.