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

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 an InternalCacheValue.
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

Field Detail

maxIdle

protected long maxIdle

lastUsed

protected long lastUsed

lifespan

protected long lifespan

created

protected long created

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 by System.currentTimeMillis() or TimeService.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 an InternalCacheValue. 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 by System.currentTimeMillis() or TimeService.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 by System.currentTimeMillis() or TimeService.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 interface MetadataAware

Overrides:

getMetadata in class AbstractInternalCacheEntry

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 interface MetadataAware

Overrides:

setMetadata in class AbstractInternalCacheEntry

Parameters:

metadata - to apply to the cache entry

clone

public TransientMortalCacheEntry clone()

Specified by:

clone in interface CacheEntry

Specified by:

clone in interface InternalCacheEntry

Overrides:

clone in class AbstractInternalCacheEntry

appendFieldsToString

protected void appendFieldsToString(StringBuilder builder)

Overrides:

appendFieldsToString in class AbstractInternalCacheEntry