com.bigdata.rdf.model

Interface BigdataValue

All Superinterfaces:

IElement, Serializable, org.openrdf.model.Value

All Known Subinterfaces:

BigdataBNode, BigdataLiteral, BigdataResource, BigdataURI

All Known Implementing Classes:

BigdataBNodeImpl, BigdataLiteralImpl, BigdataResourceImpl, BigdataURIImpl, BigdataValueImpl

public interface BigdataValue
extends org.openrdf.model.Value, IElement

An interface which exposes the internal 64-bit long integer identifiers for Values stored within a IRawTripleStore. Values may also be stored inline inside the statement indices rather than referencing the lexicon. See IV.

Version:

$Id$

Author:

Bryan Thompson

Method Summary

Methods

Modifier and Type	Method and Description
void	clearInternalValue() Clears the internal value to null.
IV	getIV() Return the internal value for this value.
BigdataValueFactory	getValueFactory() Return the factory which produced this object.
boolean	isRealIV() Return true if the IV is either is set to a "real" IV.
void	setIV(IV iv) Set the internal value for this value.

Methods inherited from interface org.openrdf.model.Value

stringValue

Methods inherited from interface com.bigdata.bop.IElement

get

Method Detail

getValueFactory

BigdataValueFactory getValueFactory()

Return the factory which produced this object. This is guaranteed to be a singleton (there will only be one BigdataValueFactory instance for on a given JVM for all BigdataValues associated with a given lexicon relation namespace).

getIV

IV getIV()

Return the internal value for this value. May be a term identifier or an inline value. The term identifier uniquely identifies a Value for a database. Sometimes a TempTripleStore will be used that shares the lexicon with a given database, in which case the same term identifiers will be value for that TempTripleStore.

setIV

void setIV(IV iv)

Set the internal value for this value.

Note: Both IV and BigdataValue can cache one another. The pattern for caching is that you always cache the IV on the BigdataValue using setIV(IV). However, the BigdataValue is normally NOT cached on the IV. The exception is when the BigdataValue has been materialized from the IV by joining against the lexicon. The query plan is responsible for deciding when to materialize the BigdataValue from the IV.

Parameters:

iv - The internal value.

Throws:

IllegalArgumentException - if iv is null.

IllegalStateException - if the internal value is already set to a different non-null value.

isRealIV

boolean isRealIV()

Return true if the IV is either is set to a "real" IV. Return false if the IV is either not set or is set to a "mock" or "dummy" IV.

clearInternalValue

void clearInternalValue()

Clears the internal value to null.