org.springframework.data.gemfire.client

Class ClientRegionFactoryBean<K,V>

java.lang.Object

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

org.springframework.data.gemfire.client.ClientRegionFactoryBean<K,V>

All Implemented Interfaces:

Aware, BeanFactoryAware, BeanNameAware, DisposableBean, FactoryBean<com.gemstone.gemfire.cache.Region<K,V>>, InitializingBean

public class ClientRegionFactoryBean<K,V>
extends RegionLookupFactoryBean<K,V>
implements BeanFactoryAware, DisposableBean

Spring FactoryBean used to create a GemFire client Region.

Author:

Costin Leau, David Turanski, John Blum

See Also:

BeanFactory, BeanFactoryAware, DisposableBean, RegionLookupFactoryBean, DataPolicy, GemFireCache, Region, RegionAttributes, ClientCache, ClientRegionFactory, ClientRegionShortcut

Constructor Summary

Constructors

Constructor and Description
ClientRegionFactoryBean()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet()
void	destroy()
protected boolean	isNotPersistent()
protected boolean	isPersistent()
protected boolean	isPersistentUnspecified()
protected com.gemstone.gemfire.cache.Region<K,V>	lookupRegion(com.gemstone.gemfire.cache.GemFireCache cache, String regionName) Method to perform a lookup when the named Region does not exist.
protected void	postProcess(com.gemstone.gemfire.cache.Region<K,V> region)
void	setAttributes(com.gemstone.gemfire.cache.RegionAttributes<K,V> attributes) Sets the region attributes used for the region used by this factory.
void	setBeanFactory(BeanFactory beanFactory)
void	setCacheListeners(com.gemstone.gemfire.cache.CacheListener<K,V>[] cacheListeners) Sets the cache listeners used for the region used by this factory.
void	setCacheLoader(com.gemstone.gemfire.cache.CacheLoader<K,V> cacheLoader) Sets the CacheLoader used to load data local to the client's Region on cache misses.
void	setCacheWriter(com.gemstone.gemfire.cache.CacheWriter<K,V> cacheWriter) Sets the CacheWriter used to perform a synchronous write-behind when data is put into the client's Region.
void	setClose(boolean close) Indicates whether the region referred by this factory bean, will be closed on shutdown (default true).
void	setDataPolicy(com.gemstone.gemfire.cache.DataPolicy dataPolicy) Sets the Data Policy.
void	setDataPolicyName(String dataPolicyName) Deprecated. use setDataPolicy(:DataPolicy) instead.
void	setDestroy(boolean destroy) Indicates whether the region referred by this factory bean will be destroyed on shutdown (default false).
void	setDiskStoreName(String diskStoreName) Sets the name of disk store to use for overflow and persistence
void	setEvictionAttributes(com.gemstone.gemfire.cache.EvictionAttributes evictionAttributes)
void	setInterests(Interest<K>[] interests) Set the interests for this client region.
void	setKeyConstraint(Class<K> keyConstraint)
void	setPersistent(boolean persistent)
void	setPool(com.gemstone.gemfire.cache.client.Pool pool) Sets the Pool used by this client Region.
void	setPoolName(String poolName) Sets the Pool name used by this client Region.
void	setShortcut(com.gemstone.gemfire.cache.client.ClientRegionShortcut shortcut) Initializes the client Region using a GemFire ClientRegionShortcut.
void	setSnapshot(Resource snapshot) Specifies the data snapshots used for loading a newly created Region.
void	setValueConstraint(Class<V> valueConstraint)

Methods inherited from class org.springframework.data.gemfire.RegionLookupFactoryBean

getLookupEnabled, getObject, getObjectType, getParent, getRegion, isSingleton, lookupFallback, resolveRegionName, setBeanName, setCache, setLookupEnabled, setName, setParent, setRegionName

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientRegionFactoryBean

public ClientRegionFactoryBean()

Method Detail

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class RegionLookupFactoryBean<K,V>

Throws:

Exception

lookupRegion

protected com.gemstone.gemfire.cache.Region<K,V> lookupRegion(com.gemstone.gemfire.cache.GemFireCache cache,
                                                              String regionName)
                                                       throws Exception

Description copied from class: RegionLookupFactoryBean

Method to perform a lookup when the named Region does not exist. By default, this implementation throws an exception.

Overrides:

lookupRegion in class RegionLookupFactoryBean<K,V>

Parameters:

cache - reference to the GemFire cache.

regionName - name of the GemFire Region.

Returns:

the Region in the GemFire cache with the given name.

Throws:

BeanInitializationException - if the lookup operation fails.

Exception

See Also:

Region

postProcess

protected void postProcess(com.gemstone.gemfire.cache.Region<K,V> region)
                    throws Exception

Throws:

Exception

destroy

public void destroy()
             throws Exception

Specified by:

destroy in interface DisposableBean

Throws:

Exception

setAttributes

public void setAttributes(com.gemstone.gemfire.cache.RegionAttributes<K,V> attributes)

Sets the region attributes used for the region used by this factory. Allows maximum control in specifying the region settings. Used only when a new region is created. Note that using this method allows for advanced customization of the region - while it provides a lot of flexibility, note that it's quite easy to create misconfigured regions (especially in a client/server scenario).

Parameters:

attributes - the attributes to set on a newly created region

setBeanFactory

public void setBeanFactory(BeanFactory beanFactory)
                    throws BeansException

Specified by:

setBeanFactory in interface BeanFactoryAware

Throws:

BeansException

setClose

public void setClose(boolean close)

Indicates whether the region referred by this factory bean, will be closed on shutdown (default true). Note: destroy and close are mutually exclusive. Enabling one will automatically disable the other.

Parameters:

close - whether to close or not the region

See Also:

setDestroy(boolean)

setCacheListeners

public void setCacheListeners(com.gemstone.gemfire.cache.CacheListener<K,V>[] cacheListeners)

Sets the cache listeners used for the region used by this factory. Used only when a new region is created.Overrides the settings specified through setAttributes(RegionAttributes).

Parameters:

cacheListeners - the cacheListeners to set on a newly created region

setCacheLoader

public void setCacheLoader(com.gemstone.gemfire.cache.CacheLoader<K,V> cacheLoader)

Sets the CacheLoader used to load data local to the client's Region on cache misses.

Parameters:

cacheLoader - a GemFire CacheLoader used to load data into the client Region.

See Also:

CacheLoader

setCacheWriter

public void setCacheWriter(com.gemstone.gemfire.cache.CacheWriter<K,V> cacheWriter)

Sets the CacheWriter used to perform a synchronous write-behind when data is put into the client's Region.

Parameters:

cacheWriter - the GemFire CacheWriter used to perform synchronous write-behinds on put ops.

See Also:

CacheWriter

setDataPolicy

public void setDataPolicy(com.gemstone.gemfire.cache.DataPolicy dataPolicy)

Sets the Data Policy. Used only when a new Region is created.

Parameters:

dataPolicy - the client Region's Data Policy.

See Also:

DataPolicy

setDataPolicyName

@Deprecated
public void setDataPolicyName(String dataPolicyName)

Deprecated. use setDataPolicy(:DataPolicy) instead.

An alternate way to set the Data Policy, using the String name of the enumerated value.

Parameters:

dataPolicyName - the enumerated value String name of the Data Policy.

See Also:

DataPolicy, setDataPolicy(com.gemstone.gemfire.cache.DataPolicy)

setDestroy

public void setDestroy(boolean destroy)

Indicates whether the region referred by this factory bean will be destroyed on shutdown (default false). Note: destroy and close are mutually exclusive. Enabling one will automatically disable the other.

Parameters:

destroy - whether or not to destroy the region

See Also:

setClose(boolean)

setDiskStoreName

public void setDiskStoreName(String diskStoreName)

Sets the name of disk store to use for overflow and persistence

Parameters:

diskStoreName - a String specifying the 'name' of the client Region Disk Store.

setEvictionAttributes

public void setEvictionAttributes(com.gemstone.gemfire.cache.EvictionAttributes evictionAttributes)

setInterests

public void setInterests(Interest<K>[] interests)

Set the interests for this client region. Both key and regex interest are supported.

Parameters:

interests - the interests to set

setKeyConstraint

public void setKeyConstraint(Class<K> keyConstraint)

isPersistentUnspecified

protected boolean isPersistentUnspecified()

isPersistent

protected boolean isPersistent()

isNotPersistent

protected boolean isNotPersistent()

setPersistent

public void setPersistent(boolean persistent)

setPool

public void setPool(com.gemstone.gemfire.cache.client.Pool pool)

Sets the Pool used by this client Region.

Parameters:

pool - GemFire client Pool.

See Also:

Pool

setPoolName

public void setPoolName(String poolName)

Sets the Pool name used by this client Region.

Parameters:

poolName - String specifying the name of the GemFire client Pool.

setShortcut

public void setShortcut(com.gemstone.gemfire.cache.client.ClientRegionShortcut shortcut)

Initializes the client Region using a GemFire ClientRegionShortcut.

Parameters:

shortcut - ClientRegionShortcut used to initialize this client Region.

setSnapshot

public void setSnapshot(Resource snapshot)

Specifies the data snapshots used for loading a newly created Region. The snapshot will be used only when a new Region is created. If the Region already exists, no loading will be performed.

Parameters:

snapshot - Resource referencing the snapshot used to load the Region with data.

See Also:

Resource

setValueConstraint

public void setValueConstraint(Class<V> valueConstraint)