public class ClassPathXmlApplicationContext extends AbstractXmlApplicationContext
The config location defaults can be overridden via AbstractRefreshableConfigApplicationContext.getConfigLocations()
,
Config locations can either denote concrete files like "/myfiles/context.xml"
or Ant-style patterns like "/myfiles/*-context.xml" (see the
AntPathMatcher
javadoc for pattern details).
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.
This is a simple, one-stop shop convenience ApplicationContext.
Consider using the GenericApplicationContext
class in combination
with an XmlBeanDefinitionReader
for more flexible context setup.
DefaultResourceLoader.getResource(java.lang.String)
,
DefaultResourceLoader.getResourceByPath(java.lang.String)
,
GenericApplicationContext
DefaultResourceLoader.ClassPathContextResource
Modifier and Type | Field and Description |
---|---|
private Resource[] |
configResources |
APPLICATION_EVENT_MULTICASTER_BEAN_NAME, LIFECYCLE_PROCESSOR_BEAN_NAME, logger, MESSAGE_SOURCE_BEAN_NAME
CONFIG_LOCATION_DELIMITERS, CONVERSION_SERVICE_BEAN_NAME, ENVIRONMENT_BEAN_NAME, LOAD_TIME_WEAVER_BEAN_NAME, SYSTEM_ENVIRONMENT_BEAN_NAME, SYSTEM_PROPERTIES_BEAN_NAME
FACTORY_BEAN_PREFIX
CLASSPATH_ALL_URL_PREFIX
CLASSPATH_URL_PREFIX
Constructor and Description |
---|
ClassPathXmlApplicationContext()
Create a new ClassPathXmlApplicationContext for bean-style configuration.
|
ClassPathXmlApplicationContext(ApplicationContext parent)
Create a new ClassPathXmlApplicationContext for bean-style configuration.
|
ClassPathXmlApplicationContext(java.lang.String... configLocations)
Create a new ClassPathXmlApplicationContext, loading the definitions
from the given XML files and automatically refreshing the context.
|
ClassPathXmlApplicationContext(java.lang.String configLocation)
Create a new ClassPathXmlApplicationContext, loading the definitions
from the given XML file and automatically refreshing the context.
|
ClassPathXmlApplicationContext(java.lang.String[] configLocations,
ApplicationContext parent)
Create a new ClassPathXmlApplicationContext with the given parent,
loading the definitions from the given XML files and automatically
refreshing the context.
|
ClassPathXmlApplicationContext(java.lang.String[] configLocations,
boolean refresh)
Create a new ClassPathXmlApplicationContext, loading the definitions
from the given XML files.
|
ClassPathXmlApplicationContext(java.lang.String[] configLocations,
boolean refresh,
ApplicationContext parent)
Create a new ClassPathXmlApplicationContext with the given parent,
loading the definitions from the given XML files.
|
ClassPathXmlApplicationContext(java.lang.String[] paths,
java.lang.Class<?> clazz)
Create a new ClassPathXmlApplicationContext, loading the definitions
from the given XML files and automatically refreshing the context.
|
ClassPathXmlApplicationContext(java.lang.String[] paths,
java.lang.Class<?> clazz,
ApplicationContext parent)
Create a new ClassPathXmlApplicationContext with the given parent,
loading the definitions from the given XML files and automatically
refreshing the context.
|
ClassPathXmlApplicationContext(java.lang.String path,
java.lang.Class<?> clazz)
Create a new ClassPathXmlApplicationContext, loading the definitions
from the given XML file and automatically refreshing the context.
|
Modifier and Type | Method and Description |
---|---|
protected Resource[] |
getConfigResources()
Return an array of Resource objects, referring to the XML bean definition
files that this context should be built with.
|
initBeanDefinitionReader, loadBeanDefinitions, loadBeanDefinitions, setValidating
afterPropertiesSet, getConfigLocations, getDefaultConfigLocations, resolvePath, setBeanName, setConfigLocation, setConfigLocations, setId
assertBeanFactoryActive, cancelRefresh, closeBeanFactory, createBeanFactory, customizeBeanFactory, getBeanFactory, hasBeanFactory, refreshBeanFactory, setAllowBeanDefinitionOverriding, setAllowCircularReferences
addApplicationListener, addBeanFactoryPostProcessor, close, containsBean, containsBeanDefinition, containsLocalBean, createEnvironment, destroy, destroyBeans, doClose, findAnnotationOnBean, finishBeanFactoryInitialization, finishRefresh, getAliases, getApplicationEventMulticaster, getApplicationListeners, getApplicationName, getAutowireCapableBeanFactory, getBean, getBean, getBean, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanFactoryPostProcessors, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getDisplayName, getEnvironment, getId, getInternalParentBeanFactory, getInternalParentMessageSource, getLifecycleProcessor, getMessage, getMessage, getMessage, getParent, getParentBeanFactory, getResourcePatternResolver, getResources, getStartupDate, getType, initApplicationEventMulticaster, initLifecycleProcessor, initMessageSource, initPropertySources, invokeBeanFactoryPostProcessors, isActive, isPrototype, isRunning, isSingleton, isTypeMatch, isTypeMatch, obtainFreshBeanFactory, onClose, onRefresh, postProcessBeanFactory, prepareBeanFactory, prepareRefresh, publishEvent, publishEvent, publishEvent, refresh, registerBeanPostProcessors, registerListeners, registerShutdownHook, resetCommonCaches, setDisplayName, setEnvironment, setParent, start, stop, toString
getClassLoader, getResource, getResourceByPath, setClassLoader
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getClassLoader, getResource
private Resource[] configResources
public ClassPathXmlApplicationContext()
public ClassPathXmlApplicationContext(ApplicationContext parent)
public ClassPathXmlApplicationContext(java.lang.String configLocation) throws BeansException
configLocation
- resource locationBeansException
- if context creation failedpublic ClassPathXmlApplicationContext(java.lang.String... configLocations) throws BeansException
configLocations
- array of resource locationsBeansException
- if context creation failedpublic ClassPathXmlApplicationContext(java.lang.String[] configLocations, ApplicationContext parent) throws BeansException
configLocations
- array of resource locationsparent
- the parent contextBeansException
- if context creation failedpublic ClassPathXmlApplicationContext(java.lang.String[] configLocations, boolean refresh) throws BeansException
configLocations
- array of resource locationsrefresh
- whether to automatically refresh the context,
loading all bean definitions and creating all singletons.
Alternatively, call refresh manually after further configuring the context.BeansException
- if context creation failedAbstractApplicationContext.refresh()
public ClassPathXmlApplicationContext(java.lang.String[] configLocations, boolean refresh, ApplicationContext parent) throws BeansException
configLocations
- array of resource locationsrefresh
- whether to automatically refresh the context,
loading all bean definitions and creating all singletons.
Alternatively, call refresh manually after further configuring the context.parent
- the parent contextBeansException
- if context creation failedAbstractApplicationContext.refresh()
public ClassPathXmlApplicationContext(java.lang.String path, java.lang.Class<?> clazz) throws BeansException
This is a convenience method to load class path resources relative to a given Class. For full flexibility, consider using a GenericApplicationContext with an XmlBeanDefinitionReader and a ClassPathResource argument.
path
- relative (or absolute) path within the class pathclazz
- the class to load resources with (basis for the given paths)BeansException
- if context creation failedClassPathResource.ClassPathResource(String, Class)
,
GenericApplicationContext
,
XmlBeanDefinitionReader
public ClassPathXmlApplicationContext(java.lang.String[] paths, java.lang.Class<?> clazz) throws BeansException
paths
- array of relative (or absolute) paths within the class pathclazz
- the class to load resources with (basis for the given paths)BeansException
- if context creation failedClassPathResource.ClassPathResource(String, Class)
,
GenericApplicationContext
,
XmlBeanDefinitionReader
public ClassPathXmlApplicationContext(java.lang.String[] paths, java.lang.Class<?> clazz, ApplicationContext parent) throws BeansException
paths
- array of relative (or absolute) paths within the class pathclazz
- the class to load resources with (basis for the given paths)parent
- the parent contextBeansException
- if context creation failedClassPathResource.ClassPathResource(String, Class)
,
GenericApplicationContext
,
XmlBeanDefinitionReader
protected Resource[] getConfigResources()
AbstractXmlApplicationContext
The default implementation returns null
. Subclasses can override
this to provide pre-built Resource objects rather than location Strings.
getConfigResources
in class AbstractXmlApplicationContext
null
if noneAbstractRefreshableConfigApplicationContext.getConfigLocations()