|
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.ExtractorProcessor
public class ExtractorProcessor
ExtractorProcessor is an EntryProcessor implementations that extracts a value from an object cached in an InvocableMap. A common usage pattern is:
cache.invoke(oKey, new ExtractorProcessor(extractor));
which is functionally equivalent to the following operation:
extractor.extract(cache.get(oKey));
The major difference is that for clustered caches using the ExtractorProcessor could significantly reduce the amount of network traffic.
An alternative (and superior) approach would be to use the ReducerAggregator
Field Summary | |
---|---|
protected ValueExtractor |
m_extractor The underlying value extractor. |
Constructor Summary | |
---|---|
ExtractorProcessor() Default constructor (necessary for the ExternalizableLite interface). |
|
ExtractorProcessor(java.lang.String sMethod) Construct an ExtractorProcessor for a given method name. |
|
ExtractorProcessor(ValueExtractor extractor) Construct an ExtractorProcessor based on the specified ValueExtractor. |
Method Summary | |
---|---|
boolean |
equals(java.lang.Object o) Compare the ExtractorProcessor with another object to determine equality. |
int |
hashCode() Determine a hash value for the ExtractorProcessor object according to the general Object.hashCode() contract. |
java.lang.Object |
process(InvocableMap.Entry entry) Process a Map.Entry object. |
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 ExtractorProcessor. |
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. |
Methods inherited from class com.tangosol.util.processor.AbstractProcessor |
---|
processAll |
Field Detail |
---|
protected ValueExtractor m_extractor
Constructor Detail |
---|
public ExtractorProcessor()
public ExtractorProcessor(ValueExtractor extractor)
extractor
- a ValueExtractor object; passing null is equivalent to using the IdentityExtractorpublic ExtractorProcessor(java.lang.String sMethod)
sMethod
- a method name to make a ReflectionExtractor
for; this parameter can also be a dot-delimited sequence of method names which would result in an ExtractorProcessor based on the ChainedExtractor
that is based on an array of corresponding ReflectionExtractor objectsMethod 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 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 occurs
|
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 |