Recuperar un CacheManager (gestor de memoria caché) de eXtreme Scale

Puede recuperar una instancia de CacheManager local o distribuida del proveedor de almacenamiento en memoria caché de WebSphere® eXtreme Scale . Una instancia de CacheManager es como una instancia de eXtreme Scale ObjectGrid . La Sección 4 de la API JCache proporciona información sobre gestores de memoria caché y el comportamiento de la API CacheManager.

Antes de empezar

Habilite una aplicación para acceder a una instancia de CacheManager. Consulte Especificación de eXtreme Scale como CachingProvider.

Leer el eXtreme Scale Interfaz JCache CachingProviderImpl especificación para obtener una lista de las propiedades de configuración que puede pasar a ungetCacheManager llamar.

Procedimiento

Cree una instancia de CacheManager sólo local.
Nota: Una instancia local está en la misma máquina virtual Java™ (JVM) que el cliente. En la modalidad local, todo se ejecuta en una única JVM.
- Para crear un CacheManager denominado DEFAULT sin memorias caché configuradas:
```
CacheManager localWXSManager = wxsProvider.getCacheManager();
```
- Para crear un CacheManager denominado wxsCacheManager sin memorias caché configuradas:
```
CacheManager localWXSManager = wxsProvider.getCacheManager(CachingProviderImpl.createLocalURI("wxsCacheManager", null);
```
- Para crear un CacheManager denominado existingCacheManager basado en un archivo objectGrid.xml existente que se encuentra en /opt/objectGrid.xml:
```
URI objectGridXML = new File("/opt/objectGrid.xml").toURI();

Properties props = new Properties();

props.put(CachingProviderImpl.PROP_LOCAL_CACHE_XML_URI, objectGridXML);

CacheManager existingCacheManager = wxsProvider.getCacheManager(CachingProviderImpl.createLocalURI("myOG"), null, props);
```
  En este ejemplo, el archivo objectGrid.xml debe definir un ObjectGrid denominado myOG.
Cree una instancia de CacheManager distribuida.
Nota: Una instancia distribuida es remota. En la modalidad remota, configure los servidores de catálogo y de contenedor en una o varias ubicaciones remotas.

Para crear una instancia de CacheManager distribuida, recupere una instancia de CacheManager remota. Una configuración de eXtreme Scale distribuida existente debe estar en ejecución.
- Para recuperar un CacheManager remoto con un cliente que se ejecuta en una JVM autónoma, puede utilizar un objeto Properties con PROP_CATALOG_END_POINTS:
```
URI clientCacheManagerURI = CachingProviderImpl.createClientURI("myDistributedOG", null, null);

Properties props = new Properties();

props.put(CachingProviderImpl.PROP_CATALOG_END_POINTS, "myHost1:2809,myHost2:2809,myHost3:2809");

CacheManager wxsDistributedCacheManager = wxsProvider.getCacheManager(clientCacheManagerURI, null, props);
```
  En este ejemplo, los puntos finales de servicio de catálogo de la configuración son myHost1:2809, myHost2:2809 y myHost3:2809. Además, debe existir un ObjectGrid denominado myDistributedOG.
- Para recuperar un CacheManager remoto con un cliente que se ejecuta en una JVM de WebSphere Application Server o Liberty, puede utilizar un dominio de servicio de catálogo configurado:
```
URI clientCacheManagerURI = CachingProviderImpl.createClientURI("myDistributedOG", "myCatDomain", null);

CacheManager wxsDistributedCacheManager = wxsProvider.getCacheManager(clientCacheManagerURI, null, null);
```
  En este ejemplo, debe existir un dominio de servicio de catálogo denominado myCatDomain y un ObjectGrid denominado myDistributedOG. El objeto Properties con PROP_CATALOG_END_POINTS no es necesario porque el dominio de servicio de catálogo ya contiene esa información de conexión, incluida la configuración de seguridad.

Qué hacer a continuación

Después de crear una instancia de CacheManager, puede acceder a una memoria caché definida anteriormente, crear una memoria caché o suprimir una memoria caché existente.