org.springframework.boot.context.embedded

Class XmlEmbeddedWebApplicationContext

java.lang.Object

GenericWebApplicationContext

org.springframework.boot.context.embedded.EmbeddedWebApplicationContext

org.springframework.boot.context.embedded.XmlEmbeddedWebApplicationContext

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), #setConfigLocations, EmbeddedWebApplicationContext, XmlWebApplicationContext

Field Summary

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

DISPATCHER_SERVLET_NAME

Constructor Summary

Constructors

Constructor and Description
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

Methods

Modifier and Type	Method and Description
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	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, refresh, setNamespace, setServletConfig

Methods inherited from class java.lang.Object

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

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...).

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