com.bigdata.rdf.model
Interface BigdataValue

All Superinterfaces:
IElement, Serializable, Value
All Known Subinterfaces:
BigdataBNode, BigdataLiteral, BigdataResource, BigdataURI
All Known Implementing Classes:
BigdataBNodeImpl, BigdataLiteralImpl, BigdataResourceImpl, BigdataURIImpl, BigdataValueImpl

public interface BigdataValue
extends 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: BigdataValue.java 5829 2012-01-02 21:26:28Z thompsonbry $
Author:
Bryan Thompson

Method Summary
 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.



Copyright © 2006-2012 SYSTAP, LLC. All Rights Reserved.