org.springframework.data.gemfire.support

Class GemfireBeanFactoryLocator

java.lang.Object

org.springframework.data.gemfire.support.GemfireBeanFactoryLocator

All Implemented Interfaces:

Aware, BeanFactoryAware, BeanNameAware, DisposableBean, InitializingBean

public class GemfireBeanFactoryLocator
extends Object
implements BeanFactoryAware, BeanNameAware, DisposableBean, InitializingBean

The GemfireBeanFactoryLocator class stores a reference to the Spring ApplicationContext / BeanFactory needed to auto-wire user application GemFire objects implementing the Declarable interface and defined in GemFire's native configuration format (e.g. cache.xml. In most cases, a developer does not need to use this class directly as it is registered by the CacheFactoryBean when the useBeanFactoryLocator property is set, and used internally by bothe the WiringDeclarableSupport and LazyWiringDeclarableSupport SDG classes.

Author:

Costin Leau, John Blum

See Also:

LazyWiringDeclarableSupport, WiringDeclarableSupport

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	GemfireBeanFactoryLocator.BeanFactoryReference Reference holder storing a reference to a Spring BeanFactory.

Field Summary

Fields

Modifier and Type	Field and Description
protected static ConcurrentMap<String,BeanFactory>	BEAN_FACTORIES
protected org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor and Description
GemfireBeanFactoryLocator()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet()
static void	clear() Cleans up all BeanFactory references tracked by this locator.
void	destroy()
protected String	getAssociatedBeanName() Gets the name of the Spring bean associated with the Spring BeanFactory that possibly created the bean.
protected Set<String>	getAssociatedBeanNameWithAliases() Returns a Set of all names and aliases assigned to the Spring bean that is associated with the Spring BeanFactory.
protected BeanFactory	getBeanFactory() Returns a reference to the BeanFactory managed by this GemfireBeanFactoryLocator instance; Might be null if this GemfireBeanFactoryLocator is just used to lookup an existing BeanFactory reference.
static GemfireBeanFactoryLocator	newBeanFactoryLocator() Factory method to construct a new, initialized instance of GemfireBeanFactoryLocator.
static GemfireBeanFactoryLocator	newBeanFactoryLocator(BeanFactory beanFactory, String associatedBeanName) Factory method to construct a new, initialized instance of GemfireBeanFactoryLocator with the given default Spring BeanFactory and associated Spring bean name.
protected static void	registerAliases(Set<String> names, BeanFactory beanFactory) Registers all the provided names for given Spring BeanFactory.
protected static BeanFactory	resolveBeanFactory(String beanFactoryKey) Resolves the BeanFactory mapped to the given beanFactoryKey.
protected static BeanFactory	resolveSingleBeanFactory() Resolves a single Spring BeanFactory from the mapping of registered bean factories.
void	setBeanFactory(BeanFactory beanFactory)
void	setBeanName(String name)
protected static boolean	unregisterAliases(Set<String> names) Removes all Spring BeanFactory associations/mappings for the given Set of names.
BeanFactory	useBeanFactory() Attempts to use a single, existing Spring BeanFactory from the registry based on the setBeanName(String) beanName} property.
BeanFactory	useBeanFactory(String beanFactoryKey) Attempts to use the Spring BeanFactory idenified by the given beanFactoryKey.
GemfireBeanFactoryLocator	withBeanName(String beanName) Builder method to set the bean name used by this locator to lookup a Spring BeanFactory.

Methods inherited from class java.lang.Object

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

Field Detail

BEAN_FACTORIES

protected static final ConcurrentMap<String,BeanFactory> BEAN_FACTORIES

logger

protected final org.slf4j.Logger logger

Constructor Detail

GemfireBeanFactoryLocator

public GemfireBeanFactoryLocator()

Method Detail

clear

public static void clear()

Cleans up all BeanFactory references tracked by this locator.

newBeanFactoryLocator

public static GemfireBeanFactoryLocator newBeanFactoryLocator()

Factory method to construct a new, initialized instance of GemfireBeanFactoryLocator.

Returns:

a new, initialized instance of the GemfireBeanFactoryLocator.

See Also:

GemfireBeanFactoryLocator, GemfireBeanFactoryLocator(), afterPropertiesSet()

newBeanFactoryLocator

public static GemfireBeanFactoryLocator newBeanFactoryLocator(BeanFactory beanFactory,
                                                              String associatedBeanName)

Factory method to construct a new, initialized instance of GemfireBeanFactoryLocator with the given default Spring BeanFactory and associated Spring bean name.

Parameters:

beanFactory - reference to the BeanFactory used to resolve Spring bean references.

associatedBeanName - String contain the name of the Spring bean associated with the Spring BeanFactory.

Returns:

a new, initialized instance of GemfireBeanFactoryLocator with the given default Spring BeanFactory and associated Spring bean name.

See Also:

BeanFactory, GemfireBeanFactoryLocator, GemfireBeanFactoryLocator(), setBeanFactory(BeanFactory), setBeanName(String), afterPropertiesSet()

resolveBeanFactory

protected static BeanFactory resolveBeanFactory(String beanFactoryKey)

Resolves the BeanFactory mapped to the given beanFactoryKey.

Parameters:

beanFactoryKey - String value containing the key used to lookup the BeanFactory.

Returns:

the BeanFactory mapped to the given key.

Throws:

IllegalArgumentException - if a Spring BeanFactory could not be found for the given beanFactoryKey.

See Also:

BeanFactory

resolveSingleBeanFactory

protected static BeanFactory resolveSingleBeanFactory()

Resolves a single Spring BeanFactory from the mapping of registered bean factories. This class method is synchronized because it contains a "compound action", even though separate actions are performed on a ConcurrentMap, the actions are not independent and therefore must operate atomically.

Returns:

a single Spring BeanFactory from the registry.

Throws:

IllegalStateException - if the registry contains more than 1, or no Spring bean factories.

See Also:

BeanFactory

registerAliases

protected static void registerAliases(Set<String> names,
                                      BeanFactory beanFactory)

Registers all the provided names for given Spring BeanFactory.

Parameters:

names - Set of names and aliases to associate with the Spring BeanFactory.

beanFactory - reference to the Spring BeanFactory.

Throws:

IllegalArgumentException - if BeanFactory is null.

IllegalStateException - if one of the provided names is already associated with an existing, other than given, Spring BeanFactory.

See Also:

BeanFactory, BeanFactory

unregisterAliases

protected static boolean unregisterAliases(Set<String> names)

Removes all Spring BeanFactory associations/mappings for the given Set of names.

Parameters:

names - Set of names identifying the associations/mappings to remove.

Returns:

a boolean value indicating whether all associations/mappings were removed successfully.

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface InitializingBean

destroy

public void destroy()

Specified by:

destroy in interface DisposableBean

useBeanFactory

public BeanFactory useBeanFactory()

Attempts to use a single, existing Spring BeanFactory from the registry based on the setBeanName(String) beanName} property.

Returns:

the single Spring BeanFactory from the registry.

Throws:

IllegalArgumentException - if more than Spring BeanFactory is registered.

IllegalStateException - if the BeanFactory with the associated beanName is not found.

See Also:

BeanFactory, getAssociatedBeanName(), useBeanFactory(String)

useBeanFactory

public BeanFactory useBeanFactory(String beanFactoryKey)

Attempts to use the Spring BeanFactory idenified by the given beanFactoryKey.

Parameters:

beanFactoryKey - String containing the key used to lookup the Spring BeanFactory.

Returns:

the Spring BeanFactory for the given beanFactoryKey.

Throws:

IllegalArgumentException - if a Spring BeanFactory could not be found for beanFactoryKey.

IllegalStateException - if useBeanFactoryLocator was not configured.

See Also:

BeanFactory, GemfireBeanFactoryLocator.BeanFactoryReference.newBeanFactoryReference(BeanFactory), resolveBeanFactory(String), resolveSingleBeanFactory()

setBeanFactory

public void setBeanFactory(BeanFactory beanFactory)

Specified by:

setBeanFactory in interface BeanFactoryAware

getBeanFactory

protected BeanFactory getBeanFactory()

Returns a reference to the BeanFactory managed by this GemfireBeanFactoryLocator instance; Might be null if this GemfireBeanFactoryLocator is just used to lookup an existing BeanFactory reference.

Returns:

the managed BeanFactory reference.

See Also:

BeanFactory

setBeanName

public void setBeanName(String name)

Specified by:

setBeanName in interface BeanNameAware

getAssociatedBeanName

protected String getAssociatedBeanName()

Gets the name of the Spring bean associated with the Spring BeanFactory that possibly created the bean.

Returns:

a String containing the name of the Spring bean associated with the Spring BeanFactory.

See Also:

setBeanFactory(BeanFactory)

getAssociatedBeanNameWithAliases

protected Set<String> getAssociatedBeanNameWithAliases()

Returns a Set of all names and aliases assigned to the Spring bean that is associated with the Spring BeanFactory.

Returns:

a Set containing all the names and aliases assigned to the Spring bean associated with the Spring BeanFactory.

See Also:

setBeanName(String)

withBeanName

public GemfireBeanFactoryLocator withBeanName(String beanName)

Builder method to set the bean name used by this locator to lookup a Spring BeanFactory.

Parameters:

beanName - String containing the bean name to set on this locator.

Returns:

this GemfireBeanFactoryLocator.

See Also:

setBeanName(String)