|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
com.tangosol.util.Base
com.tangosol.util.processor.AbstractProcessor
com.tangosol.util.processor.VersionedPutAll
public class VersionedPutAll
VersionedPutAll is an EntryProcessor that assumes that entry values implement Versionable
interface and performs an Entry.setValue
operation only for entries whose versions match to versions of the corresponding current values. In case of the match, the VersionedPutAll will increment the version indicator before each value is updated.
VersionedPut
Field Summary | |
---|---|
protected boolean |
m_fInsert Specifies whether or not an insert is allowed. |
protected boolean |
m_fReturn Specifies whether or not a return value is required. |
protected java.util.Map |
m_map Specifies the map of new values. |
Constructor Summary | |
---|---|
VersionedPutAll() Default constructor (necessary for the ExternalizableLite interface). |
|
VersionedPutAll(java.util.Map map) Construct a VersionedPutAll processor that updates an entry with a new value if and only if the version of the new value matches to the version of the current entry's value (which must exist). |
|
VersionedPutAll(java.util.Map map, boolean fAllowInsert, boolean fReturn) Construct a VersionedPutAll processor that updates an entry with a new value if and only if the version of the new value matches to the version of the current entry's value (which must exist). |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object o) Compare the VersionedPutAll with another object to determine equality. |
int |
hashCode() Determine a hash value for the VersionedPutAll object according to the general Object.hashCode() contract. |
java.lang.Object |
process(InvocableMap.Entry entry) Process a Map.Entry object. |
java.util.Map |
processAll(java.util.Set setEntries) Process a Set of InvocableMap.Entry objects. |
protected java.lang.Object |
processEntry(InvocableMap.Entry entry, java.util.Map mapAll, boolean fInsert, boolean fReturn) Process the given entry. |
void |
readExternal(java.io.DataInput in) Restore the contents of this object by loading the object's state from the passed DataInput object. |
void |
readExternal(PofReader in) Restore the contents of a user type instance by reading its state using the specified PofReader object. |
java.lang.String |
toString() Return a human-readable description for this VersionedPutAll. |
void |
writeExternal(java.io.DataOutput out) Save the contents of this object by storing the object's state into the passed DataOutput object. |
void |
writeExternal(PofWriter out) Save the contents of a POF user type instance by writing its state using the specified PofWriter object. |
Field Detail |
---|
protected java.util.Map m_map
protected boolean m_fInsert
protected boolean m_fReturn
Constructor Detail |
---|
public VersionedPutAll()
public VersionedPutAll(java.util.Map map)
process(com.tangosol.util.InvocableMap.Entry)
invocation does not return any result.
map
- a map of values to update entries withpublic VersionedPutAll(java.util.Map map, boolean fAllowInsert, boolean fReturn)
map
- a map of values to update entries withfAllowInsert
- specifies whether or not an insert should be allowed (no currently existing value)fReturn
- specifies whether or not the processor should return the entries that have not been updatedMethod Detail |
---|
public java.lang.Object process(InvocableMap.Entry entry)
process
in interface InvocableMap.EntryProcessor
entry
- the Entry to process Note: if this method throws an exception, all modifications to the supplied entry or any other entries retrieved via the BackingMapContext.getBackingMapEntry(java.lang.Object)
API will be rolled back leaving all underlying values unchanged.public java.util.Map processAll(java.util.Set setEntries)
Map mapResults = new ListMap(); for (Iterator iter = setEntries.iterator(); iter.hasNext(); ) { Entry entry = (Entry) iter.next(); mapResults.put(entry.getKey(), process(entry)); } return mapResults;Note: if processAll() call throws an exception, only the entries that were removed from the setEntries would be considered successfully processed and the corresponding changes made to the underlying Map; changes made to the remaining entries or any other entries obtained from
BackingMapContext.getBackingMapEntry(java.lang.Object)
will not be processed.processAll
in interface InvocableMap.EntryProcessor
processAll
in class AbstractProcessor
setEntries
- a Set of InvocableMap.Entry objects to processpublic boolean equals(java.lang.Object o)
public int hashCode()
Object.hashCode()
contract.public java.lang.String toString()
public void readExternal(java.io.DataInput in) throws java.io.IOException
readExternal
in interface ExternalizableLite
in
- the DataInput stream to read data from in order to restore the state of this objectjava.io.IOException
- if an I/O exception occursjava.io.NotActiveException
- if the object is not in its initial state, and therefore cannot be deserialized intopublic void writeExternal(java.io.DataOutput out) throws java.io.IOException
writeExternal
in interface ExternalizableLite
out
- the DataOutput stream to write the state of this object tojava.io.IOException
- if an I/O exception occurspublic void readExternal(PofReader in) throws java.io.IOException
readExternal
in interface PortableObject
in
- the PofReader from which to read the object's statejava.io.IOException
- if an I/O error occurspublic void writeExternal(PofWriter out) throws java.io.IOException
writeExternal
in interface PortableObject
out
- the PofWriter to which to write the object's statejava.io.IOException
- if an I/O error occursprotected java.lang.Object processEntry(InvocableMap.Entry entry, java.util.Map mapAll, boolean fInsert, boolean fReturn)
entry
- entry the entry to be processedmapAll
- the map of new valuesfInsert
- specifies whether or not an insert is allowedfReturn
- specifies whether or not a return value is required
|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |