Package org.apache.geode.cache

Interface Region.Entry<K,V>

All Superinterfaces:
Map.Entry<K,V>
Enclosing interface:
Region<K,V>
public static interface Region.Entry<K,V> extends Map.Entry<K,V>
A key-value pair containing the cached data in a region. This object's operations (except for{Entry#setValue()}), are not distributed, do not acquire any locks, and do not affect CacheStatistics.

Unless otherwise noted, all of these methods throw a CacheClosedException if the Cache is closed at the time of invocation, or an EntryDestroyedException if the entry has been destroyed.

  • Method Summary

    Modifier and Type
    Method
    Description
    K
    getKey()
    Returns the key for this entry.
    Region<K,V>
    getRegion()
    Returns the region that contains this entry.
    CacheStatistics
    getStatistics()
    Returns the statistics for this entry.
    Object
    getUserAttribute()
    Returns the user attribute for this entry in the local cache.
    V
    getValue()
    Returns the value of this entry in the local cache.
    boolean
    isDestroyed()
    Returns whether this entry has been destroyed.
    boolean
    isLocal()
    This method checks to see if the entry is in the in-process cache, or is in another process.
    Object
    setUserAttribute(Object userAttribute)
    Sets the user attribute for this entry.
    V
    setValue(V value)
    Sets the value of this entry.

    Methods inherited from interface java.util.Map.Entry

    equals, hashCode

  • Method Details

    • getKey

      K getKey()
      Returns the key for this entry.
      Specified by:
      getKey in interface Map.Entry<K,V>
      Returns:
      the key for this entry

    • getValue

      V getValue()
      Returns the value of this entry in the local cache. Does not invoke a CacheLoader, does not do a netSearch, netLoad, etc.
      Specified by:
      getValue in interface Map.Entry<K,V>
      Returns:
      the value or null if this entry is invalid

    • getRegion

      Region<K,V> getRegion()
      Returns the region that contains this entry.
      Returns:
      the Region that contains this entry

    • isLocal

      boolean isLocal()
      This method checks to see if the entry is in the in-process cache, or is in another process. Only Regions with DataPolicy.PARTITION may return false in response to this query. A non-local Entry will not reflect dynamic changes being made to the cache. For instance, the result of getValue() will not change, even though the cache may have been updated for the corresponding key. To see an updated snapshot of a non-local Entry, you must fetch the entry from the Region again.
      Returns:
      whether the entry is in the in-process cache, or is in another process

    • getStatistics

      CacheStatistics getStatistics()
      Returns the statistics for this entry.
      Returns:
      the CacheStatistics for this entry
      Throws:
      StatisticsDisabledException - if statistics have been disabled for this region

    • getUserAttribute

      Object getUserAttribute()
      Returns the user attribute for this entry in the local cache.
      Returns:
      the user attribute for this entry

    • setUserAttribute

      Object setUserAttribute(Object userAttribute)
      Sets the user attribute for this entry. Does not distribute the user attribute to other caches.
      Parameters:
      userAttribute - the user attribute for this entry
      Returns:
      the previous user attribute or null no user attributes has been set for this entry

    • isDestroyed

      boolean isDestroyed()
      Returns whether this entry has been destroyed.

      Does not throw a EntryDestroyedException if this entry has been destroyed.

      Returns:
      true if this entry has been destroyed

    • setValue

      V setValue(V value)
      Sets the value of this entry. It has similar to calling a put on the key of this Entry
      Specified by:
      setValue in interface Map.Entry<K,V>
      Parameters:
      value - Object the value to be set
      Returns:
      the previous value object stored locally for this entry. If the entry did not exist then null is returned. If the entry was "invalid" then null is returned. In some cases null may be returned even if a previous value exists. If the region is a client proxy then null is returned. If the region is off-heap and the old value was stored in off-heap memory then null is returned. If the region is partitioned and the setValue is done on a non-primary then null is returned. If the value is not currently stored in memory but is on disk and if the region does not have cqs then null is returned.
      Since:
      GemFire 5.0
      See Also: