com.bigdata.rdf.internal.impl.uri

Class FullyInlineURIIV<V extends BigdataURI>

java.lang.Object

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

com.bigdata.rdf.internal.impl.AbstractInlineIV<V,org.openrdf.model.URI>

com.bigdata.rdf.internal.impl.uri.FullyInlineURIIV<V>

All Implemented Interfaces:

IInlineUnicode, IV<V,org.openrdf.model.URI>, IVCache<V,org.openrdf.model.URI>, Serializable, Comparable<IV>, org.openrdf.model.Resource, org.openrdf.model.URI, org.openrdf.model.Value

public class FullyInlineURIIV<V extends BigdataURI>
extends AbstractInlineIV<V,org.openrdf.model.URI>
implements IInlineUnicode, org.openrdf.model.URI

Implementation for inline URIs. All information is inlined. This class is mainly targeted at inlining at fully inlining URIs in scale-out (which can be an attractive option).

See Also:

Serialized Form

Field Summary

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

flags

Constructor Summary

Constructors

Constructor and Description
FullyInlineURIIV(org.openrdf.model.URI uri)
FullyInlineURIIV(org.openrdf.model.URI uri, int byteLength)

Method Summary

Methods

Modifier and Type	Method and Description
int	_compareTo(IV o) Compare two IVs having the same intrinsic datatype.
V	asValue(LexiconRelation lex) If the value is not already cached, then inflate an inline RDF value to a BigdataValue and cache it on a private field.
int	byteLength() The byte length of the encoded IV.
IV<V,org.openrdf.model.URI>	clone(boolean clearCache) Return a copy of this IV.
boolean	equals(Object o) Return true iff the two IVs are the same point in the same value space.
org.openrdf.model.URI	getInlineValue() Return the Java Object corresponding to the inline value.
String	getLocalName() Implements URI.getLocalName().
String	getNamespace() Implements URI.getNamespace().
int	hashCode() Return the hash code of the URI's string value (per the openrdf API).
boolean	needsMaterialization() Because we this is a fully inlined URI, we do not need the materialized URI to answer the URI interface methods.
void	setByteLength(int byteLength) Cache the byteLength on the IV.
String	stringValue() Implements Value.stringValue().
String	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, getDTEX, 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

Constructor Detail

FullyInlineURIIV

public FullyInlineURIIV(org.openrdf.model.URI uri)

FullyInlineURIIV

public FullyInlineURIIV(org.openrdf.model.URI uri,
                int byteLength)

Method Detail

clone

public IV<V,org.openrdf.model.URI> 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.

Specified by:

clone in interface IVCache<V extends BigdataURI,org.openrdf.model.URI>

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)

getInlineValue

public final org.openrdf.model.URI getInlineValue()

Description copied from interface: IV

Return the Java Object corresponding to the inline value.

Specified by:

getInlineValue in interface IV<V extends BigdataURI,org.openrdf.model.URI>

Returns:

The Object.

toString

public final String toString()

Specified by:

toString in interface org.openrdf.model.URI

Overrides:

toString in class Object

asValue

public V asValue(LexiconRelation lex)

Description copied from interface: IVCache

If the value is not already cached, then inflate an inline RDF value to a BigdataValue and cache it on a private field.

Note: Query plans are responsible for ensuring that IVs have been materialized before operators are evaluated which invoke this method. This pattern ensures that efficient batch operators are used to materialize Values, and thereby avoids heavy RMI overhead in scale-out, and provides operators which use IVCache.getValue() with a simple method signature which does not require access to the lexicon. Query plans are also responsible for dropping variables once they are no longer needed or, in the case of large values and BLOBs, dropping the cached BigdataValue when possible in order to avoid excess network and heap overhead.

Specified by:

asValue in interface IVCache<V extends BigdataURI,org.openrdf.model.URI>

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.

equals

public boolean equals(Object o)

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.URI

Specified by:

equals in class AbstractIV<V extends BigdataURI,org.openrdf.model.URI>

hashCode

public int hashCode()

Return the hash code of the URI's string value (per the openrdf API).

Specified by:

hashCode in interface org.openrdf.model.URI

Specified by:

hashCode in class AbstractIV<V extends BigdataURI,org.openrdf.model.URI>

byteLength

public int byteLength()

Description copied from interface: IV

The byte length of the encoded IV.

Specified by:

byteLength in interface IV<V extends BigdataURI,org.openrdf.model.URI>

setByteLength

public final void setByteLength(int byteLength)

Description copied from interface: IInlineUnicode

Cache the byteLength on the IV.

Specified by:

setByteLength in interface IInlineUnicode

Parameters:

byteLength - The byteLength.

_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<V extends BigdataURI,org.openrdf.model.URI>

needsMaterialization

public boolean needsMaterialization()

Because we this is a fully inlined URI, we do not need the materialized URI to answer the URI interface methods.

Specified by:

needsMaterialization in interface IV<V extends BigdataURI,org.openrdf.model.URI>

stringValue

public String stringValue()

Implements Value.stringValue().

Specified by:

stringValue in interface org.openrdf.model.Value

getLocalName

public String getLocalName()

Implements URI.getLocalName().

Specified by:

getLocalName in interface org.openrdf.model.URI

getNamespace

public String getNamespace()

Implements URI.getNamespace().

Specified by:

getNamespace in interface org.openrdf.model.URI