org.springframework.boot.context.embedded
Class XmlEmbeddedWebApplicationContext

java.lang.Object
  org.springframework.core.io.DefaultResourceLoader
      org.springframework.context.support.AbstractApplicationContext
          org.springframework.context.support.GenericApplicationContext
              org.springframework.web.context.support.GenericWebApplicationContext
                  org.springframework.boot.context.embedded.EmbeddedWebApplicationContext
                      org.springframework.boot.context.embedded.XmlEmbeddedWebApplicationContext

All Implemented Interfaces:

Closeable, org.springframework.beans.factory.BeanFactory, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.HierarchicalBeanFactory, org.springframework.beans.factory.ListableBeanFactory, org.springframework.beans.factory.support.BeanDefinitionRegistry, org.springframework.context.ApplicationContext, org.springframework.context.ApplicationEventPublisher, org.springframework.context.ConfigurableApplicationContext, org.springframework.context.Lifecycle, org.springframework.context.MessageSource, org.springframework.core.AliasRegistry, org.springframework.core.env.EnvironmentCapable, org.springframework.core.io.ResourceLoader, org.springframework.core.io.support.ResourcePatternResolver, org.springframework.ui.context.ThemeSource, org.springframework.web.context.ConfigurableWebApplicationContext, org.springframework.web.context.WebApplicationContext

public class XmlEmbeddedWebApplicationContext
extends EmbeddedWebApplicationContext

EmbeddedWebApplicationContext which takes its configuration from XML documents, understood by an XmlBeanDefinitionReader.

Note: In case of multiple config locations, later bean definitions will override ones defined in earlier loaded files. This can be leveraged to deliberately override certain bean definitions via an extra XML file.

Author:

Phillip Webb

See Also:

EmbeddedWebApplicationContext.setNamespace(java.lang.String), GenericWebApplicationContext.setConfigLocations(java.lang.String[]), EmbeddedWebApplicationContext, XmlWebApplicationContext

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.core.io.DefaultResourceLoader

org.springframework.core.io.DefaultResourceLoader.ClassPathContextResource

Field Summary

Fields inherited from class org.springframework.boot.context.embedded.EmbeddedWebApplicationContext

DISPATCHER_SERVLET_NAME

Fields inherited from class org.springframework.context.support.AbstractApplicationContext

APPLICATION_EVENT_MULTICASTER_BEAN_NAME, LIFECYCLE_PROCESSOR_BEAN_NAME, logger, MESSAGE_SOURCE_BEAN_NAME

Fields inherited from interface org.springframework.web.context.ConfigurableWebApplicationContext

APPLICATION_CONTEXT_ID_PREFIX, SERVLET_CONFIG_BEAN_NAME

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

Constructor Summary

XmlEmbeddedWebApplicationContext()
Create a new XmlEmbeddedWebApplicationContext that needs to be loaded and then manually refreshed.

XmlEmbeddedWebApplicationContext(Class<?> relativeClass, String... resourceNames)
Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resource locations and automatically refreshing the context.

XmlEmbeddedWebApplicationContext(org.springframework.core.io.Resource... resources)
Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resources and automatically refreshing the context.

XmlEmbeddedWebApplicationContext(String... resourceLocations)
Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resource locations and automatically refreshing the context.

Method Summary

void	load(Class<?> relativeClass, String... resourceNames) Load bean definitions from the given XML resources.
void	load(org.springframework.core.io.Resource... resources) Load bean definitions from the given XML resources.
void	load(String... resourceLocations) Load bean definitions from the given XML resources.
void	refresh()
void	setEnvironment(org.springframework.core.env.ConfigurableEnvironment environment)
void	setValidating(boolean validating) Set whether to use XML validation.

Methods inherited from class org.springframework.boot.context.embedded.EmbeddedWebApplicationContext

doClose, finishRefresh, getEmbeddedServletContainer, getEmbeddedServletContainerFactory, getNamespace, getResourceByPath, getServletConfig, getServletContextInitializerBeans, onRefresh, postProcessBeanFactory, prepareEmbeddedWebApplicationContext, setNamespace, setServletConfig

Methods inherited from class org.springframework.web.context.support.GenericWebApplicationContext

createEnvironment, getApplicationName, getConfigLocations, getResourcePatternResolver, getServletContext, getTheme, initPropertySources, setConfigLocation, setConfigLocations, setServletContext

Methods inherited from class org.springframework.context.support.GenericApplicationContext

cancelRefresh, closeBeanFactory, getBeanDefinition, getBeanFactory, getDefaultListableBeanFactory, getResource, getResources, isAlias, isBeanNameInUse, refreshBeanFactory, registerAlias, registerBeanDefinition, removeAlias, removeBeanDefinition, setAllowBeanDefinitionOverriding, setAllowCircularReferences, setId, setParent, setResourceLoader

Methods inherited from class org.springframework.context.support.AbstractApplicationContext

addApplicationListener, addBeanFactoryPostProcessor, assertBeanFactoryActive, close, containsBean, containsBeanDefinition, containsLocalBean, destroy, destroyBeans, findAnnotationOnBean, finishBeanFactoryInitialization, getAliases, getApplicationListeners, getAutowireCapableBeanFactory, getBean, getBean, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanFactoryPostProcessors, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getDisplayName, getEnvironment, getId, getInternalParentBeanFactory, getInternalParentMessageSource, getMessage, getMessage, getMessage, getParent, getParentBeanFactory, getStartupDate, getType, initApplicationEventMulticaster, initLifecycleProcessor, initMessageSource, invokeBeanFactoryPostProcessors, isActive, isPrototype, isRunning, isSingleton, isTypeMatch, obtainFreshBeanFactory, onClose, prepareBeanFactory, prepareRefresh, publishEvent, registerBeanPostProcessors, registerListeners, registerShutdownHook, setDisplayName, start, stop, toString

Methods inherited from class org.springframework.core.io.DefaultResourceLoader

getClassLoader, setClassLoader

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.context.ConfigurableApplicationContext

addApplicationListener, addBeanFactoryPostProcessor, close, getBeanFactory, getEnvironment, isActive, registerShutdownHook, 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

Methods inherited from interface org.springframework.beans.factory.support.BeanDefinitionRegistry

containsBeanDefinition, getBeanDefinitionCount, getBeanDefinitionNames

Methods inherited from interface org.springframework.core.AliasRegistry

getAliases

Constructor Detail

XmlEmbeddedWebApplicationContext

public XmlEmbeddedWebApplicationContext()

Create a new XmlEmbeddedWebApplicationContext that needs to be loaded and then manually refreshed.

XmlEmbeddedWebApplicationContext

public XmlEmbeddedWebApplicationContext(org.springframework.core.io.Resource... resources)

Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resources and automatically refreshing the context.

Parameters:

resources - the resources to load from

XmlEmbeddedWebApplicationContext

public XmlEmbeddedWebApplicationContext(String... resourceLocations)

Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resource locations and automatically refreshing the context.

Parameters:

resourceLocations - the resources to load from

XmlEmbeddedWebApplicationContext

public XmlEmbeddedWebApplicationContext(Class<?> relativeClass,
                                        String... resourceNames)

Create a new XmlEmbeddedWebApplicationContext, loading bean definitions from the given resource locations and automatically refreshing the context.

Parameters:

relativeClass - class whose package will be used as a prefix when loading each specified resource name

resourceNames - relatively-qualified names of resources to load

Method Detail

setValidating

public void setValidating(boolean validating)

Set whether to use XML validation. Default is true.

setEnvironment

public void setEnvironment(org.springframework.core.env.ConfigurableEnvironment environment)

Delegates the given environment to underlying XmlBeanDefinitionReader. Should be called before any call to load(org.springframework.core.io.Resource...).

Specified by:

setEnvironment in interface org.springframework.context.ConfigurableApplicationContext

Overrides:

setEnvironment in class org.springframework.context.support.AbstractApplicationContext

load

public final void load(org.springframework.core.io.Resource... resources)

Load bean definitions from the given XML resources.

Parameters:

resources - one or more resources to load from

load

public final void load(String... resourceLocations)

Load bean definitions from the given XML resources.

Parameters:

resourceLocations - one or more resource locations to load from

load

public final void load(Class<?> relativeClass,
                       String... resourceNames)

Load bean definitions from the given XML resources.

Parameters:

relativeClass - class whose package will be used as a prefix when loading each specified resource name

resourceNames - relatively-qualified names of resources to load

refresh

public final void refresh()
                   throws org.springframework.beans.BeansException,
                          IllegalStateException

Specified by:

refresh in interface org.springframework.context.ConfigurableApplicationContext

Overrides:

refresh in class org.springframework.context.support.AbstractApplicationContext

Throws:

org.springframework.beans.BeansException

IllegalStateException