com.gemstone.gemfire.cache
Class RegionFactory<K,V>

java.lang.Object
  com.gemstone.gemfire.cache.RegionFactory<K,V>

public class RegionFactory<K,V>
extends Object

RegionFactory is used to create regions in a cache. Instances of this interface can be created:

• using a shortcut by calling Cache.createRegionFactory(RegionShortcut) which will initialize the factory with the shortcut's region attributes
• using a named region attribute by calling Cache.createRegionFactory(String) which will initialize the factory the named region attributes
• using a region attribute instance by calling Cache.createRegionFactory(RegionAttributes) which will initialize the factory with the given region attributes
• by calling Cache.createRegionFactory() which will initialize the factory with defaults

Once the factory has been created it can be customized with its setter methods.

The final step is to produce a Region by calling create(String).

Example: Create a replicate region with a CacheListener

  Cache c = new CacheFactory().create();
  // Create replicate region.
  // Add a cache listener before creating region
  Region r = c.createRegionFactory(REPLICATE)
    .addCacheListener(myListener)
    .create("replicate");

Example: Create a partition region that has redundancy

  Cache c = new CacheFactory().create();
  // Create replicate region.
  // Add a cache listener before creating region
  Region r = c.createRegionFactory(PARTITION_REDUNDANT)
    .create("partition");

Since:

5.0

Constructor Summary

RegionFactory()
Deprecated. as of 6.5 use Cache.createRegionFactory() instead.

RegionFactory(Properties distributedSystemProperties)
Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory() instead.

RegionFactory(Properties distributedSystemProperties, RegionAttributes<K,V> regionAttributes)
Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory(RegionAttributes) instead.

RegionFactory(Properties distributedSystemProperties, String regionAttributesId)
Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory(String) instead.

RegionFactory(RegionAttributes<K,V> regionAttributes)
Deprecated. as of 6.5 use Cache.createRegionFactory(RegionAttributes) instead.

RegionFactory(String regionAttributesId)
Deprecated. as of 6.5 use Cache.createRegionFactory(String) instead.

Method Summary

RegionFactory<K,V>	addCacheListener(CacheListener<K,V> aListener) Adds a cache listener to the end of the list of cache listeners on this factory.
Region<K,V>	create(String name) Creates a region with the given name in this factory's Cache using the configuration contained in this factory.
RegionFactory<K,V>	initCacheListeners(CacheListener<K,V>[] newListeners) Removes all cache listeners and then adds each listener in the specified array.
RegionFactory<K,V>	setCacheLoader(CacheLoader<K,V> cacheLoader) Sets the cache loader for the next RegionAttributes created.
RegionFactory<K,V>	setCacheWriter(CacheWriter<K,V> cacheWriter) Sets the cache writer for the next RegionAttributes created.
RegionFactory<K,V>	setCloningEnabled(boolean cloningEnable) Sets cloning on region
RegionFactory<K,V>	setConcurrencyLevel(int concurrencyLevel) Sets the concurrency level tof the next RegionAttributes created.
RegionFactory<K,V>	setCustomEntryIdleTimeout(CustomExpiry<K,V> custom) Sets the custom idleTimeout for the next RegionAttributes created.
RegionFactory<K,V>	setCustomEntryTimeToLive(CustomExpiry<K,V> custom) Sets the custom timeToLive expiration method for the next RegionAttributes created.
RegionFactory<K,V>	setDataPolicy(DataPolicy dataPolicy) Sets the data policy for the next RegionAttributes created.
RegionFactory<K,V>	setDiskDirs(File[] diskDirs) Deprecated. as of 6.5 use DiskStoreFactory.setDiskDirs(java.io.File[]) instead
RegionFactory<K,V>	setDiskDirsAndSizes(File[] diskDirs, int[] diskSizes) Deprecated. as of 6.5 use DiskStoreFactory.setDiskDirsAndSizes(java.io.File[], int[]) instead
RegionFactory<K,V>	setDiskStoreName(String name) Sets the DiskStore name attribute.
RegionFactory<K,V>	setDiskSynchronous(boolean isSynchronous) Sets whether or not the writing to the disk is synchronous.
RegionFactory<K,V>	setDiskWriteAttributes(DiskWriteAttributes attrs) Deprecated. as of 6.5 use setDiskStoreName(java.lang.String) instead
RegionFactory<K,V>	setEarlyAck(boolean earlyAck) Deprecated. As of 6.5 this setting no longer has any effect.
RegionFactory<K,V>	setEnableAsyncConflation(boolean value) Sets whether or not conflation is enabled for sending messages to async peers.
RegionFactory<K,V>	setEnableGateway(boolean value) Sets whether or not updates are sent to defined Gateways.
RegionFactory<K,V>	setEnableSubscriptionConflation(boolean value) Sets whether or not conflation is enabled for sending messages from a cache server to its clients.
RegionFactory<K,V>	setEntryIdleTimeout(ExpirationAttributes idleTimeout) Sets the idleTimeout expiration attributes for region entries for the next RegionAttributes created.
RegionFactory<K,V>	setEntryTimeToLive(ExpirationAttributes timeToLive) Sets the timeToLive expiration attributes for region entries for the next RegionAttributes created.
RegionFactory<K,V>	setEvictionAttributes(EvictionAttributes evictionAttributes) Sets the eviction attributes that controls growth of the Region to be created.
RegionFactory<K,V>	setGatewayHubId(String id) Sets the id of the GatewayHub to which this region sends events.
RegionFactory<K,V>	setIgnoreJTA(boolean flag) Sets whether operations on this region should be controlled by JTA transactions or not
RegionFactory<K,V>	setIndexMaintenanceSynchronous(boolean synchronous) Sets how indexes on this region are kept current.
RegionFactory<K,V>	setInitialCapacity(int initialCapacity) Sets the entry initial capacity for the next RegionAttributes created.
RegionFactory<K,V>	setKeyConstraint(Class<K> keyConstraint) Sets the key constraint for the next RegionAttributes created.
RegionFactory<K,V>	setLoadFactor(float loadFactor) Sets the entry load factor for the next RegionAttributes created.
RegionFactory<K,V>	setLockGrantor(boolean isLockGrantor) Sets whether this region should become lock grantor.
RegionFactory<K,V>	setMembershipAttributes(MembershipAttributes ra) Sets the MembershipAttributes that describe the membership roles required for reliable access to the region.
RegionFactory<K,V>	setMulticastEnabled(boolean value) Sets whether distributed operations on this region should attempt to use multicast.
RegionFactory<K,V>	setPartitionAttributes(PartitionAttributes partition) Sets the PartitionAttributes that describe how the region is partitioned among members of the distributed system.
RegionFactory<K,V>	setPoolName(String poolName) Sets the pool name attribute.
void	setPublisher(boolean v) Deprecated. as of 6.5
RegionFactory<K,V>	setRegionIdleTimeout(ExpirationAttributes idleTimeout) Sets the idleTimeout expiration attributes for the region itself for the next RegionAttributes created.
RegionFactory<K,V>	setRegionTimeToLive(ExpirationAttributes timeToLive) Sets the timeToLive expiration attributes for the region itself for the next RegionAttributes created.
RegionFactory<K,V>	setScope(Scope scopeType) Sets the scope for the next RegionAttributes created.
RegionFactory<K,V>	setStatisticsEnabled(boolean statisticsEnabled) Sets whether statistics are enabled for this region and its entries.
RegionFactory<K,V>	setSubscriptionAttributes(SubscriptionAttributes sa) Sets the kind of interest this region has in events occuring in other caches that define the region by the same name.
RegionFactory<K,V>	setValueConstraint(Class<V> valueConstraint) Sets the value constraint for the next RegionAttributes created.

Methods inherited from class java.lang.Object

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

Constructor Detail

RegionFactory

@Deprecated
public RegionFactory()
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use Cache.createRegionFactory() instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If no DistributedSystem exists it creates a DistributedSystem with default configuration, otherwise it uses the existing DistributedSystem. The default Region configuration is used.

Throws:

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

RegionFactory

@Deprecated
public RegionFactory(RegionAttributes<K,V> regionAttributes)
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use Cache.createRegionFactory(RegionAttributes) instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If no DistributedSystem exists it creates a DistributedSystem with default configuration, otherwise it uses the existing DistributedSystem. The Region configuration is initialized using the provided RegionAttributes.

Throws:

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

RegionFactory

@Deprecated
public RegionFactory(String regionAttributesId)
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use Cache.createRegionFactory(String) instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If no DistributedSystem exists it creates a DistributedSystem with default configuration, otherwise it uses the existing DistributedSystem. The Region configuration is initialized using the RegionAttributes identified in the cache.xml file by the provided identifier.

Parameters:

regionAttributesId - that identifies a set of RegionAttributes in the cache-xml file.

Throws:

IllegalArgumentException - if there are no attributes associated with the id

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

See Also:

GemFireCache.getRegionAttributes(java.lang.String)

RegionFactory

@Deprecated
public RegionFactory(Properties distributedSystemProperties)
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory() instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If a DistributedSystem already exists with the same properties it uses that DistributedSystem, otherwise a DistributedSystem is created using the provided properties. The default Region configuration is used.

Parameters:

distributedSystemProperties - an instance of Properties containing DistributedSystemThrows:

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

RegionFactory

@Deprecated
public RegionFactory(Properties distributedSystemProperties,
                                RegionAttributes<K,V> regionAttributes)
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory(RegionAttributes) instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If a DistributedSystem already exists with the same properties it uses that DistributedSystem, otherwise a DistributedSystem is created using the provided properties. The initial Region configuration is set using the RegionAttributes provided.

Parameters:

distributedSystemProperties - properties used to either find or create a DistributedSystem.

regionAttributes - the initial Region configuration for this RegionFactory.

Throws:

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

RegionFactory

@Deprecated
public RegionFactory(Properties distributedSystemProperties,
                                String regionAttributesId)
              throws CacheWriterException,
                     RegionExistsException,
                     TimeoutException

Deprecated. as of 6.5 use CacheFactory.CacheFactory(Properties) and Cache.createRegionFactory(String) instead.

Constructs a RegionFactory by creating a DistributedSystem and a Cache. If a DistributedSystem already exists whose properties match those provied, it uses that DistributedSystem. The Region configuration is initialized using the RegionAttributes identified in the cache.xml file by the provided identifier.

Parameters:

distributedSystemProperties - properties used to either find or create a DistributedSystem.

regionAttributesId - the identifier for set of RegionAttributes in the cache.xml file used as the initial Region configuration for this RegionFactory.

Throws:

IllegalArgumentException - if there are no attributes associated with the id

CacheException - if unable to connect the DistributedSystem or create a Cache

CacheWriterException

RegionExistsException

TimeoutException

Method Detail

setCacheLoader

public RegionFactory<K,V> setCacheLoader(CacheLoader<K,V> cacheLoader)

Sets the cache loader for the next RegionAttributes created.

Parameters:

cacheLoader - the cache loader or null if no loader

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setCacheLoader(com.gemstone.gemfire.cache.CacheLoader)

setCacheWriter

public RegionFactory<K,V> setCacheWriter(CacheWriter<K,V> cacheWriter)

Sets the cache writer for the next RegionAttributes created.

Parameters:

cacheWriter - the cache writer or null if no cache writer

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setCacheWriter(com.gemstone.gemfire.cache.CacheWriter)

addCacheListener

public RegionFactory<K,V> addCacheListener(CacheListener<K,V> aListener)

Adds a cache listener to the end of the list of cache listeners on this factory.

Parameters:

aListener - the cache listener to add

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if aListener is null

See Also:

AttributesFactory.addCacheListener(com.gemstone.gemfire.cache.CacheListener)

initCacheListeners

public RegionFactory<K,V> initCacheListeners(CacheListener<K,V>[] newListeners)

Removes all cache listeners and then adds each listener in the specified array. for the next RegionAttributes created.

Parameters:

newListeners - a possibly null or empty array of listeners to add to this factory.

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if the newListeners array has a null element

See Also:

AttributesFactory.initCacheListeners(com.gemstone.gemfire.cache.CacheListener[])

setEvictionAttributes

public RegionFactory<K,V> setEvictionAttributes(EvictionAttributes evictionAttributes)

Sets the eviction attributes that controls growth of the Region to be created.

Parameters:

evictionAttributes - for the Region to create

Returns:

a reference to this RegionFactory object

setEntryIdleTimeout

public RegionFactory<K,V> setEntryIdleTimeout(ExpirationAttributes idleTimeout)

Sets the idleTimeout expiration attributes for region entries for the next RegionAttributes created.

Parameters:

idleTimeout - the idleTimeout ExpirationAttributes for entries in this region

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if idleTimeout is null

See Also:

AttributesFactory.setEntryIdleTimeout(com.gemstone.gemfire.cache.ExpirationAttributes)

setCustomEntryIdleTimeout

public RegionFactory<K,V> setCustomEntryIdleTimeout(CustomExpiry<K,V> custom)

Sets the custom idleTimeout for the next RegionAttributes created.

Parameters:

custom - the custom method

Returns:

the receiver

See Also:

AttributesFactory.setCustomEntryIdleTimeout(CustomExpiry)

setEntryTimeToLive

public RegionFactory<K,V> setEntryTimeToLive(ExpirationAttributes timeToLive)

Sets the timeToLive expiration attributes for region entries for the next RegionAttributes created.

Parameters:

timeToLive - the timeToLive ExpirationAttributes for entries in this region

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if timeToLive is null

See Also:

AttributesFactory.setEntryTimeToLive(com.gemstone.gemfire.cache.ExpirationAttributes)

setCustomEntryTimeToLive

public RegionFactory<K,V> setCustomEntryTimeToLive(CustomExpiry<K,V> custom)

Sets the custom timeToLive expiration method for the next RegionAttributes created.

Parameters:

custom - the custom method

Returns:

the receiver

See Also:

AttributesFactory.setCustomEntryTimeToLive(CustomExpiry)

setRegionIdleTimeout

public RegionFactory<K,V> setRegionIdleTimeout(ExpirationAttributes idleTimeout)

Sets the idleTimeout expiration attributes for the region itself for the next RegionAttributes created.

Parameters:

idleTimeout - the ExpirationAttributes for this region idleTimeout

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if idleTimeout is null

See Also:

AttributesFactory.setRegionIdleTimeout(com.gemstone.gemfire.cache.ExpirationAttributes)

setRegionTimeToLive

public RegionFactory<K,V> setRegionTimeToLive(ExpirationAttributes timeToLive)

Sets the timeToLive expiration attributes for the region itself for the next RegionAttributes created.

Parameters:

timeToLive - the ExpirationAttributes for this region timeToLive

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if timeToLive is null

See Also:

AttributesFactory.setRegionTimeToLive(com.gemstone.gemfire.cache.ExpirationAttributes)

setScope

public RegionFactory<K,V> setScope(Scope scopeType)

Sets the scope for the next RegionAttributes created.

Parameters:

scopeType - the type of Scope to use for the region

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if scopeType is null

See Also:

AttributesFactory.setScope(com.gemstone.gemfire.cache.Scope)

setDataPolicy

public RegionFactory<K,V> setDataPolicy(DataPolicy dataPolicy)

Sets the data policy for the next RegionAttributes created.

Parameters:

dataPolicy - The type of mirroring to use for the region

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if dataPolicy is null

See Also:

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

setEarlyAck

@Deprecated
public RegionFactory<K,V> setEarlyAck(boolean earlyAck)

Deprecated. As of 6.5 this setting no longer has any effect.

Sets for this region whether or not acks are sent after an update is processed.

Parameters:

earlyAck - set to true for the acknowledgement to be sent prior to processing the update

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setEarlyAck(boolean)

setMulticastEnabled

public RegionFactory<K,V> setMulticastEnabled(boolean value)

Sets whether distributed operations on this region should attempt to use multicast.

Parameters:

value - true to enable multicast

Returns:

a reference to this RegionFactory object

Since:

5.0

See Also:

AttributesFactory.setMulticastEnabled(boolean)

setPoolName

public RegionFactory<K,V> setPoolName(String poolName)

Sets the pool name attribute. This causes regions that use these attributes to be a client region which communicates with the servers that the connection pool communicates with.

If this attribute is set to null or "" then the connection pool is disabled causing regions that use these attributes to be communicate with peers instead of servers.

The named connection pool must exist on the cache at the time these attributes are used to create a region. See PoolManager.createFactory() for how to create a connection pool.

Parameters:

poolName - the name of the connection pool to use; if null or "" then the connection pool attribute is disabled for regions using these attributes.

Returns:

a reference to this RegionFactory object

Throws:

IllegalStateException - if a cache loader or cache writer has already been set.

Since:

5.7

setEnableGateway

public RegionFactory<K,V> setEnableGateway(boolean value)

Sets whether or not updates are sent to defined Gateways.

Parameters:

value - true to enable Gateway

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setEnableGateway(boolean)

setPublisher

@Deprecated
public void setPublisher(boolean v)

Deprecated. as of 6.5

Sets whether or not this region should be considered a publisher.

Since:

5.0

setEnableAsyncConflation

public RegionFactory<K,V> setEnableAsyncConflation(boolean value)

Sets whether or not conflation is enabled for sending messages to async peers.

Parameters:

value - true to enable async conflation

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setEnableAsyncConflation(boolean)

setEnableSubscriptionConflation

public RegionFactory<K,V> setEnableSubscriptionConflation(boolean value)

Sets whether or not conflation is enabled for sending messages from a cache server to its clients.

Parameters:

value - true to enable subscription conflation

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setEnableSubscriptionConflation(boolean)

setKeyConstraint

public RegionFactory<K,V> setKeyConstraint(Class<K> keyConstraint)

Sets the key constraint for the next RegionAttributes created. Keys in the region will be constrained to this class (or subclass). Any attempt to store a key of an incompatible type in the region will cause a ClassCastException to be thrown.

Parameters:

keyConstraint - The Class to constrain the keys to, or null if no constraint

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if keyConstraint is a class denoting a primitive type

See Also:

AttributesFactory.setKeyConstraint(java.lang.Class)

setValueConstraint

public RegionFactory<K,V> setValueConstraint(Class<V> valueConstraint)

Sets the value constraint for the next RegionAttributes created. Values in the region will be constrained to this class (or subclass). Any attempt to store a value of an incompatible type in the region will cause a ClassCastException to be thrown.

Parameters:

valueConstraint - The Class to constrain the values to, or null if no constraint

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if valueConstraint is a class denoting a primitive type

See Also:

AttributesFactory.setValueConstraint(java.lang.Class)

setInitialCapacity

public RegionFactory<K,V> setInitialCapacity(int initialCapacity)

Sets the entry initial capacity for the next RegionAttributes created. This value is used in initializing the map that holds the entries.

Parameters:

initialCapacity - the initial capacity of the entry map

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if initialCapacity is negative.

See Also:

HashMap, AttributesFactory.setInitialCapacity(int)

setLoadFactor

public RegionFactory<K,V> setLoadFactor(float loadFactor)

Sets the entry load factor for the next RegionAttributes created. This value is used in initializing the map that holds the entries.

Parameters:

loadFactor - the load factor of the entry map

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if loadFactor is nonpositive

See Also:

HashMap, AttributesFactory.setLoadFactor(float)

setConcurrencyLevel

public RegionFactory<K,V> setConcurrencyLevel(int concurrencyLevel)

Sets the concurrency level tof the next RegionAttributes created. This value is used in initializing the map that holds the entries.

Parameters:

concurrencyLevel - the concurrency level of the entry map

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if concurrencyLevel is nonpositive

See Also:

AttributesFactory.setConcurrencyLevel(int)

setDiskWriteAttributes

@Deprecated
public RegionFactory<K,V> setDiskWriteAttributes(DiskWriteAttributes attrs)

Deprecated. as of 6.5 use setDiskStoreName(java.lang.String) instead

Returns whether or not disk writes are asynchronous.

Returns:

a reference to this RegionFactory object

See Also:

Region.writeToDisk(), AttributesFactory.setDiskWriteAttributes(com.gemstone.gemfire.cache.DiskWriteAttributes)

setDiskStoreName

public RegionFactory<K,V> setDiskStoreName(String name)

Sets the DiskStore name attribute. This causes the region to belong to the DiskStore.

Parameters:

name - the name of the diskstore

Returns:

a reference to this RegionFactory object

Since:

6.5

See Also:

AttributesFactory.setDiskStoreName(java.lang.String)

setDiskSynchronous

public RegionFactory<K,V> setDiskSynchronous(boolean isSynchronous)

Sets whether or not the writing to the disk is synchronous.

Parameters:

isSynchronous - boolean if true indicates synchronous writes

Returns:

a reference to this RegionFactory object

Since:

6.5

setDiskDirs

@Deprecated
public RegionFactory<K,V> setDiskDirs(File[] diskDirs)

Deprecated. as of 6.5 use DiskStoreFactory.setDiskDirs(java.io.File[]) instead

Sets the directories to which the region's data are written. If multiple directories are used, GemFire will attempt to distribute the data evenly amongst them.

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if a directory does not exist

See Also:

AttributesFactory.setDiskDirs(java.io.File[])

setDiskDirsAndSizes

@Deprecated
public RegionFactory<K,V> setDiskDirsAndSizes(File[] diskDirs,
                                                         int[] diskSizes)

Deprecated. as of 6.5 use DiskStoreFactory.setDiskDirsAndSizes(java.io.File[], int[]) instead

Sets the directories to which the region's data are written and also set their sizes in megabytes

Returns:

a reference to this RegionFactory object

Throws:

IllegalArgumentException - if a dir does not exist or the length of the size array does not match to the length of the dir array

Since:

5.1

See Also:

AttributesFactory.setDiskDirsAndSizes(java.io.File[], int[])

setPartitionAttributes

public RegionFactory<K,V> setPartitionAttributes(PartitionAttributes partition)

Sets the PartitionAttributes that describe how the region is partitioned among members of the distributed system.

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setPartitionAttributes(com.gemstone.gemfire.cache.PartitionAttributes)

setMembershipAttributes

public RegionFactory<K,V> setMembershipAttributes(MembershipAttributes ra)

Sets the MembershipAttributes that describe the membership roles required for reliable access to the region.

Parameters:

ra - the MembershipAttributes to use

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setMembershipAttributes(com.gemstone.gemfire.cache.MembershipAttributes)

setIndexMaintenanceSynchronous

public RegionFactory<K,V> setIndexMaintenanceSynchronous(boolean synchronous)

Sets how indexes on this region are kept current.

Parameters:

synchronous - whether indexes are maintained in a synchronized fashion

Returns:

a reference to this RegionFactory object

setStatisticsEnabled

public RegionFactory<K,V> setStatisticsEnabled(boolean statisticsEnabled)

Sets whether statistics are enabled for this region and its entries.

Parameters:

statisticsEnabled - whether statistics are enabled

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setStatisticsEnabled(boolean)

setIgnoreJTA

public RegionFactory<K,V> setIgnoreJTA(boolean flag)

Sets whether operations on this region should be controlled by JTA transactions or not

Since:

5.0

setLockGrantor

public RegionFactory<K,V> setLockGrantor(boolean isLockGrantor)

Sets whether this region should become lock grantor.

Parameters:

isLockGrantor - whether this region should become lock grantor

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setLockGrantor(boolean)

setSubscriptionAttributes

public RegionFactory<K,V> setSubscriptionAttributes(SubscriptionAttributes sa)

Sets the kind of interest this region has in events occuring in other caches that define the region by the same name.

Parameters:

sa - the attributes decribing the interest

Returns:

a reference to this RegionFactory object

See Also:

AttributesFactory.setSubscriptionAttributes(SubscriptionAttributes)

setGatewayHubId

public RegionFactory<K,V> setGatewayHubId(String id)

Sets the id of the GatewayHub to which this region sends events.

Parameters:

id - the id of the GatewayHub

Returns:

a reference to this RegionFactory object

Since:

5.1

See Also:

AttributesFactory.setGatewayHubId(String)

create

public Region<K,V> create(String name)
                   throws CacheExistsException,
                          RegionExistsException,
                          CacheWriterException,
                          TimeoutException

Creates a region with the given name in this factory's Cache using the configuration contained in this factory. Validation of the provided attributes may cause exceptions to be thrown if there are problems with the configuration data.

Parameters:

name - the name of the region to create

Returns:

the region object

Throws:

LeaseExpiredException - if lease expired on distributed lock for Scope.GLOBAL

RegionExistsException - if a region, shared or unshared, is already in this cache

TimeoutException - if timed out getting distributed lock for Scope.GLOBAL

CacheClosedException - if the cache is closed

IllegalStateException - if the supplied RegionAttributes are incompatible with this region in another cache in the distributed system (see AttributesFactory for compatibility rules)

CacheExistsException

CacheWriterException

setCloningEnabled

public RegionFactory<K,V> setCloningEnabled(boolean cloningEnable)

Sets cloning on region

Parameters:

cloningEnable -

Returns:

a reference to this RegionFactory object

Since:

6.1

See Also:

AttributesFactory.setCloningEnabled(boolean)