|
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.VersionedPut
public class VersionedPut
VersionedPut is an EntryProcessor that assumes that entry values implement Versionable
interface and performs an Entry.setValue
operation if and only if the version of the specified value matches to the version of the current value. In case of the match, the VersionedPut will increment the version indicator before the value is updated.
ConditionalPut
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 Versionable |
m_oValue Specifies the new value to update an entry with. |
Constructor Summary | |
---|---|
VersionedPut() Default constructor (necessary for the ExternalizableLite interface). |
|
VersionedPut(Versionable oValue) Construct a VersionedPut 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). |
|
VersionedPut(Versionable oValue, boolean fAllowInsert, boolean fReturn) Construct a VersionedPut 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. |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object o) Compare the VersionedPut with another object to determine equality. |
int |
hashCode() Determine a hash value for the VersionedPut 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, Versionable oValueNew, 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 VersionedPut. |
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 Versionable m_oValue
protected boolean m_fInsert
protected boolean m_fReturn
Constructor Detail |
---|
public VersionedPut()
public VersionedPut(Versionable oValue)
process(com.tangosol.util.InvocableMap.Entry)
invocation does not return any result.
oValue
- a Versionable value to update an entry withpublic VersionedPut(Versionable oValue, boolean fAllowInsert, boolean fReturn)
oValue
- a value to update an entry withfAllowInsert
- specifies whether or not an insert should be allowed (no currently existing value)fReturn
- specifies whether or not the processor should return the current value in case it has 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, Versionable oValueNew, boolean fInsert, boolean fReturn)
entry
- entry the entry to be processedoValueNew
- the new valuefInsert
- 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 |