Configuring the near cache

You can configure your clients to have a local, in-line cache. This optional cache is called a near cache, an independent data grid on each client, serving as a cache for the remote, server-side cache. The near cache is enabled by default when locking is disabled, or is configured as optimistic, and cannot be used when configured as pessimistic.

1. You can enable a near cache to be created on the client by setting the dynamic map name. You must set the dynamic map to have optimistic locking or no locking. Examples of map names that have a near-cache enabled follow:

   my_grid.NONE
   my_grid.NONE.O

   For more information, see Configuring dynamic maps. For a list of dynamic map configuration options, see Dynamic map configuration options.
2. Set the nearCacheCopyMode copy mode in the ObjectGrid descriptor XML file, or set the copy mode programmatically using the BackingMapConfiguration.setNearCacheCopyMode method. You can set the copy mode to nearCacheCopyMode only if the server is COPY_TO_BYTES or COPY_TO_BYTES_RAW. The copy mode is disabled by default; for example:

   XML file example

   backingMap name="default" nearCacheCopyMode="NO_COPY" readOnly="true" /

   Programmatic example

   ObjectGridConfiguration copyModeConfig = ObjectGridConfigFactory.createObjectGridConfiguration("copyModeGrid");
   BackingMapConfiguration defaultMapConfig = ObjectGridConfigFactory.createBackingMapConfiguration("default");
   	        defaultMapConfig.setNearCacheCopyMode(CopyMode.NO_COPY);
   	        defaultMapConfig.setReadOnly(true);
   	        copyModeConfig.addBackingMapConfiguration(defaultMapConfig);