|
CoherenceTM v3.3 Copyright© 2000-2007 by Oracle Corporation |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public static interface InvocableMap.Entry
An InvocableMap.Entry contains additional information and exposes additional operations that the basic Map.Entry does not. It allows non-existent entries to be represented, thus allowing their optional creation. It allows existent entries to be removed from the Map. It supports a number of optimizations that can ultimately be mapped through to indexes and other data structures of the underlying Map.
Method Summary | |
---|---|
Object |
getKey()
Return the key corresponding to this entry. |
Object |
getValue()
Return the value corresponding to this entry. |
boolean |
isPresent()
Determine if this Entry exists in the Map. |
void |
remove(boolean fSynthetic)
Remove this Entry from the Map if it is present in the Map. |
Object |
setValue(Object oValue)
Store the value corresponding to this entry. |
void |
setValue(Object oValue,
boolean fSynthetic)
Store the value corresponding to this entry. |
void |
update(ValueUpdater updater,
Object oValue)
Update the Entry's value. |
Methods inherited from interface com.tangosol.util.QueryMap.Entry |
---|
extract |
Methods inherited from interface java.util.Map.Entry |
---|
equals, hashCode |
Method Detail |
---|
Object getKey()
isPresent()
, and to create the entry for the key, use
setValue(java.lang.Object)
.
getKey
in interface Map.Entry
Object getValue()
isPresent()
.
Note: any modifications to the value retrieved using this
method are not guaranteed to persist unless followed by a
setValue(java.lang.Object)
or update(com.tangosol.util.ValueUpdater, java.lang.Object)
call.
getValue
in interface Map.Entry
Object setValue(Object oValue)
setValue
in interface Map.Entry
oValue
- the new value for this Entry
void setValue(Object oValue, boolean fSynthetic)
setValue
, this
form does not return the previous value, and as a result may be
significantly less expensive (in terms of cost of execution) for
certain Map implementations.
oValue
- the new value for this EntryfSynthetic
- pass true only if the insertion into or
modification of the Map should be treated as a
synthetic eventvoid update(ValueUpdater updater, Object oValue)
Object oTarget = entry.getValue(); updater.update(oTarget, oValue); entry.setValue(oTarget, false);The benefit of using this method is that it may allow the Entry implementation to significantly optimize the operation, such as for purposes of delta updates and backup maintenance.
updater
- a ValueUpdater used to modify the Entry's valueboolean isPresent()
setValue(java.lang.Object)
or
setValue(java.lang.Object)
. If the Entry is present, it can be destroyed by
calling remove(boolean)
.
void remove(boolean fSynthetic)
Map.remove(java.lang.Object)
as well as synthetic operations such as
eviction. If the containing Map does not differentiate between
the two, then this method will always be identical to
InvocableMap.this.remove(getKey()).
fSynthetic
- pass true only if the removal from the Map
should be treated as a synthetic event
|
CoherenceTM v3.3 Copyright© 2000-2007 by Oracle Corporation |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |