Integration Server 10.3 | Built-In Services Reference Guide | Cache Folder | Summary of Elements in this Folder | pub.cache:getAll
 
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.