org.springframework.context.support
Class ClassPathXmlApplicationContext

java.lang.Object
  org.springframework.core.io.DefaultResourceLoader
      org.springframework.context.support.AbstractApplicationContext
          org.springframework.context.support.AbstractXmlApplicationContext
              org.springframework.context.support.ClassPathXmlApplicationContext

All Implemented Interfaces:

ApplicationContext, BeanFactory, ConfigurableApplicationContext, HierarchicalBeanFactory, ListableBeanFactory, MessageSource, ResourceLoader

public class ClassPathXmlApplicationContext

extends AbstractXmlApplicationContext

Standalone XML application context, taking the context definition files from the class path. Mainly useful for test harnesses, but also for application contexts embedded within JARs.

Treats resource paths as class path resources, when using ApplicationContext.getResource. Only supports full classpath resource names that include the package path, like "mypackage/myresource.dat".

The config location defaults can be overridden via setConfigLocations, respectively via the "contextConfigLocation" parameters of ContextLoader and FrameworkServlet. Config locations can either denote concrete files like "/mypackage/context.xml" or Ant-style patterns like "/mypackage/*-context.xml" (see PathMatcher 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.

Version:

$Id: ClassPathXmlApplicationContext.java,v 1.12 2004/04/05 07:18:42 jhoeller Exp $

Author:

Rod Johnson, Juergen Hoeller

See Also:

DefaultResourceLoader.getResource(java.lang.String), DefaultResourceLoader.getResourceByPath(java.lang.String)

Field Summary

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

logger, MESSAGE_SOURCE_BEAN_NAME

Fields inherited from interface org.springframework.core.io.ResourceLoader

CLASSPATH_URL_PREFIX

Constructor Summary

ClassPathXmlApplicationContext(java.lang.String configLocation)
Create a new ClassPathXmlApplicationContext, loading the definitions from the given XML file.

ClassPathXmlApplicationContext(java.lang.String[] configLocations)
Create a new ClassPathXmlApplicationContext, loading the definitions from the given XML files.

ClassPathXmlApplicationContext(java.lang.String[] configLocations, ApplicationContext parent)
Create a new ClassPathXmlApplicationContext with the given parent, loading the definitions from the given XML files.

Method Summary

protected java.lang.String[]

getConfigLocations() Return an array of resource locations, referring to the XML bean definition files that this context should be built with.

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

createBeanFactory, getBeanFactory, initBeanDefinitionReader, loadBeanDefinitions, refreshBeanFactory

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

addBeanFactoryPostProcessor, addListener, close, containsBean, containsBeanDefinition, getAliases, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanDefinitionNames, getBeanFactoryPostProcessors, getBeansOfType, getDisplayName, getInternalParentBeanFactory, getMessage, getMessage, getMessage, getParent, getParentBeanFactory, getStartupDate, isSingleton, onRefresh, postProcessBeanFactory, publishEvent, refresh, resolveConfigLocations, setDisplayName, setParent, toString

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

getResource, getResourceByPath

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

getResource

Constructor Detail

ClassPathXmlApplicationContext

public ClassPathXmlApplicationContext(java.lang.String configLocation)
                               throws BeansException

Create a new ClassPathXmlApplicationContext, loading the definitions from the given XML file.

Parameters:

configLocation - file path

ClassPathXmlApplicationContext

public ClassPathXmlApplicationContext(java.lang.String[] configLocations)
                               throws BeansException

Create a new ClassPathXmlApplicationContext, loading the definitions from the given XML files.

Parameters:

configLocations - array of file paths

ClassPathXmlApplicationContext

public ClassPathXmlApplicationContext(java.lang.String[] configLocations,
                                      ApplicationContext parent)
                               throws BeansException

Create a new ClassPathXmlApplicationContext with the given parent, loading the definitions from the given XML files.

Parameters:

configLocations - array of file paths

parent - the parent context

Method Detail

getConfigLocations

protected java.lang.String[] getConfigLocations()

Description copied from class: AbstractXmlApplicationContext

Return an array of resource locations, referring to the XML bean definition files that this context should be built with.

Specified by:

getConfigLocations in class AbstractXmlApplicationContext

Returns:

an array of resource locations, or null if none