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:
You run the service on a disabled cache.
The service cannot find the specified key.
The element associated with the specified key is expired.
Integration Server issues a ServiceException in the following cases:
If
useLoader is
true and no loaders are configured for the cache.
If you do not specify all required input parameters.
If
Integration Server cannot find the specified cache manager or cache.
If a cache operation fails.