interface TimestampRegion implements Region (View source)

Defines the contract for a cache region which will specifically be used to store entity "update timestamps".

Methods

CacheEntry[]|null
getMultiple(CollectionCacheEntry $collection)

Get all items from the cache identified by $keys.

string
getName()

Retrieve the name of this region.

from Region
boolean
contains(CacheKey $key)

Determine whether this region contains data for the given key.

from Region
CacheEntry|null
get(CacheKey $key)

Get an item from the cache.

from Region
put(CacheKey $key, CacheEntry $entry, Lock $lock = null)

Put an item into the cache.

from Region
evict(CacheKey $key)

Remove an item from the cache.

from Region
evictAll()

Remove all contents of this particular cache region.

from Region
update(CacheKey $key)

Update an specific key into the cache region.

Details

CacheEntry[]|null getMultiple(CollectionCacheEntry $collection)

Get all items from the cache identified by $keys.

It returns NULL if some elements can not be found.

Parameters

CollectionCacheEntry $collection The collection of the items to be retrieved.

Return Value

CacheEntry[]|null The cached entries or NULL if one or more entries can not be found

string getName()

Retrieve the name of this region.

Return Value

string The region name

boolean contains(CacheKey $key)

Determine whether this region contains data for the given key.

Parameters

CacheKey $key The cache key

Return Value

boolean TRUE if the underlying cache contains corresponding data; FALSE otherwise.

CacheEntry|null get(CacheKey $key)

Get an item from the cache.

Parameters

CacheKey $key The key of the item to be retrieved.

Return Value

CacheEntry|null The cached entry or NULL

Exceptions

CacheException Indicates a problem accessing the item or region.

put(CacheKey $key, CacheEntry $entry, Lock $lock = null)

Put an item into the cache.

Parameters

CacheKey $key The key under which to cache the item.
CacheEntry $entry The entry to cache.
Lock $lock The lock previously obtained.

Exceptions

CacheException Indicates a problem accessing the region.

evict(CacheKey $key)

Remove an item from the cache.

Parameters

CacheKey $key The key under which to cache the item.

Exceptions

CacheException Indicates a problem accessing the region.

evictAll()

Remove all contents of this particular cache region.

Exceptions

CacheException Indicates problem accessing the region.

update(CacheKey $key)

Update an specific key into the cache region.

Parameters

CacheKey $key The key of the item to update the timestamp.

Exceptions

LockException Indicates a problem accessing the region.