com.bigdata.rdf.internal.impl.literal

Class MockedValueIV

java.lang.Object

com.bigdata.rdf.internal.impl.AbstractIV<V,T>

com.bigdata.rdf.internal.impl.AbstractInlineIV<V,T>

com.bigdata.rdf.internal.impl.literal.AbstractLiteralIV<BigdataLiteral,IV<?,?>>

com.bigdata.rdf.internal.impl.literal.MockedValueIV

All Implemented Interfaces:

InlineLiteralIV<BigdataLiteral,IV<?,?>>, IV<BigdataLiteral,IV<?,?>>, IVCache<BigdataLiteral,IV<?,?>>, Serializable, Comparable<IV>, org.openrdf.model.Literal, org.openrdf.model.Value

public class MockedValueIV
extends AbstractLiteralIV<BigdataLiteral,IV<?,?>>

Internally used IV representing a mocked value. The IV contains a delegate, which typically would be something like a fully inlined URI iv (or a fully inlined literal/blank node, respectively). It is just a wrapper to indicate that the delegate is to be translated back into a mocked value. Note that this inherits from AbstractLiteralIV, but does not necessarily reflect a literal: the reflected type depends on the inner type. We do not expose this to the outside (i.e., there's no datatype that can be used for constructing these literals), but this is for internal use only. See BLZG-611.

Author:

Michael Schmidt

See Also:

Serialized Form

Field Summary

Fields inherited from class com.bigdata.rdf.internal.impl.AbstractIV

flags

Constructor Summary

Constructors

Constructor and Description
MockedValueIV(IV<?,?> delegate) Construct an instance using the delegate.

Method Summary

Methods

Modifier and Type	Method and Description
int	_compareTo(IV o) Compare two IVs having the same intrinsic datatype.
BigdataLiteral	asValue(LexiconRelation lex) This IV cannot be materialized on its own.
int	byteLength() The byte length of the encoded IV.
MockedValueIV	clone(boolean clearCache) Return a copy of this IV.
boolean	equals(Object obj) Return true iff the two IVs are the same point in the same value space.
DTEExtension	getDTEX() IFF IV.getDTE() returns DTE.Extension then this method will report the DTEExtension value that specifies the intrinsic datatype for this IV.
IV<?,?>	getInlineValue() We could theoretically get all the inline values from the inline IVs and return them here.
IV<?,?>	getIV()
String	getLabel() Implement Literal.getLabel() for logging.
int	hashCode() Return a hash code based on the value of the point in the value space.

Methods inherited from class com.bigdata.rdf.internal.impl.literal.AbstractLiteralIV

booleanValue, byteValue, calendarValue, decimalValue, doubleValue, floatValue, getDatatype, getLanguage, integerValue, intValue, longValue, needsMaterialization, shortValue, stringValue, toString

Methods inherited from class com.bigdata.rdf.internal.impl.AbstractInlineIV

isInline

Methods inherited from class com.bigdata.rdf.internal.impl.AbstractIV

compareTo, encode, flags, getDTE, getDTE, getInternalValueTypeEnum, getValue, getValueCache, getVTE, getVTE, hasValue, isBigNumeric, isBNode, isExtension, isExtension, isFixedNumeric, isFloatingPointNumeric, isInline, isLiteral, isNullIV, isNumeric, isResource, isSignedNumeric, isStatement, isUnsignedNumeric, isURI, isVocabulary, setValue, toFlags

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.bigdata.rdf.internal.IV

encode, flags, getDTE, getVTE, isBigNumeric, isBNode, isExtension, isFixedNumeric, isFloatingPointNumeric, isInline, isLiteral, isNullIV, isNumeric, isResource, isSignedNumeric, isStatement, isUnsignedNumeric, isURI, isVocabulary

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface com.bigdata.rdf.internal.IVCache

getValue, hasValue, setValue

Constructor Detail

MockedValueIV

public MockedValueIV(IV<?,?> delegate)

Construct an instance using the delegate.

Parameters:

delegate - the delegate

Method Detail

getDTEX

public DTEExtension getDTEX()

Description copied from interface: IV

IFF IV.getDTE() returns DTE.Extension then this method will report the DTEExtension value that specifies the intrinsic datatype for this IV.

Specified by:

getDTEX in interface IV<BigdataLiteral,IV<?,?>>

Overrides:

getDTEX in class AbstractIV<BigdataLiteral,IV<?,?>>

See Also:

(Implement support for DTE extension types for URIs), ( DTEExtension for compressed timestamp)

getIV

public IV<?,?> getIV()

byteLength

public int byteLength()

Description copied from interface: IV

The byte length of the encoded IV.

clone

public MockedValueIV clone(boolean clearCache)

Description copied from interface: IVCache

Return a copy of this IV.

Note: This method exists to defeat the hard reference from the IV to the cached BigdataValue in order to avoid a memory leak when the IV is used as the key in a weak value cache whose value is the BigdataValue. Therefore, certain IV implementations MAY return this when they are used for limited collections. The vocabulary IVs are the primary example. For the same reason, we do not need to recursively break the link from the IV to the BigdataValue for IVs which embed other IVs.

Parameters:

clearCache - When true the cached reference (if any) will NOT be set on the copy.

Returns:

The copy.

See Also:

(Thread-local cache combined with unbounded thread pools causes effective memory leak)

_compareTo

public int _compareTo(IV o)

Description copied from class: AbstractIV

Compare two IVs having the same intrinsic datatype.

Specified by:

_compareTo in class AbstractIV<BigdataLiteral,IV<?,?>>

hashCode

public int hashCode()

Description copied from class: AbstractIV

Return a hash code based on the value of the point in the value space.

Note: The IV implementations typically DO NOT return hash codes that are consistent with BigdataValue#hashCode(). Therefore you MUST NOT mix IVs and BigdataValues in the keys of a map or the values of a set.

Specified by:

hashCode in interface org.openrdf.model.Literal

Specified by:

hashCode in class AbstractIV<BigdataLiteral,IV<?,?>>

equals

public boolean equals(Object obj)

Description copied from class: AbstractIV

Return true iff the two IVs are the same point in the same value space. Points in different value spaces (as identified by different datatype URIs) are NOT equal even if they have the same value in the corresponding primitive data type.

Note: The IV implementations typically DO NOT compare equals() with BigdataValues. Therefore you MUST NOT mix IVs and BigdataValues in the keys of a map or the values of a set.

Specified by:

equals in interface org.openrdf.model.Literal

Specified by:

equals in class AbstractIV<BigdataLiteral,IV<?,?>>

getLabel

public String getLabel()

Implement Literal.getLabel() for logging. Superclass uses inline value.

Specified by:

getLabel in interface org.openrdf.model.Literal

Overrides:

getLabel in class AbstractLiteralIV<BigdataLiteral,IV<?,?>>

getInlineValue

public IV<?,?> getInlineValue()
                       throws UnsupportedOperationException

We could theoretically get all the inline values from the inline IVs and return them here.

Returns:

The Object.

Throws:

UnsupportedOperationException - unless the RDF value is inline.

asValue

public BigdataLiteral asValue(LexiconRelation lex)
                       throws UnsupportedOperationException

This IV cannot be materialized on its own.

Parameters:

lex - The lexicon relation (this is required in order to access the BigdataValueFactory for the namespace associated with lexicon when we materialize an inline IV).

Returns:

The corresponding BigdataValue.

Throws:

UnsupportedOperationException - if the IV does not represent something which can be materialized. For example, a dummy value or a "null".