Package org.infinispan.expiration.impl
Class ExpirationManagerImpl<K,V>
java.lang.Object
org.infinispan.expiration.impl.ExpirationManagerImpl<K,V>
- All Implemented Interfaces:
ExpirationManager<K,
,V> InternalExpirationManager<K,
V>
- Direct Known Subclasses:
ClusterExpirationManager
@ThreadSafe
public class ExpirationManagerImpl<K,V>
extends Object
implements InternalExpirationManager<K,V>
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.infinispan.expiration.impl.InternalExpirationManager
InternalExpirationManager.ExpirationConsumer<T,
U> -
Field Summary
Modifier and TypeFieldDescriptionprotected AdvancedCache
<K, V> protected String
protected CacheNotifier
<K, V> protected ComponentRef
<AdvancedCache<K, V>> protected Configuration
protected ComponentRef
<InternalDataContainer<K, V>> protected boolean
protected ScheduledExecutorService
protected ScheduledFuture
<?> protected ConcurrentMap
<K, CompletableFuture<Boolean>> This map is used for performance reasons.protected KeyPartitioner
protected org.infinispan.persistence.manager.PersistenceManager
protected TimeService
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Adds anInternalExpirationManager.ExpirationConsumer
to be invoked when an entry is expired.protected CompletionStage
<Boolean> checkExpiredMaxIdle
(InternalCacheEntry<?, ?> entry, int segment, long currentTime) Response is whether the value should be treated as expired.entryExpiredInMemory
(InternalCacheEntry<K, V> entry, long currentTime, boolean hasLock) This should be invoked passing in an entry that is now expired.This is to be invoked when a store entry expires.handleInStoreExpirationInternal
(MarshallableEntry<K, V> marshalledEntry) This is to be invoked when a store entry expires and the value and/or metadata is available to be used.handlePossibleExpiration
(InternalCacheEntry<K, V> ice, int segment, boolean isWrite) Handles processing for an entry that may be expired.boolean
void
Processes the expiration event queue.void
removeInternalListener
(Object listener) Removes a previous registeredInternalExpirationManager.ExpirationConsumer
.void
start()
void
stop()
-
Field Details
-
executor
-
configuration
-
persistenceManager
protected org.infinispan.persistence.manager.PersistenceManager persistenceManager -
dataContainer
-
cacheNotifier
-
timeService
-
keyPartitioner
-
cacheRef
-
enabled
protected boolean enabled -
cacheName
-
cache
-
expiring
This map is used for performance reasons. Essentially when an expiration event should not be raised this map should be populated first. The main examples are if an expiration is about to occur for that key or the key will be removed or updated. In the latter case we don't want to send an expiration event and then a remove event when we could do just the removal. -
expirationTask
-
-
Constructor Details
-
ExpirationManagerImpl
public ExpirationManagerImpl()
-
-
Method Details
-
start
public void start() -
processExpiration
public void processExpiration()Description copied from interface:ExpirationManager
Processes the expiration event queue.- Specified by:
processExpiration
in interfaceExpirationManager<K,
V>
-
isEnabled
public boolean isEnabled()- Specified by:
isEnabled
in interfaceExpirationManager<K,
V> - Returns:
- true if expiration reaper thread is enabled, false otherwise
-
entryExpiredInMemory
public CompletableFuture<Boolean> entryExpiredInMemory(InternalCacheEntry<K, V> entry, long currentTime, boolean hasLock) Description copied from interface:InternalExpirationManager
This should be invoked passing in an entry that is now expired. This method may attempt to lock this key to preserve atomicity. This method should be invoked when an entry was read via get but found to be expired.This method returns true if the entry was removed due to expiration or false if the entry was not removed due to expiration
If hasLock is true, this method assumes that the caller has the lock for the key and it must allow the expiration to occur, ie. returned CompletableFuture has completed, before the lock is released. Failure to do so may cause inconsistency in data.
- Specified by:
entryExpiredInMemory
in interfaceInternalExpirationManager<K,
V> - Parameters:
entry
- the entry that has expiredcurrentTime
- the current time when it expiredhasLock
- if the expiration was found during a write operation- Returns:
- if this entry actually expired or not
-
handleInStoreExpirationInternal
Description copied from interface:InternalExpirationManager
This is to be invoked when a store entry expires. This method may attempt to lock this key to preserve atomicity.Note this method doesn't currently take a
InternalCacheEntry
and this is due to a limitation in the cache store API. This may cause some values to be removed if they were updated at the same time.- Specified by:
handleInStoreExpirationInternal
in interfaceInternalExpirationManager<K,
V> - Parameters:
key
- the key of the expired entry This method will be renamed to handleInStoreExpiration when the method can be removed fromExpirationManager
-
handleInStoreExpirationInternal
public CompletionStage<Void> handleInStoreExpirationInternal(MarshallableEntry<K, V> marshalledEntry) Description copied from interface:InternalExpirationManager
This is to be invoked when a store entry expires and the value and/or metadata is available to be used.- Specified by:
handleInStoreExpirationInternal
in interfaceInternalExpirationManager<K,
V> - Parameters:
marshalledEntry
- the entry that can be unmarshalled as needed This method will be renamed to handleInStoreExpiration when the method can be removed fromExpirationManager
-
handlePossibleExpiration
public CompletionStage<Boolean> handlePossibleExpiration(InternalCacheEntry<K, V> ice, int segment, boolean isWrite) Description copied from interface:InternalExpirationManager
Handles processing for an entry that may be expired. This will remove the entry if it is expired, otherwise may touch if it uses max idle.- Specified by:
handlePossibleExpiration
in interfaceInternalExpirationManager<K,
V> - Parameters:
ice
- entry that may be expiredsegment
- the segment of the entryisWrite
- whether the command that saw the expired value was a write or not- Returns:
- a stage that will complete with
true
if the entry was expired andfalse
otherwise
-
checkExpiredMaxIdle
protected CompletionStage<Boolean> checkExpiredMaxIdle(InternalCacheEntry<?, ?> entry, int segment, long currentTime) Response is whether the value should be treated as expired. This is determined by if a value as able to be touched or not, that is if it couldn't be touched - we assumed expired (as it was removed in some way).- Parameters:
entry
- the entry to check expiration and touchsegment
- the segment the entry maps tocurrentTime
- the current time in milliseconds- Returns:
- whether the entry was expired or not
-
stop
public void stop() -
addInternalListener
Description copied from interface:InternalExpirationManager
Adds anInternalExpirationManager.ExpirationConsumer
to be invoked when an entry is expired.It exposes the
PrivateMetadata
- Specified by:
addInternalListener
in interfaceInternalExpirationManager<K,
V> - Parameters:
consumer
- The instance to invoke.
-
removeInternalListener
Description copied from interface:InternalExpirationManager
Removes a previous registeredInternalExpirationManager.ExpirationConsumer
.- Specified by:
removeInternalListener
in interfaceInternalExpirationManager<K,
V> - Parameters:
listener
- The instance to remove.
-