|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.core.io.DefaultResourceLoader org.springframework.context.support.AbstractApplicationContext org.springframework.context.support.AbstractRefreshableApplicationContext org.springframework.context.support.AbstractXmlApplicationContext org.springframework.context.support.FileSystemXmlApplicationContext
public class FileSystemXmlApplicationContext
Standalone XML application context, taking the context definition files from the file system or from URLs, interpreting plain paths as relative file system locations (e.g. "mydir/myfile.txt"). Useful for test harnesses as well as for standalone environments.
NOTE: Plain paths will always be interpreted as relative to the current VM working directory, even if they start with a slash. (This is consistent with the semantics in a Servlet container.) Use an explicit "file:" prefix to enforce an absolute file path.
The config location defaults can be overridden via 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)
,
getResourceByPath(java.lang.String)
,
GenericApplicationContext
Field Summary |
---|
Fields inherited from class org.springframework.context.support.AbstractApplicationContext |
---|
APPLICATION_EVENT_MULTICASTER_BEAN_NAME, logger, MESSAGE_SOURCE_BEAN_NAME |
Fields inherited from interface org.springframework.beans.factory.BeanFactory |
---|
FACTORY_BEAN_PREFIX |
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 | |
---|---|
FileSystemXmlApplicationContext(String configLocation)
Create a new FileSystemXmlApplicationContext, loading the definitions from the given XML file and automatically refreshing the context. |
|
FileSystemXmlApplicationContext(String[] configLocations)
Create a new FileSystemXmlApplicationContext, loading the definitions from the given XML files and automatically refreshing the context. |
|
FileSystemXmlApplicationContext(String[] configLocations,
ApplicationContext parent)
Create a new FileSystemXmlApplicationContext with the given parent, loading the definitions from the given XML files and automatically refreshing the context. |
|
FileSystemXmlApplicationContext(String[] configLocations,
boolean refresh)
Create a new FileSystemXmlApplicationContext, loading the definitions from the given XML files. |
|
FileSystemXmlApplicationContext(String[] configLocations,
boolean refresh,
ApplicationContext parent)
Create a new FileSystemXmlApplicationContext with the given parent, loading the definitions from the given XML files. |
Method Summary | |
---|---|
protected String[] |
getConfigLocations()
Return an array of resource locations, referring to the XML bean definition files that this context should be built with. |
protected Resource |
getResourceByPath(String path)
Resolve resource paths as file system paths. |
Methods inherited from class org.springframework.context.support.AbstractXmlApplicationContext |
---|
getConfigResources, initBeanDefinitionReader, loadBeanDefinitions, loadBeanDefinitions |
Methods inherited from class org.springframework.context.support.AbstractRefreshableApplicationContext |
---|
closeBeanFactory, createBeanFactory, customizeBeanFactory, getBeanFactory, refreshBeanFactory |
Methods inherited from class org.springframework.core.io.DefaultResourceLoader |
---|
getClassLoader, getResource, setClassLoader |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.springframework.core.io.ResourceLoader |
---|
getClassLoader, getResource |
Constructor Detail |
---|
public FileSystemXmlApplicationContext(String configLocation) throws BeansException
configLocation
- file path
BeansException
- if context creation failedpublic FileSystemXmlApplicationContext(String[] configLocations) throws BeansException
configLocations
- array of file paths
BeansException
- if context creation failedpublic FileSystemXmlApplicationContext(String[] configLocations, ApplicationContext parent) throws BeansException
configLocations
- array of file pathsparent
- the parent context
BeansException
- if context creation failedpublic FileSystemXmlApplicationContext(String[] configLocations, boolean refresh) throws BeansException
configLocations
- array of file pathsrefresh
- 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 FileSystemXmlApplicationContext(String[] configLocations, boolean refresh, ApplicationContext parent) throws BeansException
configLocations
- array of file pathsrefresh
- 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 context
BeansException
- if context creation failedAbstractApplicationContext.refresh()
Method Detail |
---|
protected String[] getConfigLocations()
AbstractXmlApplicationContext
The default implementation returns null
. Subclasses can override
this to provide a set of resource locations to load bean definitions from.
getConfigLocations
in class AbstractXmlApplicationContext
null
if noneAbstractApplicationContext.getResources(java.lang.String)
,
AbstractApplicationContext.getResourcePatternResolver()
protected Resource getResourceByPath(String path)
Note: Even if a given path starts with a slash, it will get interpreted as relative to the current VM working directory. This is consistent with the semantics in a Servlet container.
getResourceByPath
in class DefaultResourceLoader
path
- path to the resource
AbstractRefreshableWebApplicationContext.getResourceByPath(java.lang.String)
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |