org.jboss.as.ejb3.cache.impl.backing

Class NonPassivatingBackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

java.lang.Object

org.jboss.as.ejb3.cache.spi.impl.AbstractBackingCacheEntry<K,V>

org.jboss.as.ejb3.cache.impl.backing.NonPassivatingBackingCacheEntry<K,V>

All Implemented Interfaces:

Serializable, Comparable<BackingCacheEntry<K,V>>, Cacheable<K>, Identifiable<K>, BackingCacheEntry<K,V>

public class NonPassivatingBackingCacheEntry<K extends Serializable,V extends Cacheable<K>>
extends AbstractBackingCacheEntry<K,V>
implements BackingCacheEntry<K,V>

Basic BasicCacheEntry implementation for use with a non-passivating BackingCache. A wrapper for the Cacheable to allow it to be managed by the backing cache .

Author:

Brian Stansberry, Paul Ferraro

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NonPassivatingBackingCacheEntry(V wrapped) Create a new SimpleBackingCacheEntry.

Method Summary

Methods

Modifier and Type	Method and Description
K	getId() The object identifier.
V	getUnderlyingItem() Gets the underlying CacheItem.
void	invalidate() Causes BackingCacheEntry.isValid() to hereafter return true.
boolean	isModified() Gets whether this object's internal state has been modified since the last request to this method.
boolean	isValid() Whether this entry has been invalidated (in which case it should be reacquired).
void	lock() Lock this item, blocking until the lock is acquired.
boolean	tryLock() Attempt to lock this item, failing promptly if the lock is already held by another thread.
void	unlock() Unlock this item.

Methods inherited from class org.jboss.as.ejb3.cache.spi.impl.AbstractBackingCacheEntry

compareTo, equals, getLastUsed, hashCode, isInUse, isPrePassivated, setInUse, setLastUsed, setPrePassivated

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jboss.as.ejb3.cache.spi.BackingCacheEntry

getLastUsed, isInUse, isPrePassivated, setInUse, setPrePassivated

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

NonPassivatingBackingCacheEntry

public NonPassivatingBackingCacheEntry(V wrapped)

Create a new SimpleBackingCacheEntry.

Parameters:

wrapped - the item to wrap

Method Detail

getUnderlyingItem

public V getUnderlyingItem()

Description copied from interface: BackingCacheEntry

Gets the underlying CacheItem.

Specified by:

getUnderlyingItem in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

Returns:

isModified

public boolean isModified()

Description copied from interface: Cacheable

Gets whether this object's internal state has been modified since the last request to this method.

Implementations must be aggressive about returning true if they are uncertain about whether they have been modified; false should only be returned if the implementing object is certain its internal state has not been modified.

Specified by:

isModified in interface Cacheable<K extends Serializable>

Returns:

true if the state has been modified or the implementing object does not know; false otherwise.

getId

public K getId()

The object identifier.

Specified by:

getId in interface Identifiable<K extends Serializable>

Returns:

the id of the underlying item. Cannot be null.

lock

public void lock()

Description copied from interface: BackingCacheEntry

Lock this item, blocking until the lock is acquired. Has the same semantics as , except that a RuntimeException will be thrown if the thread is interrupted instead of InterruptedException.

Specified by:

lock in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

tryLock

public boolean tryLock()

Description copied from interface: BackingCacheEntry

Attempt to lock this item, failing promptly if the lock is already held by another thread. Has the same semantics as .

Specified by:

tryLock in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

Returns:

true if the lock was acquired, false otherwise

unlock

public void unlock()

Description copied from interface: BackingCacheEntry

Unlock this item. Has the same semantics as .

Specified by:

unlock in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

invalidate

public void invalidate()

Description copied from interface: BackingCacheEntry

Causes BackingCacheEntry.isValid() to hereafter return true.

NOTE: This method should only be called with the lock held.

Specified by:

invalidate in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

Overrides:

invalidate in class AbstractBackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

isValid

public boolean isValid()

Description copied from interface: BackingCacheEntry

Whether this entry has been invalidated (in which case it should be reacquired).

NOTE: This method should only be called with the lock held.

Specified by:

isValid in interface BackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

Overrides:

isValid in class AbstractBackingCacheEntry<K extends Serializable,V extends Cacheable<K>>

Returns:

truee if still valid, falsee if invalidated

See Also:

BackingCacheEntry.invalidate()