public class ReflectionExtractor<T,E> extends AbstractExtractor<T,E> implements ValueExtractor<T,E>, ExternalizableLite, PortableObject
ChainedExtractorExternalizableHelper.DecoratedMultiBufferReadBuffer, ExternalizableHelper.DefaultObjectStreamFactory, ExternalizableHelper.FormatAwareCompressor, ExternalizableHelper.IntDecoratedObject, ExternalizableHelper.Shielded, ExternalizableHelper.ShieldedDataOutputStream, ExternalizableHelper.ShieldedInputStream, ExternalizableHelper.ShieldedObjectOutputStream, ExternalizableHelper.ShieldedOutputStream, ExternalizableHelper.SimpleXmlBeanClassCache, ExternalizableHelper.Stats, ExternalizableHelper.XmlBeanClassCacheBase.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, VALUECHUNK_SIZE, CHUNK_THRESHOLD, 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_TOPLINK, 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, isCanonicallyEquatableasBinary, calculatePackedLength, calculatePackedLength, checkObjectInputFilter, checkObjectInputFilter, checkObjectInputFilter, convertUTF, decodeExpiry, decorate, decorate, decorate, decorate, decorate, decorateBinary, encodeExpiry, ensureSerializer, extractIntDecoration, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromBinary, fromByteArray, fromByteArray, getClass, getConfigSerialFilter, getConfigSerialFilterFactory, getDecoration, getDecoration, getDecorations, getDeltaCompressor, getInputStream, getNewObjectInput, getObjectInput, getObjectInputFilter, getObjectOutput, getObjectStreamFactory, getOutputStream, getShieldedOutputStream, getStreamFormat, getUndecorated, getUndecorated, isDecorated, isDecorated, isIntDecorated, isIntDecorated, isResolving, isSerializable, isSerializerCompatible, isVersionCompatible, isVersionCompatible, loadClass, loadResource, main, makeTrint, readBigDecimal, readBigInteger, readBooleanArray, readBooleanArray, readByteArray, readCharArray, readCharArray, readCollection, readDate, readDoubleArray, readDoubleArray, readExternalizableLite, readExternalizableLite, readFloatArray, readFloatArray, readInt, readInt, readIntArray, readIntArray, readIntArray2d, readLargeBooleanArray, readLargeByteArray, readLargeCharArray, readLargeDoubleArray, readLargeFloatArray, readLargeIntArray, readLargeLongArray, readLargeObjectArray, readLargeStringArray, readLong, readLong, readLongArray, readLongArray, readMap, readMap, readObject, readObject, readObjectArray, readObjectArray, readSafeUTF, readSafeUTF, readSerializable, readSerializable, readStringArray, readStringArray, readTime, readTimestamp, readTrint, readUnsignedTrint, readUTF, readXmlBean, readXmlSerializable, readXmlSerializable, realize, removeIntDecoration, removeIntDecoration, replace, reportIncompatibleSerializers, setObjectStreamFactory, toBinary, toBinary, toBinary, toByteArray, toByteArray, toByteArray, toLiteBinary, toLong, undecorate, undecorate, validateBufferSize, validateLoadArray, validateLoadClass, 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, writeXmlSerializablecountBits, countBits, countBits, indexOfLSB, indexOfLSB, indexOfLSB, indexOfMSB, indexOfMSB, indexOfMSB, rotateLeft, rotateLeft, rotateLeft, rotateRight, rotateRight, rotateRight, toBitString, toBitString, toBitString, toBytes, toBytes, toBytes, toBytes, toInt, toInt, toLongazzert, 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, getRandom, getRandomBinary, getRandomBinary, getRandomString, getSafeTimeMillis, getStackFrame, getStackFrames, getStackTrace, getStackTrace, getStackTrace, getThreadFactory, getTimeZone, getUpTimeMillis, hashCode, hexValue, indentString, indentString, isDecimal, isHex, isLogEcho, isOctal, log, log, log, log, log, makeInteger, makeLong, makeThread, mergeArray, mergeBooleanArray, mergeByteArray, mergeCharArray, mergeDoubleArray, mergeFloatArray, mergeIntArray, mergeLongArray, 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, waitclone, finalize, getClass, notify, notifyAll, wait, wait, waitandThen, apply, applyAsDouble, applyAsInt, applyAsLong, compose, fromKey, getTarget, identity, identityCast, ofandThen, composecomparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLongprotected 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 nullpublic 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 nullnTarget - 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()
ValueExtractorA 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 CanonicallyNamedgetCanonicalName in interface ValueExtractor<T,E>getCanonicalName in class AbstractExtractor<T,E>nullpublic 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 Comparatorequals 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 parametersnullpublic void readExternal(DataInput in) throws IOException
readExternal in interface ExternalizableLitein - 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 ExternalizableLiteout - 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 PortableObjectin - 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 PortableObjectout - the PofWriter to which to write the object's stateIOException - if an I/O error occurs