pub.cache.atomic:putIfAbsent

WmPublic. Adds an element to the cache if the cache does not contain an element with the specified key.

Input Parameters

cacheManagerName	String Name of the cache manager that manages the cache. This parameter is case sensitive.
cacheName	String Name of the cache to which to add the element. This parameter is case sensitive.
key	Object Key of the element.
value	Object Value to add to the element.

Output Parameters

keyExists	String Indicates whether an element with the specified key exists in the cache. true indicates that an element with the key already exists in the cache. false indicates that an element with the key does not exist in the cache.
oldValue	Object Conditional. Value of the element that already exists in the cache. Returned only if keyExists is true.

Usage Notes

The pub.cache.atomic:putIfAbsent service adds the specified value to the cache only if the specified key does not already exist in the cache. If the specified key already exists in the cache, pub.cache.atomic:putIfAbsent returns true for keyExists and the value of the cached element for oldValue.

Integration Server issues a ServiceException in the following cases:

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.