pub.cache:getAll
WmPublic. Retrieves the values of the cached elements for the specified keys.
Input Parameters
cacheManagerName | String Name of the cache manager that manages the cache. This parameter is case sensitive. |
cacheName | String Name of the cache from which to retrieve the elements. This parameter is case sensitive. |
keys | Object List Keys associated with the cached elements for which you want to retrieve values. |
useLoader | String Optional. Indicates whether to use a cache loader to retrieve the elements from the cache. Set to: true to use a cache loader to retrieve an element if the element is not already in the cache. Note: | If useLoader is true and no loaders are configured for the cache, Integration Server issues a ServiceException. |
false to retrieve an element from the cache without a cache loader. This is the default setting. |
Output Parameters
elements | Document List An IData[] containing the values for the requested cached elements. |
| Key | Description |
| key | Object Key associated with the cached element. |
| value | Object Value of the element retrieved from the cache. |
Usage Notes
The pub.cache:getAll service can be memory-intensive because it loads all of the specified keys into memory.
If useLoader is set to false and pub.cache:get finds the key in the cache, the results contain the value of the element. If the key does not exist in the cache, pub.cache:getAll returns a null in the value parameter.
If useLoader is set to true and pub.cache:get cannot find the specified key in the cache, it uses the configured cache loader to find the key in the system-of-record (SOR). If the SOR contains the key, pub.cache:get returns the value of the element. If the key does not exist in the SOR, pub.cache:getAll returns a null in the value parameter.
The pub.cache:getAll service returns a null in the elements/value parameter if:
![*](bullet.gif)
You run the service on a disabled cache.
![*](bullet.gif)
The service cannot find the specified key.
![*](bullet.gif)
The element associated with the specified key is expired.
Integration Server issues a ServiceException in the following cases:
![*](bullet.gif)
If
useLoader is
true and no loaders are configured for the cache.
![*](bullet.gif)
If you do not specify all required input parameters.
![*](bullet.gif)
If
Integration Server cannot find the specified cache manager or cache.
![*](bullet.gif)
If a cache operation fails.