org.springframework.beans.factory.support

Class AbstractBeanDefinitionReader

java.lang.Object

org.springframework.beans.factory.support.AbstractBeanDefinitionReader

All Implemented Interfaces:

BeanDefinitionReader, EnvironmentCapable

Direct Known Subclasses:

GroovyBeanDefinitionReader, PropertiesBeanDefinitionReader, XmlBeanDefinitionReader

public abstract class AbstractBeanDefinitionReader
extends java.lang.Object
implements EnvironmentCapable, BeanDefinitionReader

Abstract base class for bean definition readers which implement the BeanDefinitionReader interface.

Provides common properties like the bean factory to work on and the class loader to use for loading bean classes.

Since:

11.12.2003

Author:

Juergen Hoeller, Chris Beams

See Also:

BeanDefinitionReaderUtils

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.ClassLoader	beanClassLoader
private BeanNameGenerator	beanNameGenerator
private Environment	environment
protected Log	logger Logger available to subclasses
private BeanDefinitionRegistry	registry
private ResourceLoader	resourceLoader

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractBeanDefinitionReader(BeanDefinitionRegistry registry) Create a new AbstractBeanDefinitionReader for the given bean factory.

Method Summary

Modifier and Type	Method and Description
java.lang.ClassLoader	getBeanClassLoader() Return the class loader to use for bean classes.
BeanDefinitionRegistry	getBeanFactory()
BeanNameGenerator	getBeanNameGenerator() Return the BeanNameGenerator to use for anonymous beans (without explicit bean name specified).
Environment	getEnvironment() Return the Environment associated with this component.
BeanDefinitionRegistry	getRegistry() Return the bean factory to register the bean definitions with.
ResourceLoader	getResourceLoader() Return the resource loader to use for resource locations.
int	loadBeanDefinitions(Resource... resources) Load bean definitions from the specified resources.
int	loadBeanDefinitions(java.lang.String... locations) Load bean definitions from the specified resource locations.
int	loadBeanDefinitions(java.lang.String location) Load bean definitions from the specified resource location.
int	loadBeanDefinitions(java.lang.String location, java.util.Set<Resource> actualResources) Load bean definitions from the specified resource location.
void	setBeanClassLoader(java.lang.ClassLoader beanClassLoader) Set the ClassLoader to use for bean classes.
void	setBeanNameGenerator(BeanNameGenerator beanNameGenerator) Set the BeanNameGenerator to use for anonymous beans (without explicit bean name specified).
void	setEnvironment(Environment environment) Set the Environment to use when reading bean definitions.
void	setResourceLoader(ResourceLoader resourceLoader) Set the ResourceLoader to use for resource locations.

Methods inherited from class java.lang.Object

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

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

loadBeanDefinitions

Field Detail

logger

protected final Log logger

Logger available to subclasses

registry

private final BeanDefinitionRegistry registry

resourceLoader

private ResourceLoader resourceLoader

beanClassLoader

private java.lang.ClassLoader beanClassLoader

environment

private Environment environment

beanNameGenerator

private BeanNameGenerator beanNameGenerator

Constructor Detail

AbstractBeanDefinitionReader

protected AbstractBeanDefinitionReader(BeanDefinitionRegistry registry)

Create a new AbstractBeanDefinitionReader for the given bean factory.

If the passed-in bean factory does not only implement the BeanDefinitionRegistry interface but also the ResourceLoader interface, it will be used as default ResourceLoader as well. This will usually be the case for ApplicationContext implementations.

If given a plain BeanDefinitionRegistry, the default ResourceLoader will be a PathMatchingResourcePatternResolver.

If the the passed-in bean factory also implements EnvironmentCapable its environment will be used by this reader. Otherwise, the reader will initialize and use a StandardEnvironment. All ApplicationContext implementations are EnvironmentCapable, while normal BeanFactory implementations are not.

Parameters:

registry - the BeanFactory to load bean definitions into, in the form of a BeanDefinitionRegistry

See Also:

setResourceLoader(org.springframework.core.io.ResourceLoader), setEnvironment(org.springframework.core.env.Environment)

Method Detail

getBeanFactory

public final BeanDefinitionRegistry getBeanFactory()

getRegistry

public final BeanDefinitionRegistry getRegistry()

Description copied from interface: BeanDefinitionReader

Return the bean factory to register the bean definitions with.

The factory is exposed through the BeanDefinitionRegistry interface, encapsulating the methods that are relevant for bean definition handling.

Specified by:

getRegistry in interface BeanDefinitionReader

setResourceLoader

public void setResourceLoader(ResourceLoader resourceLoader)

Set the ResourceLoader to use for resource locations. If specifying a ResourcePatternResolver, the bean definition reader will be capable of resolving resource patterns to Resource arrays.

Default is PathMatchingResourcePatternResolver, also capable of resource pattern resolving through the ResourcePatternResolver interface.

Setting this to null suggests that absolute resource loading is not available for this bean definition reader.

See Also:

ResourcePatternResolver, PathMatchingResourcePatternResolver

getResourceLoader

public ResourceLoader getResourceLoader()

Description copied from interface: BeanDefinitionReader

Return the resource loader to use for resource locations. Can be checked for the ResourcePatternResolver interface and cast accordingly, for loading multiple resources for a given resource pattern.

Null suggests that absolute resource loading is not available for this bean definition reader.

This is mainly meant to be used for importing further resources from within a bean definition resource, for example via the "import" tag in XML bean definitions. It is recommended, however, to apply such imports relative to the defining resource; only explicit full resource locations will trigger absolute resource loading.

There is also a loadBeanDefinitions(String) method available, for loading bean definitions from a resource location (or location pattern). This is a convenience to avoid explicit ResourceLoader handling.

Specified by:

getResourceLoader in interface BeanDefinitionReader

See Also:

BeanDefinitionReader.loadBeanDefinitions(String), ResourcePatternResolver

setBeanClassLoader

public void setBeanClassLoader(java.lang.ClassLoader beanClassLoader)

Set the ClassLoader to use for bean classes.

Default is null, which suggests to not load bean classes eagerly but rather to just register bean definitions with class names, with the corresponding Classes to be resolved later (or never).

See Also:

Thread.getContextClassLoader()

getBeanClassLoader

public java.lang.ClassLoader getBeanClassLoader()

Description copied from interface: BeanDefinitionReader

Return the class loader to use for bean classes.

null suggests to not load bean classes eagerly but rather to just register bean definitions with class names, with the corresponding Classes to be resolved later (or never).

Specified by:

getBeanClassLoader in interface BeanDefinitionReader

setEnvironment

public void setEnvironment(Environment environment)

Set the Environment to use when reading bean definitions. Most often used for evaluating profile information to determine which bean definitions should be read and which should be omitted.

getEnvironment

public Environment getEnvironment()

Description copied from interface: EnvironmentCapable

Return the Environment associated with this component.

Specified by:

getEnvironment in interface EnvironmentCapable

setBeanNameGenerator

public void setBeanNameGenerator(BeanNameGenerator beanNameGenerator)

Set the BeanNameGenerator to use for anonymous beans (without explicit bean name specified).

Default is a DefaultBeanNameGenerator.

getBeanNameGenerator

public BeanNameGenerator getBeanNameGenerator()

Description copied from interface: BeanDefinitionReader

Return the BeanNameGenerator to use for anonymous beans (without explicit bean name specified).

Specified by:

getBeanNameGenerator in interface BeanDefinitionReader

loadBeanDefinitions

public int loadBeanDefinitions(Resource... resources)
                        throws BeanDefinitionStoreException

Description copied from interface: BeanDefinitionReader

Load bean definitions from the specified resources.

Specified by:

loadBeanDefinitions in interface BeanDefinitionReader

Parameters:

resources - the resource descriptors

Returns:

the number of bean definitions found

Throws:

BeanDefinitionStoreException - in case of loading or parsing errors

loadBeanDefinitions

public int loadBeanDefinitions(java.lang.String location)
                        throws BeanDefinitionStoreException

Description copied from interface: BeanDefinitionReader

Load bean definitions from the specified resource location.

The location can also be a location pattern, provided that the ResourceLoader of this bean definition reader is a ResourcePatternResolver.

Specified by:

loadBeanDefinitions in interface BeanDefinitionReader

Parameters:

location - the resource location, to be loaded with the ResourceLoader (or ResourcePatternResolver) of this bean definition reader

Returns:

the number of bean definitions found

Throws:

BeanDefinitionStoreException - in case of loading or parsing errors

See Also:

BeanDefinitionReader.getResourceLoader(), BeanDefinitionReader.loadBeanDefinitions(org.springframework.core.io.Resource), BeanDefinitionReader.loadBeanDefinitions(org.springframework.core.io.Resource[])

loadBeanDefinitions

public int loadBeanDefinitions(java.lang.String location,
                               java.util.Set<Resource> actualResources)
                        throws BeanDefinitionStoreException

Load bean definitions from the specified resource location.

The location can also be a location pattern, provided that the ResourceLoader of this bean definition reader is a ResourcePatternResolver.

Parameters:

location - the resource location, to be loaded with the ResourceLoader (or ResourcePatternResolver) of this bean definition reader

actualResources - a Set to be filled with the actual Resource objects that have been resolved during the loading process. May be null to indicate that the caller is not interested in those Resource objects.

Returns:

the number of bean definitions found

Throws:

BeanDefinitionStoreException - in case of loading or parsing errors

See Also:

getResourceLoader(), BeanDefinitionReader.loadBeanDefinitions(org.springframework.core.io.Resource), loadBeanDefinitions(org.springframework.core.io.Resource[])

loadBeanDefinitions

public int loadBeanDefinitions(java.lang.String... locations)
                        throws BeanDefinitionStoreException

Description copied from interface: BeanDefinitionReader

Load bean definitions from the specified resource locations.

Specified by:

loadBeanDefinitions in interface BeanDefinitionReader

Parameters:

locations - the resource locations, to be loaded with the ResourceLoader (or ResourcePatternResolver) of this bean definition reader

Returns:

the number of bean definitions found

Throws:

BeanDefinitionStoreException - in case of loading or parsing errors