Package org.infinispan.container.entries
Class TransientMortalCacheEntry
- java.lang.Object
-
- org.infinispan.container.entries.AbstractInternalCacheEntry
-
- org.infinispan.container.entries.TransientMortalCacheEntry
-
- All Implemented Interfaces:
Cloneable
,Map.Entry
,CacheEntry
,InternalCacheEntry
,MetadataAware
public class TransientMortalCacheEntry extends AbstractInternalCacheEntry
A cache entry that is both transient and mortal.- Since:
- 4.0
- Author:
- Manik Surtani
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
TransientMortalCacheEntry.Externalizer
-
Field Summary
Fields Modifier and Type Field Description protected long
created
protected long
lastUsed
protected long
lifespan
protected long
maxIdle
-
Fields inherited from class org.infinispan.container.entries.AbstractInternalCacheEntry
internalMetadata, key, value
-
-
Constructor Summary
Constructors Modifier Constructor Description TransientMortalCacheEntry(Object key, Object value, long maxIdle, long lifespan, long currentTimeMillis)
TransientMortalCacheEntry(Object key, Object value, long maxIdle, long lifespan, long lastUsed, long created)
protected
TransientMortalCacheEntry(Object key, Object value, PrivateMetadata internalMetadata, long maxIdle, long lifespan, long lastUsed, long created)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
appendFieldsToString(StringBuilder builder)
boolean
canExpire()
boolean
canExpireMaxIdle()
TransientMortalCacheEntry
clone()
long
getCreated()
long
getExpiryTime()
Only used with entries that have a lifespan, this determines when an entry is due to expire.long
getLastUsed()
long
getLifespan()
long
getMaxIdle()
Metadata
getMetadata()
Get metadata of this cache entry.boolean
isExpired(long now)
void
reincarnate(long now)
"Reincarnates" an entry.void
setLifespan(long lifespan)
void
setMaxIdle(long maxIdle)
void
setMetadata(Metadata metadata)
Set the metadata in the cache entry.InternalCacheValue<?>
toInternalCacheValue()
Creates a representation of this entry as anInternalCacheValue
.void
touch(long currentTimeMillis)
Updates access timestamps on this instance to a specified time-
Methods inherited from class org.infinispan.container.entries.AbstractInternalCacheEntry
commit, equals, getInternalMetadata, getKey, getValue, hashCode, isChanged, isCreated, isEvicted, isL1Entry, isNull, isRemoved, setChanged, setCreated, setEvicted, setInternalMetadata, setRemoved, setSkipLookup, setValue, skipLookup, toString
-
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.infinispan.container.entries.CacheEntry
setCreated, setLastUsed
-
-
-
-
Constructor Detail
-
TransientMortalCacheEntry
public TransientMortalCacheEntry(Object key, Object value, long maxIdle, long lifespan, long currentTimeMillis)
-
TransientMortalCacheEntry
public TransientMortalCacheEntry(Object key, Object value, long maxIdle, long lifespan, long lastUsed, long created)
-
TransientMortalCacheEntry
protected TransientMortalCacheEntry(Object key, Object value, PrivateMetadata internalMetadata, long maxIdle, long lifespan, long lastUsed, long created)
-
-
Method Detail
-
setLifespan
public void setLifespan(long lifespan)
-
setMaxIdle
public void setMaxIdle(long maxIdle)
-
getLifespan
public long getLifespan()
- Returns:
- retrieves the lifespan of this entry. -1 means an unlimited lifespan.
-
canExpire
public final boolean canExpire()
- Returns:
- true if the entry can expire, false otherwise
-
canExpireMaxIdle
public boolean canExpireMaxIdle()
- Returns:
- true if this entry can expire via max idle, false otherwise
-
getCreated
public long getCreated()
- Returns:
- timestamp when the entry was created
-
isExpired
public boolean isExpired(long now)
- Parameters:
now
- the current time as defined bySystem.currentTimeMillis()
orTimeService.wallClockTime()
- Returns:
- true if the entry has expired; false otherwise
-
getExpiryTime
public final long getExpiryTime()
Description copied from interface:InternalCacheEntry
Only used with entries that have a lifespan, this determines when an entry is due to expire.- Returns:
- timestamp when the entry is due to expire, or -1 if it doesn't have a lifespan
-
toInternalCacheValue
public InternalCacheValue<?> toInternalCacheValue()
Description copied from interface:InternalCacheEntry
Creates a representation of this entry as anInternalCacheValue
. The main purpose of this is to provide a representation that does not have a reference to the key. This is useful in situations where the key is already known or stored elsewhere, making serialization and deserialization more efficient. Note that this should not be used to optimize memory overhead, since the saving of an additional reference to a key (a single object reference) does not warrant the cost of constructing an InternalCacheValue. This only makes sense when marshalling is involved, since the cost of marshalling the key again can be sidestepped using an InternalCacheValue if the key is already known/marshalled.- Returns:
- a new InternalCacheValue encapsulating this InternalCacheEntry's value and expiration information.
-
getLastUsed
public long getLastUsed()
- Returns:
- timestamp when the entry was last used
-
touch
public final void touch(long currentTimeMillis)
Description copied from interface:InternalCacheEntry
Updates access timestamps on this instance to a specified time- Parameters:
currentTimeMillis
- the current time as defined bySystem.currentTimeMillis()
orTimeService.wallClockTime()
-
reincarnate
public void reincarnate(long now)
Description copied from interface:InternalCacheEntry
"Reincarnates" an entry. Essentially, resets the 'created' timestamp of the entry to the current time.- Parameters:
now
- the current time as defined bySystem.currentTimeMillis()
orTimeService.wallClockTime()
-
getMaxIdle
public long getMaxIdle()
- Returns:
- the maximum allowed time for which this entry can be idle, after which it is considered expired.
-
getMetadata
public Metadata getMetadata()
Description copied from interface:MetadataAware
Get metadata of this cache entry.- Specified by:
getMetadata
in interfaceMetadataAware
- Overrides:
getMetadata
in classAbstractInternalCacheEntry
- Returns:
- a Metadata instance
-
setMetadata
public void setMetadata(Metadata metadata)
Description copied from interface:MetadataAware
Set the metadata in the cache entry.- Specified by:
setMetadata
in interfaceMetadataAware
- Overrides:
setMetadata
in classAbstractInternalCacheEntry
- Parameters:
metadata
- to apply to the cache entry
-
clone
public TransientMortalCacheEntry clone()
- Specified by:
clone
in interfaceCacheEntry
- Specified by:
clone
in interfaceInternalCacheEntry
- Overrides:
clone
in classAbstractInternalCacheEntry
-
appendFieldsToString
protected void appendFieldsToString(StringBuilder builder)
- Overrides:
appendFieldsToString
in classAbstractInternalCacheEntry
-
-