com.bigdata.rdf.internal.impl.literal

Class LiteralArrayIV

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,Object[]>

com.bigdata.rdf.internal.impl.literal.LiteralArrayIV

All Implemented Interfaces:

InlineLiteralIV<BigdataLiteral,Object[]>, IV<BigdataLiteral,Object[]>, IVCache<BigdataLiteral,Object[]>, Serializable, Comparable<IV>, org.openrdf.model.Literal, org.openrdf.model.Value

public class LiteralArrayIV
extends AbstractLiteralIV<BigdataLiteral,Object[]>

An inline literal IV composed of an array of other inline literal IVs. This IV is meant to be used with LiteralExtensionIV and URIExtensionIV as the delegate for an inline literal extension or an inline URI. This IV is not directly materializable into a Literal outside the context of a literal extension factory or an inline URI handler.

Encoded as flags, DTE.ARRAY, array length, array. The array length is encoded using a single byte, so the maximum array length is 256 elements (empty arrays are not allowed).

Author:

mikepersonick

See Also:

LiteralExtensionIV}, URIExtensionIV}, InlineURIHandler}, IExtension}, Serialized Form

Field Summary

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

flags

Constructor Summary

Constructors

Constructor and Description
LiteralArrayIV(InlineLiteralIV<?,?>... ivs) Construct an instance using the supplied inline literal IVs.

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.
LiteralArrayIV	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.
Object[]	getInlineValue() We could theoretically get all the inline values from the inline IVs and return them here.
InlineLiteralIV<?,?>[]	getIVs()
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

LiteralArrayIV

public LiteralArrayIV(InlineLiteralIV<?,?>... ivs)

Construct an instance using the supplied inline literal IVs. The array must not be empty and must not be more than 256 elements (using one byte to encode the array length).

Parameters:

ivs - the inline literal IVs

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,Object[]>

Overrides:

getDTEX in class AbstractIV<BigdataLiteral,Object[]>

See Also:

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

getIVs

public InlineLiteralIV<?,?>[] getIVs()

byteLength

public int byteLength()

Description copied from interface: IV

The byte length of the encoded IV.

clone

public LiteralArrayIV 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,Object[]>

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,Object[]>

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,Object[]>

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,Object[]>

getInlineValue

public Object[] 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. It can only be used within the context of a URIExtensionIV or LiteralExtensionIV as the delegate in cases where the extension mechanism needs an array of inline IVs to represent its URI or Literal respectively.

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