public class ConditionalExtractor<T,E> extends AbstractExtractor<T,E> implements IndexAwareExtractor<T,E>, ExternalizableLite, PortableObject
ConditionalIndex.
Note: the underlying ValueExtractor is used for value extraction during
index creation and is the extractor that is associated with the created
ConditionalIndex in the given index map. Using the
ConditionalExtractor to extract values in not supported.
ExternalizableHelper.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 ValueExtractor<T,E> |
m_extractor
The underlying extractor.
|
protected boolean |
m_fForwardIndex
Specifies whether or not this extractor will create a
ConditionalIndex that supports a forward index. |
protected Filter |
m_filter
The filter used by this extractor.
|
protected boolean |
m_fOptimizeMV
For an indexed value that is a multi-value (Collection or array) this flag
specifies whether an attempt should be made to search the forward map
for an existing reference that is "equal" to the specified multi-value
and use it instead (if available) to reduce the index memory footprint.
|
KEY, m_nTarget, m_sNameCanon, VALUECONVERTER_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 |
|---|
ConditionalExtractor()
Construct the ConditionalExtractor.
|
ConditionalExtractor(Filter filter,
ValueExtractor<T,E> extractor,
boolean fForwardIndex)
Construct the ConditionalExtractor.
|
ConditionalExtractor(Filter filter,
ValueExtractor<T,E> extractor,
boolean fForwardIndex,
boolean fOptimizeMV)
Construct the ConditionalExtractor.
|
| Modifier and Type | Method and Description |
|---|---|
MapIndex |
createIndex(boolean fOrdered,
Comparator comparator,
Map<ValueExtractor<T,E>,MapIndex> mapIndex,
BackingMapContext ctx)
Create an index and associate it with the corresponding extractor.
|
MapIndex |
destroyIndex(Map<ValueExtractor<T,E>,MapIndex> mapIndex)
Destroy an existing index and remove it from the given map of indexes.
|
boolean |
equals(Object o)
Equivalence by canonical name and target.
|
E |
extract(Object oTarget)
Using a ConditionalExtractor to extract values in not supported.
|
ValueExtractor |
getExtractor() |
int |
hashCode()
HashCode value is hashCode of non-null
canonical name;
otherwise, it is the identity hashCode value. |
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()
Return a human-readable description for this ConditionalExtractor.
|
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, getCanonicalName, getTarget, isCanonicallyEquatableasBinary, 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, 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, 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, waitclone, finalize, getClass, notify, notifyAll, wait, wait, waitgetExtractorandThen, apply, applyAsDouble, applyAsInt, applyAsLong, compose, fromKey, getCanonicalName, getTarget, identity, identityCast, ofandThen, composecomparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLongprotected Filter m_filter
protected ValueExtractor<T,E> m_extractor
protected boolean m_fForwardIndex
ConditionalIndex that supports a forward index.protected boolean m_fOptimizeMV
Note, that even if this optimization is allowed, the full search could be quite expensive and our algorithm will always limit the number of cycles it spends on the search.
public ConditionalExtractor()
public ConditionalExtractor(Filter filter, ValueExtractor<T,E> extractor, boolean fForwardIndex)
filter - the filter used by this extractor to create a
ConditionalIndex; must not be null.extractor - the extractor used by this extractor to create a
ConditionalIndex; Note that the created
index will be associated with this extractor in
the given index map; must not be nullfForwardIndex - specifies whether or not this extractor
will create a ConditionalIndex
that supports a forward mappublic ConditionalExtractor(Filter filter, ValueExtractor<T,E> extractor, boolean fForwardIndex, boolean fOptimizeMV)
filter - the filter used by this extractor to create a
ConditionalIndex; must not be null.extractor - the extractor used by this extractor to create a
ConditionalIndex; Note that the created
index will be associated with this extractor in
the given index map; must not be nullfForwardIndex - specifies whether or not this extractor
will create a ConditionalIndex
that supports a forward mapfOptimizeMV - specifies whether an attempt should be made to
search the forward map for an existing reference
that is "equal" to the specified multi-value
and use it instead (if available) to reduce the
index memory footprintpublic MapIndex createIndex(boolean fOrdered, Comparator comparator, Map<ValueExtractor<T,E>,MapIndex> mapIndex, BackingMapContext ctx)
createIndex in interface IndexAwareExtractor<T,E>fOrdered - true iff the contents of the indexed information
should be ordered; false otherwisecomparator - the Comparator object which imposes an ordering
of entries in the index contents; or null
if the entries' values natural ordering should be
usedmapIndex - Map<ValueExtractor, MapIndex> to be updated with the
created indexctx - The context the index is
associate with.public MapIndex destroyIndex(Map<ValueExtractor<T,E>,MapIndex> mapIndex)
destroyIndex in interface IndexAwareExtractor<T,E>mapIndex - map<ValueExtractor, MapIndex> to be updated by
removing the index being destroyedpublic ValueExtractor getExtractor()
public E extract(Object oTarget)
extract in interface ValueExtractor<T,E>extract in class AbstractExtractor<T,E>oTarget - the object to extract the value fromUnsupportedOperationException - alwayspublic 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 occurspublic boolean equals(Object o)
When precondition AbstractExtractor.isCanonicallyEquatable(Object) is false,
fall back to implementation specific equals implementation.
equals in interface ValueExtractor<T,E>equals in interface Comparatorequals in class AbstractExtractor<T,E>o - the reference object with which to comparetrue if canonical name match and no target mismatchpublic int hashCode()
canonical name;
otherwise, it is the identity hashCode value.
Subclass computes hashCode when canonical name is null.
hashCode in interface ValueExtractor<T,E>hashCode in class AbstractExtractor<T,E>