org.springframework.data.gemfire.config.annotation

Annotation Type ClientCacheApplication

@Target(value=TYPE)
 @Retention(value=RUNTIME)
 @Inherited
 @Documented
 @Configuration
 @Import(value=ClientCacheConfiguration.class)
public @interface ClientCacheApplication

The ClientCacheApplication annotation enables a Spring Data GemFire based application to become a GemFire cache client (i.e. ClientCache).

Since:

1.9.0

Author:

John Blum

See Also:

PoolFactory, ResourceManager, Configuration, Import, ClientCacheConfiguration

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	copyOnRead Indicates whether the "copy on read" is enabled for this cache.
float	criticalHeapPercentage Configures the percentage of heap at or above which the cache is considered in danger of becoming inoperable.
String	durableClientId Used only for clients in a client/server installation.
int	durableClientTimeout Used only for clients in a client/server installation.
float	evictionHeapPercentage Configures the percentage of heap at or above which the eviction should begin on Regions configured for HeapLRU eviction.
int	freeConnectionTimeout Configures the free connection timeout for this pool.
long	idleTimeout Configures the amount of time a connection can be idle before expiring the connection.
boolean	keepAlive Configures whether to keep the client queues alive on the server when the client is disconnected Default is false.
int	loadConditioningInterval Configures the load conditioning interval for this pool.
ClientCacheApplication.Locator[]	locators Configures the GemFire Locators to which this cache client will connect.
String	logLevel Configures the log level used to output log messages at GemFire cache runtime.
int	maxConnections Configures the max number of client to server connections that the pool will create.
int	minConnections Configures the minimum number of connections to keep available at all times.
boolean	multiUserAuthentication If set to true then the created pool can be used by multiple users.
String	name Configures the name of this GemFire member in the cluster (distributed system).
long	pingInterval Configures how often to ping servers to verify that they are still alive.
boolean	prSingleHopEnabled By default prSingleHopEnabled is true in which case the client is aware of the location of partitions on servers hosting Regions with DataPolicy.PARTITION.
int	readTimeout Configures the number of milliseconds to wait for a response from a server before timing out the operation and trying another server (if any are available).
boolean	readyForEvents Notifies the server that this durable client is ready to receive updates.
int	retryAttempts Configures the number of times to retry a request after timeout/exception.
String	serverGroup Configures the group that all servers in which this pool connects to must belong to.
ClientCacheApplication.Server[]	servers Configures the GemFire CacheServers to which this cache client will connect.
int	socketBufferSize Configures the socket buffer size for each connection made in this pool.
int	statisticInterval Configures how often to send client statistics to the server.
int	subscriptionAckInterval Configures the interval in milliseconds to wait before sending acknowledgements to the cache server for events received from the server subscriptions.
boolean	subscriptionEnabled If set to true then the created pool will have server-to-client subscriptions enabled.
int	subscriptionMessageTrackingTimeout Configures the messageTrackingTimeout attribute which is the time-to-live period, in milliseconds, for subscription events the client has received from the server.
int	subscriptionRedundancy Configures the redundancy level for this pools server-to-client subscriptions.
boolean	threadLocalConnections Configures the thread local connections policy for this pool.
boolean	useBeanFactoryLocator Determines whether the GemfireBeanFactoryLocator should be enabled to lookup the Spring BeanFactory to auto-wire and configure/initialize GemFire components created in a non-Spring managed, GemFire context.

Element Detail

copyOnRead

public abstract boolean copyOnRead

Indicates whether the "copy on read" is enabled for this cache. Default is false.

Default:

false

criticalHeapPercentage

public abstract float criticalHeapPercentage

Configures the percentage of heap at or above which the cache is considered in danger of becoming inoperable.

See Also:

ResourceManager.DEFAULT_CRITICAL_PERCENTAGE

Default:

0.0f

durableClientId

public abstract String durableClientId

Used only for clients in a client/server installation. If set, this indicates that the client is durable and identifies the client. The ID is used by servers to reestablish any messaging that was interrupted by client downtime.

Default:

""

durableClientTimeout

public abstract int durableClientTimeout

Used only for clients in a client/server installation. Number of seconds this client can remain disconnected from its server and have the server continue to accumulate durable events for it.

Default:

300

evictionHeapPercentage

public abstract float evictionHeapPercentage

Configures the percentage of heap at or above which the eviction should begin on Regions configured for HeapLRU eviction.

See Also:

ResourceManager.DEFAULT_EVICTION_PERCENTAGE

Default:

0.0f

freeConnectionTimeout

public abstract int freeConnectionTimeout

Configures the free connection timeout for this pool.

See Also:

PoolFactory.DEFAULT_FREE_CONNECTION_TIMEOUT

Default:

10000

idleTimeout

public abstract long idleTimeout

Configures the amount of time a connection can be idle before expiring the connection.

See Also:

PoolFactory.DEFAULT_IDLE_TIMEOUT

Default:

5000L

keepAlive

public abstract boolean keepAlive

Configures whether to keep the client queues alive on the server when the client is disconnected Default is false.

Default:

false

loadConditioningInterval

public abstract int loadConditioningInterval

Configures the load conditioning interval for this pool.

See Also:

PoolFactory.DEFAULT_LOAD_CONDITIONING_INTERVAL

Default:

300000

locators

public abstract ClientCacheApplication.Locator[] locators

Configures the GemFire Locators to which this cache client will connect.

Default:

{}

logLevel

public abstract String logLevel

Configures the log level used to output log messages at GemFire cache runtime. Default is config.

Default:

"config"

maxConnections

public abstract int maxConnections

Configures the max number of client to server connections that the pool will create.

See Also:

PoolFactory.DEFAULT_MAX_CONNECTIONS

Default:

-1

minConnections

public abstract int minConnections

Configures the minimum number of connections to keep available at all times.

See Also:

PoolFactory.DEFAULT_MIN_CONNECTIONS

Default:

1

multiUserAuthentication

public abstract boolean multiUserAuthentication

If set to true then the created pool can be used by multiple users.

See Also:

PoolFactory.DEFAULT_MULTIUSER_AUTHENTICATION

Default:

false

name

public abstract String name

Configures the name of this GemFire member in the cluster (distributed system). Default is SpringBasedCacheClientApplication.

Default:

"SpringBasedCacheClientApplication"

pingInterval

public abstract long pingInterval

Configures how often to ping servers to verify that they are still alive.

See Also:

PoolFactory.DEFAULT_PING_INTERVAL

Default:

10000L

prSingleHopEnabled

public abstract boolean prSingleHopEnabled

By default prSingleHopEnabled is true in which case the client is aware of the location of partitions on servers hosting Regions with DataPolicy.PARTITION.

See Also:

PoolFactory.DEFAULT_PR_SINGLE_HOP_ENABLED

Default:

true

readTimeout

public abstract int readTimeout

Configures the number of milliseconds to wait for a response from a server before timing out the operation and trying another server (if any are available).

See Also:

PoolFactory.DEFAULT_READ_TIMEOUT

Default:

10000

readyForEvents

public abstract boolean readyForEvents

Notifies the server that this durable client is ready to receive updates. Default is false.

Default:

false

retryAttempts

public abstract int retryAttempts

Configures the number of times to retry a request after timeout/exception.

See Also:

PoolFactory.DEFAULT_RETRY_ATTEMPTS

Default:

-1

serverGroup

public abstract String serverGroup

Configures the group that all servers in which this pool connects to must belong to.

See Also:

PoolFactory.DEFAULT_SERVER_GROUP

Default:

""

servers

public abstract ClientCacheApplication.Server[] servers

Configures the GemFire CacheServers to which this cache client will connect.

Default:

{}

socketBufferSize

public abstract int socketBufferSize

Configures the socket buffer size for each connection made in this pool.

See Also:

PoolFactory.DEFAULT_SOCKET_BUFFER_SIZE

Default:

32768

statisticInterval

public abstract int statisticInterval

Configures how often to send client statistics to the server.

See Also:

PoolFactory.DEFAULT_STATISTIC_INTERVAL

Default:

-1

subscriptionAckInterval

public abstract int subscriptionAckInterval

Configures the interval in milliseconds to wait before sending acknowledgements to the cache server for events received from the server subscriptions.

See Also:

PoolFactory.DEFAULT_SUBSCRIPTION_ACK_INTERVAL

Default:

100

subscriptionEnabled

public abstract boolean subscriptionEnabled

If set to true then the created pool will have server-to-client subscriptions enabled.

See Also:

PoolFactory.DEFAULT_SUBSCRIPTION_ENABLED

Default:

false

subscriptionMessageTrackingTimeout

public abstract int subscriptionMessageTrackingTimeout

Configures the messageTrackingTimeout attribute which is the time-to-live period, in milliseconds, for subscription events the client has received from the server.

See Also:

PoolFactory.DEFAULT_SUBSCRIPTION_MESSAGE_TRACKING_TIMEOUT

Default:

900000

subscriptionRedundancy

public abstract int subscriptionRedundancy

Configures the redundancy level for this pools server-to-client subscriptions.

See Also:

PoolFactory.DEFAULT_SUBSCRIPTION_REDUNDANCY

Default:

0

threadLocalConnections

public abstract boolean threadLocalConnections

Configures the thread local connections policy for this pool.

See Also:

PoolFactory.DEFAULT_THREAD_LOCAL_CONNECTIONS

Default:

false

useBeanFactoryLocator

public abstract boolean useBeanFactoryLocator

Determines whether the GemfireBeanFactoryLocator should be enabled to lookup the Spring BeanFactory to auto-wire and configure/initialize GemFire components created in a non-Spring managed, GemFire context. Defaults to false.

Default:

false