public class ReflectionExtractor<T,E> extends AbstractExtractor<T,E> implements ValueExtractor<T,E>, ExternalizableLite, PortableObject
ChainedExtractor
ExternalizableHelper.DecoratedMultiBufferReadBuffer, ExternalizableHelper.DefaultObjectStreamFactory, ExternalizableHelper.FormatAwareCompressor, ExternalizableHelper.IntDecoratedObject, ExternalizableHelper.Shielded, ExternalizableHelper.ShieldedDataOutputStream, ExternalizableHelper.ShieldedInputStream, ExternalizableHelper.ShieldedObjectOutputStream, ExternalizableHelper.ShieldedOutputStream, ExternalizableHelper.SimpleXmlBeanClassCache, ExternalizableHelper.Stats, ExternalizableHelper.XmlBeanClassCache
Base.LoggingWriter, Base.StackFrame
Modifier and Type | Field and Description |
---|---|
protected Object[] |
m_aoParam
The parameter array.
|
protected String |
m_sMethod
The name of the method to invoke.
|
KEY, m_nTarget, m_sNameCanon, VALUE
CONVERTER_FROM_BINARY, CONVERTER_STRIP_INTDECO, CONVERTER_TO_BINARY, DECO_APP_1, DECO_APP_2, DECO_APP_3, DECO_CUSTOM, DECO_EXPIRY, DECO_ID_MAX, DECO_ID_MIN, DECO_JCACHE, DECO_JCACHE_SYNTHETIC, DECO_MEMCACHED, DECO_PUSHREP, DECO_QUEUE_METADATA, DECO_RSVD_1, DECO_RSVD_2, DECO_STORE, DECO_TX, DECO_VALUE, DECO_WLS, EMPTY_BINARY_ARRAY, FMT_B_ARRAY, FMT_BIN_DECO, FMT_BIN_EXT_DECO, FMT_BINARY, FMT_BOOLEAN, FMT_BYTE, FMT_DECIMAL, FMT_DOUBLE, FMT_EXT, FMT_FLOAT, FMT_IDO, FMT_INT, FMT_INTEGER, FMT_LONG, FMT_NONE, FMT_NULL, FMT_OBJ_EXT, FMT_OBJ_SER, FMT_OPT, FMT_OPT_DOUBLE, FMT_OPT_INT, FMT_OPT_LONG, FMT_SHORT, FMT_STRING, FMT_UNKNOWN, FMT_XML_BEAN, FMT_XML_SER, FORCE_RESOLVING_STREAMS, MAX_DECO_HEADER_BYTES, PROPERTY_CONFIG, s_streamfactory, TRINT_DOMAIN_SPAN, TRINT_MAX_VALUE, TRINT_MAX_VARIANCE, USE_POF_STREAMS, USE_XMLBEAN_CLASS_CACHE, XMLBEAN_CLASS_CACHE
Constructor and Description |
---|
ReflectionExtractor()
Default constructor (necessary for the ExternalizableLite interface).
|
ReflectionExtractor(String sMethod)
Construct a ReflectionExtractor based on a method name.
|
ReflectionExtractor(String sMethod,
Object[] aoParam)
Construct a ReflectionExtractor based on a method name and optional
parameters.
|
ReflectionExtractor(String sMethod,
Object[] aoParam,
int nTarget)
Construct a ReflectionExtractor based on a method name, optional
parameters and the entry extraction target.
|
Modifier and Type | Method and Description |
---|---|
protected String |
computeCanonicalName(String sName,
Object[] aoParam)
Compute the canonical name for this extractor.
|
boolean |
equals(Object o)
Compare the ReflectionExtractor with another object to determine equality.
|
E |
extract(T oTarget)
Extract from target using reflection.
|
String |
getCanonicalName()
Return the canonical name for this extractor.
|
String |
getMethodName()
Determine the name of the method that this extractor is configured to
invoke.
|
Object[] |
getParameters()
Return the array of arguments used to invoke the method.
|
int |
hashCode()
HashCode value is hashCode of non-null
canonical name ;
otherwise, it is the hashCode of sName passed to {#link ReflectionExtractor(String)}. |
void |
readExternal(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.
|
String |
toString()
Provide a human-readable description of this ReflectionExtractor object.
|
void |
writeExternal(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.
|
compare, compareEntries, extractFromEntry, extractOriginalFromEntry, getTarget, isCanonicallyEquatable
asBinary, calculatePackedLength, calculatePackedLength, checkObjectInputFilter, convertUTF, decodeExpiry, decorate, decorate, decorate, decorate, decorate, decorateBinary, encodeExpiry, ensureSerializer, extractIntDecoration, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromByteArray, fromByteArray, getClass, getDecoration, getDecoration, getDecorations, getDeltaCompressor, getInputStream, getNewObjectInput, getObjectInput, getObjectOutput, getObjectStreamFactory, getOutputStream, getShieldedOutputStream, getStreamFormat, getUndecorated, getUndecorated, isDecorated, isDecorated, isIntDecorated, isIntDecorated, isResolving, isSerializable, isSerializerCompatible, isVersionCompatible, isVersionCompatible, loadClass, loadResource, main, makeTrint, readBigDecimal, readBigInteger, readBooleanArray, readByteArray, readCollection, readDate, readDoubleArray, readExternalizableLite, readExternalizableLite, readFloatArray, readInt, readInt, readIntArray2d, readLong, readLong, readMap, readMap, readObject, readObject, readSafeUTF, readSafeUTF, readSerializable, readSerializable, readStringArray, readTime, readTimestamp, readTrint, readUnsignedTrint, readUTF, readXmlBean, readXmlSerializable, readXmlSerializable, realize, removeIntDecoration, removeIntDecoration, replace, reportIncompatibleSerializers, setObjectStreamFactory, toBinary, toBinary, toByteArray, toByteArray, toByteArray, toLiteBinary, toLong, undecorate, undecorate, validateBufferSize, writeBigDecimal, writeBigInteger, writeBooleanArray, writeByteArray, writeCollection, writeDate, writeDoubleArray, writeExternalizableLite, writeFloatArray, writeInt, writeInt, writeIntArray2d, writeLong, writeLong, writeMap, writeObject, writeSafeUTF, writeSafeUTF, writeSerializable, writeStringArray, writeTime, writeTimestamp, writeTrint, writeTrint, writeUTF, writeXmlBean, writeXmlSerializable
countBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, rotateLeft, rotateLeft, rotateLeft, rotateRight, rotateRight, rotateRight, toBitString, toBitString, toBitString, toBytes, toBytes, toBytes, toBytes, toInt, toInt, toLong
azzert, azzert, azzert, azzertFailed, breakLines, breakLines, capitalize, checkNotEmpty, checkNotNull, checkRange, computeSafeWaitTime, decimalValue, dup, dup, ensureBigDecimal, ensureClassLoader, ensureRuntimeException, ensureRuntimeException, equals, equalsDeep, err, err, err, err, err, escape, formatDateTime, getCallerStackFrame, getCommonMonitor, getCommonMonitor, getCommonMonitor, getContextClassLoader, getContextClassLoader, getDeepMessage, getErr, getLastSafeTimeMillis, getLog, getMaxDecDigits, getMaxHexDigits, getOriginalException, getOut, getProcessRandom, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mod, mod, octalValue, out, out, out, out, out, pad, parseBandwidth, parseBandwidth, parseDelimitedString, parseHex, parseHex, parseMemorySize, parseMemorySize, parsePercentage, parseTime, parseTime, parseTimeNanos, parseTimeNanos, printStackTrace, randomize, randomize, randomize, randomize, read, read, read, read, read, read, read, replace, setErr, setLog, setLogEcho, setOut, sleep, toBandwidthString, toBandwidthString, toCharEscape, toCrc, toCrc, toCrc, toCrc, toCrc, toDecString, toDelimitedString, toDelimitedString, toDelimitedString, toDelimitedString, toHex, toHex, toHexDump, toHexEscape, toHexEscape, toHexEscape, toHexEscape, toHexString, toMemorySizeString, toMemorySizeString, toQuotedCharEscape, toQuotedStringEscape, toSqlString, toString, toString, toStringEscape, toUnicodeEscape, trace, trace, trace, trace, trace, trace, trace, trace, trace, truncateString, truncateString, wait
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
andThen, apply, applyAsDouble, applyAsInt, applyAsLong, compose, fromKey, getTarget, identity, identityCast, of
andThen, compose
comparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong
protected String m_sMethod
protected Object[] m_aoParam
public ReflectionExtractor()
public ReflectionExtractor(String sMethod)
sMethod
- the name of the method to invoke via reflectionpublic ReflectionExtractor(String sMethod, Object[] aoParam)
sMethod
- the name of the method to invoke via reflectionaoParam
- the array of arguments to be used in the method
invocation; may be null
public ReflectionExtractor(String sMethod, Object[] aoParam, int nTarget)
sMethod
- the name of the method to invoke via reflectionaoParam
- the array of arguments to be used in the method
invocation; may be null
nTarget
- one of the AbstractExtractor.VALUE
or AbstractExtractor.KEY
valuespublic E extract(T oTarget)
extract
in interface ValueExtractor<T,E>
extract
in class AbstractExtractor<T,E>
oTarget
- the targetpublic String getCanonicalName()
ValueExtractor
A canonical name uniquely identifies what is to be extracted, but not how it is to be extracted. Thus two different extractor implementations with the same non-null canonical name are considered to be equal, and should reflect this in their implementations of hashCode and equals.
Canonical names for properties are designated by their property name in camel case,
for instance a Java Bean with method getFooBar
would have a property named fooBar
,
and would have fooBar
as its canonical name.
Canonical names for zero-arg method invocations are the method name followed by ().
Dots in a canonical name delimit one or more property/method accesses represented by a chaining
ValueExtractor such as ChainedExtractor
or
PofExtractor(Class, PofNavigator, String)
.
There is currently no canonical name format for methods which take parameters and
as such they must return a canonical name of null
.
getCanonicalName
in interface com.oracle.coherence.common.base.CanonicallyNamed
getCanonicalName
in interface ValueExtractor<T,E>
getCanonicalName
in class AbstractExtractor<T,E>
null
public boolean equals(Object o)
AbstractExtractor.equals(Object)
contract takes precedence when applicable,
falling back to implementation specific equals.
Two ReflectionExtractor objects, re1 and re2 are considered equal iff re1.extract(o) equals re2.extract(o) for all values of o.
equals
in interface ValueExtractor<T,E>
equals
in interface Comparator
equals
in class AbstractExtractor<T,E>
o
- the reference object with which to comparepublic int hashCode()
canonical name
;
otherwise, it is the hashCode of sName
passed to {#link ReflectionExtractor(String)}.hashCode
in interface ValueExtractor<T,E>
hashCode
in class AbstractExtractor<T,E>
public String toString()
public String getMethodName()
public Object[] getParameters()
protected String computeCanonicalName(String sName, Object[] aoParam)
Steps to compute canonical name from a provided name:
CanonicalNames.VALUE_EXTRACTOR_BEAN_ACCESSOR_PREFIXES
"get" or "is, it is a property. The canonical name is formed by removing that prefix
and converting the first letter to lowercase.foo
:
sName
- a method name unless it starts with "get" or "is", then treated as a propertyaoParam
- optional parametersnull
public void readExternal(DataInput in) throws IOException
readExternal
in interface ExternalizableLite
in
- the DataInput stream to read data from in order to restore
the state of this objectIOException
- if an I/O exception occursNotActiveException
- if the object is not in its initial
state, and therefore cannot be deserialized intopublic void writeExternal(DataOutput out) throws IOException
writeExternal
in interface ExternalizableLite
out
- the DataOutput stream to write the state of this object toIOException
- if an I/O exception occurspublic void readExternal(PofReader in) throws IOException
readExternal
in interface PortableObject
in
- the PofReader from which to read the object's stateIOException
- if an I/O error occurspublic void writeExternal(PofWriter out) throws IOException
writeExternal
in interface PortableObject
out
- the PofWriter to which to write the object's stateIOException
- if an I/O error occurs