org.apache.ignite.cache

Class CacheInterceptorAdapter<K,V>

java.lang.Object

org.apache.ignite.cache.CacheInterceptorAdapter<K,V>

All Implemented Interfaces:

CacheInterceptor<K,V>

public class CacheInterceptorAdapter<K,V>
extends Object
implements CacheInterceptor<K,V>

Cache interceptor convenience adapter. It provides no-op implementations for all interceptor callbacks.

Constructor Summary

Constructors

Constructor and Description
CacheInterceptorAdapter()

Method Summary

Methods

Modifier and Type	Method and Description
void	onAfterPut(K key, V val) This method is called after new value has been stored.
void	onAfterRemove(K key, V val) This method is called after value has been removed.
V	onBeforePut(K key, V oldVal, V newVal) This method is called within CacheProjection.put(Object, Object, IgnitePredicate[]) and similar operations before new value is stored in cache.
IgniteBiTuple<Boolean,V>	onBeforeRemove(K key, V val) This method is called within CacheProjection.remove(Object, IgnitePredicate[]) and similar operations to provide control over returned value.
V	onGet(K key, V val) This method is called within CacheProjection.get(Object) and similar operations to provide control over returned value.

Methods inherited from class java.lang.Object

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

Constructor Detail

CacheInterceptorAdapter

public CacheInterceptorAdapter()

Method Detail

onGet

@Nullable
public V onGet(K key,
               V val)

This method is called within CacheProjection.get(Object) and similar operations to provide control over returned value.

If this method returns null, then get() operation results in null as well.

This method should not throw any exception.

Specified by:

onGet in interface CacheInterceptor<K,V>

Parameters:

key - Key.

val - Value mapped to key at the moment of get() operation.

Returns:

The new value to be returned as result of get() operation.

See Also:

CacheProjection.get(Object)

onBeforePut

@Nullable
public V onBeforePut(K key,
                     @Nullable
                     V oldVal,
                     V newVal)

This method is called within CacheProjection.put(Object, Object, IgnitePredicate[]) and similar operations before new value is stored in cache.

Implementations should not execute any complex logic, including locking, networking or cache operations, as it may lead to deadlock, since this method is called from sensitive synchronization blocks.

This method should not throw any exception.

Specified by:

onBeforePut in interface CacheInterceptor<K,V>

Parameters:

key - Key.

oldVal - Old value.

newVal - New value.

Returns:

Value to be put to cache. Returning null cancels the update.

See Also:

CacheProjection.put(Object, Object, IgnitePredicate[])

onAfterPut

public void onAfterPut(K key,
              V val)

This method is called after new value has been stored.

Implementations should not execute any complex logic, including locking, networking or cache operations, as it may lead to deadlock, since this method is called from sensitive synchronization blocks.

This method should not throw any exception.

Specified by:

onAfterPut in interface CacheInterceptor<K,V>

Parameters:

key - Key.

val - Current value.

onBeforeRemove

@Nullable
public IgniteBiTuple<Boolean,V> onBeforeRemove(K key,
                                               @Nullable
                                               V val)

This method is called within CacheProjection.remove(Object, IgnitePredicate[]) and similar operations to provide control over returned value.

Implementations should not execute any complex logic, including locking, networking or cache operations, as it may lead to deadlock, since this method is called from sensitive synchronization blocks.

This method should not throw any exception.

Specified by:

onBeforeRemove in interface CacheInterceptor<K,V>

Parameters:

key - Key.

val - Old value.

Returns:

Tuple. The first value is the flag whether remove should be cancelled or not. The second is the value to be returned as result of remove() operation, may be null.

See Also:

CacheProjection.remove(Object, IgnitePredicate[])

onAfterRemove

public void onAfterRemove(K key,
                 V val)

This method is called after value has been removed.

Implementations should not execute any complex logic, including locking, networking or cache operations, as it may lead to deadlock, since this method is called from sensitive synchronization blocks.

This method should not throw any exception.

Specified by:

onAfterRemove in interface CacheInterceptor<K,V>

Parameters:

key - Key.

val - Removed value.