diff --git a/docs/src/reference/docbook/reference/bootstrap.xml b/docs/src/reference/docbook/reference/bootstrap.xml index 1ce9d412..f6df954b 100644 --- a/docs/src/reference/docbook/reference/bootstrap.xml +++ b/docs/src/reference/docbook/reference/bootstrap.xml @@ -226,6 +226,49 @@ allows potential regions, listener, writers or instantiators defined declaratively to be fully initialized and registered before the server starts accepting connections. Keep this in mind when doing programmatic configuration of the items above as the server might start before your components and thus not be seen by the clients connecting right away. + +
+ Configuring a GemFire <literal>ClientCache</literal> + + Another configuration addition in SGF 1.1 is the dedicated support for configuring + ClientCache - + similar to a cache (in both usage and definition) - through the org.springframework.data.gemfire.client package and in particular + ClientCacheFactoryBean. + + + + + + + +]]> + + client-cache supports much of the same options as the cache element. However as oppose to a vanilla cache, + a client cache connects to a server through a pool (by default a pool is created to connect to a server on localhost and 40404 - + the default pool is used by all client cache regions (unless configured to use a different pool)). + + Pools can be defined through the pool; in case of client caches and regions pools can be used to customize the connectivity to the server for + individual entities or for the entire cache. For example, to custommize the default pool used by client-cache, one needs to define a pool and wire it to cache definition: + + + + + + + + + + +]]> +
@@ -500,13 +543,19 @@ redundancy. Each copy provides extra backup at the expense of extra storages.GemFire supports various deployment topologies for managing and distributing data. The topic is outside the scope of this documentation however to quickly recap, they can be categoried in short in: peer-to-peer (p2p), client-server (or super-peer cache network) and wide area cache network (or WAN). In the last two scenarios, it is common - to declare client regions which connect to a backing cache server (or super peer). SGF offers dedicated support for such configuration through the - client-region and pool elements. + to declare client regions which connect to a backing cache server (or super peer). SGF offers dedicated support for such configuration through + , client-region and pool elements. As the name imply, the former defines a client region while the latter connection pools to be used/shared by the various client regions. Below is a usual configuration for a client region: - + + + + + + + @@ -514,8 +563,8 @@ redundancy. Each copy provides extra backup at the expense of extra storages. - - + + ]]> Just as the other region types, client-region allows defining CacheListeners. It also relies on the same naming conventions