Package org.springframework.data.gemfire

Class ResolvableRegionFactoryBean<K,V>

java.lang.Object

org.springframework.data.gemfire.support.AbstractFactoryBeanSupport<Region<K,V>>

org.springframework.data.gemfire.ResolvableRegionFactoryBean<K,V>

All Implemented Interfaces:

Aware, BeanClassLoaderAware, BeanFactoryAware, BeanNameAware, FactoryBean<Region<K,V>>, InitializingBean

Direct Known Subclasses:

CacheTypeAwareRegionFactoryBean, ConfigurableRegionFactoryBean, LookupRegionFactoryBean

public abstract class ResolvableRegionFactoryBean<K,V>
extends AbstractFactoryBeanSupport<Region<K,V>>
implements InitializingBean

Spring FactoryBean for looking up Regions. If lookups are disabled or the Region does not exist, an exception is thrown. For declaring and configuring new Regions, see PeerRegionFactoryBean.

Author:

Costin Leau, John Blum

See Also:

• GemFireCache
• Region
• FactoryBean
• InitializingBean
• AbstractFactoryBeanSupport

Field Summary

Fields inherited from class org.springframework.data.gemfire.support.AbstractFactoryBeanSupport

DEFAULT_SINGLETON

Fields inherited from interface org.springframework.beans.factory.FactoryBean

OBJECT_TYPE_ATTRIBUTE

Constructor Summary

Constructors

Constructor	Description
ResolvableRegionFactoryBean()

Method Summary

Modifier and Type	Method	Description
void	afterPropertiesSet()	Initializes this ResolvableRegionFactoryBean after properties have been set by the Spring container.
protected Region<K,V>	createRegion(GemFireCache cache, String regionName)	Creates a new Region with the given name.
GemFireCache	getCache()	Returns a reference to the GemFireCache used to create the Region.
Boolean	getLookupEnabled()
Region<K,V>	getObject()	Returns an object reference to the Region created by this ResolvableRegionFactoryBean.
Class<?>	getObjectType()	Returns the Class type of the Region produced by this ResolvableRegionFactoryBean.
protected Region<?,?>	getParent()	Returns a reference to the parent Region indicating this FactoryBean represents a GemFire cache Sub-Region.
Region<K,V>	getRegion()	Returns a reference to the Region resolved by this Spring FactoryBean during the lookup operation; maybe a new Region.
boolean	isLookupEnabled()
protected Region<K,V>	loadSnapshot(Region<K,V> region)	Loads the configured data snapshot into the given Region.
protected Region<K,V>	postProcess(Region<K,V> region)	Post-process the Region created by this PeerRegionFactoryBean.
String	resolveRegionName()	Resolves the name of the Region.
void	setCache(GemFireCache cache)	Sets a reference to the GemFireCache used to create the Region.
void	setLookupEnabled(Boolean lookupEnabled)
void	setName(String name)	Sets the name of the cache Region based on the bean 'name' attribute.
void	setParent(Region<?,?> parent)	Sets a reference to the parent Region to indicated this FactoryBean represents a GemFire cache Sub-Region.
protected void	setRegion(Region<K,V> region)	Sets a reference to the Region to be resolved by this Spring FactoryBean.
void	setRegionName(String regionName)	Sets the name of the cache Region.
void	setSnapshot(Resource snapshot)	Sets the snapshots used for loading a newly created region.

Methods inherited from class org.springframework.data.gemfire.support.AbstractFactoryBeanSupport

getBeanClassLoader, getBeanFactory, getBeanName, getLog, getOptionalLog, isDebugLoggingEnabled, isErrorLoggingEnabled, isInfoLoggingEnabled, isSingleton, isWarnLoggingEnabled, logDebug, logDebug, logError, logError, logInfo, logInfo, logWarning, logWarning, newLog, setBeanClassLoader, setBeanFactory, setBeanName

Methods inherited from class java.lang.Object

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

Constructor Details

ResolvableRegionFactoryBean

public ResolvableRegionFactoryBean()

Method Details

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Initializes this ResolvableRegionFactoryBean after properties have been set by the Spring container.

Specified by:

afterPropertiesSet in interface InitializingBean

Throws:

Exception - if initialization fails.

See Also:

• InitializingBean.afterPropertiesSet()
• createRegion(GemFireCache, String)

resolveRegionName

public String resolveRegionName()

Resolves the name of the Region.

Returns:

a String containing the name of the Region.

See Also:

• Region.getName()

createRegion

protected Region<K,V> createRegion(GemFireCache cache,
 String regionName)
                            throws Exception

Creates a new Region with the given name. This method gets called when a Region with the specified name does not already exist. By default, this method implementation throws a BeanInitializationException and it is expected that subclasses will override this method.

Parameters:

cache - reference to the GemFireCache.

regionName - name of the new Region.

Returns:

a new Region with the given name.

Throws:

BeanInitializationException - by default unless a subclass overrides this method.

Exception

See Also:

• GemFireCache
• Region

loadSnapshot

protected Region<K,V> loadSnapshot(Region<K,V> region)

Loads the configured data snapshot into the given Region.

Parameters:

region - Region to load.

Returns:

the given Region.

Throws:

RuntimeException - if the snapshot load fails.

See Also:

• Region.loadSnapshot(InputStream)

postProcess

protected Region<K,V> postProcess(Region<K,V> region)

Post-process the Region created by this PeerRegionFactoryBean.

Parameters:

region - Region to process.

See Also:

• Region

getObject

public Region<K,V> getObject()
                      throws Exception

Returns an object reference to the Region created by this ResolvableRegionFactoryBean.

Specified by:

getObject in interface FactoryBean<K>

Returns:

an object reference to the Region created by this ResolvableRegionFactoryBean.

Throws:

Exception

See Also:

• FactoryBean.getObject()
• Region
• getRegion()

getObjectType

public Class<?> getObjectType()

Returns the Class type of the Region produced by this ResolvableRegionFactoryBean.

Specified by:

getObjectType in interface FactoryBean<K>

Returns:

the Class type of the Region produced by this ResolvableRegionFactoryBean.

See Also:

• FactoryBean.getObjectType()

getCache

public GemFireCache getCache()

Returns a reference to the GemFireCache used to create the Region.

Returns:

a reference to the GemFireCache used to create the Region..

See Also:

• GemFireCache

setCache

public void setCache(GemFireCache cache)

Sets a reference to the GemFireCache used to create the Region.

Parameters:

cache - reference to the GemFireCache.

See Also:

• GemFireCache

isLookupEnabled

public boolean isLookupEnabled()

setLookupEnabled

public void setLookupEnabled(Boolean lookupEnabled)

getLookupEnabled

public Boolean getLookupEnabled()

setName

public void setName(String name)

Sets the name of the cache Region based on the bean 'name' attribute. If no Region is found with the given name, a new one will be created. If no name is given, the value of the 'beanName' property will be used.

Parameters:

name - Region name.

See Also:

• AbstractFactoryBeanSupport.setBeanName(String)
• Region.getFullPath()

setParent

public void setParent(Region<?,?> parent)

Sets a reference to the parent Region to indicated this FactoryBean represents a GemFire cache Sub-Region.

Parameters:

parent - reference to the parent Region.

See Also:

• Region

getParent

protected Region<?,?> getParent()

Returns a reference to the parent Region indicating this FactoryBean represents a GemFire cache Sub-Region.

Returns:

a reference to the parent Region or null if this Region is not a Sub-Region.

See Also:

• Region

setRegion

protected void setRegion(Region<K,V> region)

Sets a reference to the Region to be resolved by this Spring FactoryBean.

Parameters:

region - reference to the resolvable Region.

See Also:

• Region

getRegion

public Region<K,V> getRegion()

Returns a reference to the Region resolved by this Spring FactoryBean during the lookup operation; maybe a new Region.

Returns:

a reference to the Region resolved during lookup.

See Also:

• Region

setRegionName

public void setRegionName(String regionName)

Sets the name of the cache Region. If no Region is found with the given name, a new one will be created. If no name is given, the value of the 'name' property will be used.

Parameters:

regionName - name of the Region.

See Also:

• setName(String)
• Region.getName()

setSnapshot

public void setSnapshot(Resource snapshot)

Sets the snapshots used for loading a newly created region. That is, the snapshot will be used only when a new region is created - if the region already exists, no loading will be performed.

Parameters:

snapshot - the snapshot to set

See Also:

• setName(String)