com.trivago.triava.tcache

Interface TCacheHolder<V>

Type Parameters:

V - The value type

All Superinterfaces:

Serializable

All Known Implementing Classes:

AccessTimeObjectHolder

public interface TCacheHolder<V>
extends Serializable

Represents a Cache value with associated metadata like use count and access count.

Author:

cesken

Method Summary

Modifier and Type	Method and Description
V	get() Returns the value, that this holder holds.
long	getCreationTime() Returns the creation time of this holder, given in ms since EPOCH.
long	getExpirationTime() Returns the expiration time, given in ms since EPOCH.
long	getLastAccessTime() Returns the last access time, given in MILLISECONDS since EPOCH
int	getUseCount() Returns the number of times this holder was accessed.
boolean	isInvalid() Returns whether this holder is valid.
V	peek() Returns the value, that this holder holds.

Method Detail

get

V get()

Returns the value, that this holder holds. Statistics effects: Updates the access time and the use count.

Returns:

The value

peek

V peek()

Returns the value, that this holder holds. This method differs from get() in that peek has no side effects on entry statistics.

Returns:

The value

getLastAccessTime

long getLastAccessTime()

Returns the last access time, given in MILLISECONDS since EPOCH

Returns:

the last access time

getUseCount

int getUseCount()

Returns the number of times this holder was accessed.

Returns:

the use count

getCreationTime

long getCreationTime()

Returns the creation time of this holder, given in ms since EPOCH. The creation time represents the time the holder was put into the cache. Any put including replacing an existing entry will create a new holder with the current time as creation time.

Returns:

The creation time in ms

getExpirationTime

long getExpirationTime()

Returns the expiration time, given in ms since EPOCH.

Returns:

The expiration time in ms

isInvalid

boolean isInvalid()

Returns whether this holder is valid. A formerly valid holder can become invalid when it expires, and this method reflects that: An expired holder is invalid.

Returns:

true if it is invalid. This includes expired holders.