Managing a Client Cache
Managing a Client Cache
You have several options for client cache configuration. Start your client cache using a combination of XML declarations and API calls. Close the client cache when you are done.
GemFire clients are processes that send most or all of their data requests and updates to a GemFire server system. Clients run as standalone processes, without peers of their own.
- Create your client cache:
- In your
cache.xml, use the client-cache
DOCTYPE and configure your cache inside a
<client-cache> element. Configure your server
connection pool and your regions as needed. Example:
<?xml version="1.0" encoding="UTF-8"?> <client-cache xmlns="http://schema.pivotal.io/gemfire/cache" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://schema.pivotal.io/gemfire/cache http://schema.pivotal.io/gemfire/cache/cache-8.1.xsd" version="8.1"> <pool name="serverPool"> <locator host="host1" port="44444"/> </pool> <region name="exampleRegion" refid="PROXY"/> </client-cache>Note: Applications that use a client-cache may want to set concurrency-checks-enabled to false for a region in order to see all events for that region. GemFire server members can continue using concurrency checks, but they will pass all events to the client cache. This configuration ensures that the client sees all region events, but it does not prevent the client cache region from becoming out-of-sync with the server cache. See Consistency for Region Updates.
- If you use multiple server
pools, configure the pool name explicitly for each client region.
<pool name="svrPool1"> <locator host="host1" port="40404"/> </pool> <pool name="svrPool2"> <locator host="host2" port="40404"/> </pool> <region name="clientR1" refid="PROXY" pool-name="svrPool1"/> <region name="clientR2" refid="PROXY" pool-name="svrPool2"/> <region name="clientsPrivateR" refid="LOCAL"/>
- In your Java client
application, create the cache using the
create method. Example:
ClientCache clientCache = new ClientCacheFactory().create();This creates the server connections and initializes the client’s cache according to your gemfire.properties and cache.xml specifications.
- In your cache.xml, use the client-cache DOCTYPE and configure your cache inside a <client-cache> element. Configure your server connection pool and your regions as needed. Example:
- Close your cache when you are done
using the close method of your Cache instance:
cache.close();If your client is durable and you want to maintain your durable queues while the client cache is closed, use: