org.infinispan.interceptors.impl

Class InvalidationInterceptor

java.lang.Object

org.infinispan.interceptors.BaseAsyncInterceptor

org.infinispan.interceptors.DDAsyncInterceptor

org.infinispan.interceptors.impl.BaseRpcInterceptor

org.infinispan.interceptors.impl.InvalidationInterceptor

All Implemented Interfaces:

Visitor, AsyncInterceptor, JmxStatisticsExposer

@MBean(objectName="Invalidation",
       description="Component responsible for invalidating entries on remote caches when entries are written to locally.")
public class InvalidationInterceptor
extends BaseRpcInterceptor
implements JmxStatisticsExposer

This interceptor acts as a replacement to the replication interceptor when the CacheImpl is configured with ClusteredSyncMode as INVALIDATE.

The idea is that rather than replicating changes to all caches in a cluster when write methods are called, simply broadcast an InvalidateCommand on the remote caches containing all keys modified. This allows the remote cache to look up the value in a shared cache loader which would have been updated with the changes.

Transactional caches, still lock affected keys on the primary owner:

• Pessimistic caches acquire locks with an explicit lock command and release during the one-phase PrepareCommand.
• Optimistic caches acquire locks during the 2-phase prepare command and release locks with a TxCompletionNotificationCommand.

Since:

9.0

Author:

Manik Surtani, Galder Zamarreño, Mircea.Markus@jboss.com

Field Summary

Fields inherited from class org.infinispan.interceptors.impl.BaseRpcInterceptor

componentRegistry, defaultSynchronous, rpcManager, trace

Fields inherited from class org.infinispan.interceptors.BaseAsyncInterceptor

cacheConfiguration

Constructor Summary

Constructors

Constructor and Description
InvalidationInterceptor()

Method Summary

Modifier and Type	Method and Description
long	getInvalidations()
protected Log	getLog()
boolean	getStatisticsEnabled() Returns whether an interceptor's statistics are being captured.
void	resetStatistics() Resets an interceptor's cache statistics
void	setStatisticsEnabled(boolean enabled) Enables an interceptor's cache statistics If true, the interceptor will capture statistics and make them available through the mbean.
Object	visitClearCommand(InvocationContext ctx, ClearCommand command)
Object	visitCommitCommand(TxInvocationContext ctx, CommitCommand command)
Object	visitComputeCommand(InvocationContext ctx, ComputeCommand command)
Object	visitComputeIfAbsentCommand(InvocationContext ctx, ComputeIfAbsentCommand command)
Object	visitLockControlCommand(TxInvocationContext ctx, LockControlCommand command)
Object	visitPrepareCommand(TxInvocationContext ctx, PrepareCommand command)
Object	visitPutKeyValueCommand(InvocationContext ctx, PutKeyValueCommand command)
Object	visitPutMapCommand(InvocationContext ctx, PutMapCommand command)
Object	visitRemoveCommand(InvocationContext ctx, RemoveCommand command)
Object	visitReplaceCommand(InvocationContext ctx, ReplaceCommand command)

Methods inherited from class org.infinispan.interceptors.impl.BaseRpcInterceptor

init, isLocalModeForced, isSynchronous, shouldInvokeRemoteTxCommand, transactionRemotelyPrepared

Methods inherited from class org.infinispan.interceptors.DDAsyncInterceptor

handleDefault, visitCommand, visitEntrySetCommand, visitEvictCommand, visitGetAllCommand, visitGetCacheEntryCommand, visitGetKeysInGroupCommand, visitGetKeyValueCommand, visitInvalidateCommand, visitInvalidateL1Command, visitKeySetCommand, visitReadOnlyKeyCommand, visitReadOnlyManyCommand, visitReadWriteKeyCommand, visitReadWriteKeyValueCommand, visitReadWriteManyCommand, visitReadWriteManyEntriesCommand, visitRollbackCommand, visitSizeCommand, visitUnknownCommand, visitWriteOnlyKeyCommand, visitWriteOnlyKeyValueCommand, visitWriteOnlyManyCommand, visitWriteOnlyManyEntriesCommand

Methods inherited from class org.infinispan.interceptors.BaseAsyncInterceptor

asyncInvokeNext, asyncInvokeNext, asyncInvokeNext, asyncValue, delayedNull, delayedValue, delayedValue, invokeNext, invokeNextAndExceptionally, invokeNextAndFinally, invokeNextAndHandle, invokeNextThenAccept, invokeNextThenApply, isSuccessfullyDone, makeStage, setNextInterceptor, valueOrException

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.infinispan.commands.Visitor

visitRemoveExpiredCommand

Constructor Detail

InvalidationInterceptor

public InvalidationInterceptor()

Method Detail

getLog

protected Log getLog()

Specified by:

getLog in class BaseRpcInterceptor

visitPutKeyValueCommand

public Object visitPutKeyValueCommand(InvocationContext ctx,
                                      PutKeyValueCommand command)
                               throws Throwable

Specified by:

visitPutKeyValueCommand in interface Visitor

Overrides:

visitPutKeyValueCommand in class DDAsyncInterceptor

Throws:

Throwable

visitReplaceCommand

public Object visitReplaceCommand(InvocationContext ctx,
                                  ReplaceCommand command)
                           throws Throwable

Specified by:

visitReplaceCommand in interface Visitor

Overrides:

visitReplaceCommand in class DDAsyncInterceptor

Throws:

Throwable

visitComputeCommand

public Object visitComputeCommand(InvocationContext ctx,
                                  ComputeCommand command)
                           throws Throwable

Specified by:

visitComputeCommand in interface Visitor

Overrides:

visitComputeCommand in class DDAsyncInterceptor

Throws:

Throwable

visitComputeIfAbsentCommand

public Object visitComputeIfAbsentCommand(InvocationContext ctx,
                                          ComputeIfAbsentCommand command)
                                   throws Throwable

Specified by:

visitComputeIfAbsentCommand in interface Visitor

Overrides:

visitComputeIfAbsentCommand in class DDAsyncInterceptor

Throws:

Throwable

visitRemoveCommand

public Object visitRemoveCommand(InvocationContext ctx,
                                 RemoveCommand command)
                          throws Throwable

Specified by:

visitRemoveCommand in interface Visitor

Overrides:

visitRemoveCommand in class DDAsyncInterceptor

Throws:

Throwable

visitClearCommand

public Object visitClearCommand(InvocationContext ctx,
                                ClearCommand command)
                         throws Throwable

Specified by:

visitClearCommand in interface Visitor

Overrides:

visitClearCommand in class DDAsyncInterceptor

Throws:

Throwable

visitPutMapCommand

public Object visitPutMapCommand(InvocationContext ctx,
                                 PutMapCommand command)
                          throws Throwable

Specified by:

visitPutMapCommand in interface Visitor

Overrides:

visitPutMapCommand in class DDAsyncInterceptor

Throws:

Throwable

visitPrepareCommand

public Object visitPrepareCommand(TxInvocationContext ctx,
                                  PrepareCommand command)
                           throws Throwable

Specified by:

visitPrepareCommand in interface Visitor

Overrides:

visitPrepareCommand in class DDAsyncInterceptor

Throws:

Throwable

visitCommitCommand

public Object visitCommitCommand(TxInvocationContext ctx,
                                 CommitCommand command)
                          throws Throwable

Specified by:

visitCommitCommand in interface Visitor

Overrides:

visitCommitCommand in class DDAsyncInterceptor

Throws:

Throwable

visitLockControlCommand

public Object visitLockControlCommand(TxInvocationContext ctx,
                                      LockControlCommand command)
                               throws Throwable

Specified by:

visitLockControlCommand in interface Visitor

Overrides:

visitLockControlCommand in class DDAsyncInterceptor

Throws:

Throwable

resetStatistics

@ManagedOperation(description="Resets statistics gathered by this component",
                  displayName="Reset statistics")
public void resetStatistics()

Description copied from interface: JmxStatisticsExposer

Resets an interceptor's cache statistics

Specified by:

resetStatistics in interface JmxStatisticsExposer

getStatisticsEnabled

@ManagedAttribute(displayName="Statistics enabled",
                  description="Enables or disables the gathering of statistics by this component",
                  dataType=TRAIT,
                  writable=true)
public boolean getStatisticsEnabled()

Description copied from interface: JmxStatisticsExposer

Returns whether an interceptor's statistics are being captured.

Specified by:

getStatisticsEnabled in interface JmxStatisticsExposer

Returns:

true if statistics are captured

setStatisticsEnabled

public void setStatisticsEnabled(@Parameter(name="enabled",description="Whether statistics should be enabled or disabled (true/false)")
                                 boolean enabled)

Description copied from interface: JmxStatisticsExposer

Enables an interceptor's cache statistics If true, the interceptor will capture statistics and make them available through the mbean.

Specified by:

setStatisticsEnabled in interface JmxStatisticsExposer

Parameters:

enabled - true if statistics should be captured

getInvalidations

@ManagedAttribute(description="Number of invalidations",
                  displayName="Number of invalidations",
                  measurementType=TRENDSUP)
public long getInvalidations()