VMware GemFire Java API Reference
Package org.apache.geode.cache.client
org.apache.geode.cache.client package provides APIs used
for client connectivity and caching.
Most clients will only need to create a
ClientCache
using a
ClientCacheFactory.
A client configures the servers it will connect to by creating one or more
pools.
For most use cases one pool per client is all you need and the easiest
way to get a single pool is to use
ClientCacheFactory.
If you do need more than one pool use a
pool factory obtained from the
pool manager before you
create the cache using
ClientCacheFactory.
An alternative to these APIs is to use the pool XML element
as described in the cache6_5.dtd.
If you create more than one pool then for regions that will use a pool you
need to configure the pool name on the regions.
This can be done by setting the
pool name on the region using the
API
or using the pool-name attribute on the region-attributes
as described in the cache6_5.dtd.
Client Declarative Caching
A "caching XML file" declares regions, entries, and attributes. When
a ClientCache is created its contents can be initialized
according to a caching XML file.
The top level element must be a client-cache element.
The Document Type Definition for a declarative cache XML file can
be found in "doc-files/cache6_5.dtd".
For examples of declarative cache XML files see example1.
-
ClassDescriptionIndicates that the connection pool is at its maximum size and all connections are in use.A ClientCache instance controls the life cycle of the local singleton cache in a client.Factory class used to create the singleton
client cacheand connect to one or more GemFire Cache Servers.Deprecated.as of 6.5 this exception is no longer thrown by GemFire so any code that catches it should be removed.ClientRegionFactory<K,V> A factory for constructingclient cacheregions.Each enum represents a predefinedRegionAttributesin aClientCache.ADuplicateClientIdExceptionindicates a client attempted to connect to a server with a duplicate client Id.An exception indicating that there are no active locators available to connect to.An exception indicating that there are no active servers available to connect to.A pool for connections from a client to a set of GemFire Cache Servers.This interface provides for the configuration and creation of instances ofPool.Manages creation and access toconnection poolsfor clients.A generic exception indicating that a failure has happened while communicating with a gemfire server.An exception indicating that a failure has happened on the server while processing an operation that was sent to it by a client.AServerRefusedConnectionExceptionindicates a client attempted to connect to a server, but the handshake was rejected.A socket factory used to create sockets from a client to locators or servers.An exception indicating that client subscriptions are not enabled on this client, but the client is trying to perform an operation that requires a client subscription, such asRegion.registerInterest(Object).