com.bigdata.rdf.internal.impl.literal

Class PackedLongIV<V extends BigdataLiteral>

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<V,Long>

com.bigdata.rdf.internal.impl.literal.PackedLongIV<V>

All Implemented Interfaces:

InlineLiteralIV<V,Long>, IV<V,Long>, IVCache<V,Long>, Serializable, Comparable<IV>, org.openrdf.model.Literal, org.openrdf.model.Value

public class PackedLongIV<V extends BigdataLiteral>
extends AbstractLiteralIV<V,Long>
implements Serializable, org.openrdf.model.Literal

Internal value representing a packed long in the range [0;72057594037927935L]. Note that this is not the full range of long (negative values are not supported and positive long values in [72057594037927936L;Long.MAX] are not supported), the reason being that the compression technique we're using is order preserving only for the valid range.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	MAX_POS_LONG_WITH_LEADING_ZERO_BYTE The PackedLongIV uses the LongPacker to compress values.
static org.openrdf.model.URI	PACKED_LONG

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

flags

Constructor Summary

Constructors

Constructor and Description
PackedLongIV(long value) Ctor with internal value specified.
PackedLongIV(String value) Ctor with string value specified.

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) Returns the Literal representation of this IV.
boolean	booleanValue() Implement Literal.booleanValue().
int	byteLength() Return the byte length for the byte[] encoded representation of this internal value.
IV<V,Long>	clone(boolean clearCache) Return a copy of this IV.
BigDecimal	decimalValue() Implement Literal.decimalValue().
double	doubleValue() Implement Literal.doubleValue().
boolean	equals(Object o) Two PackedLongIV are equal if their InetAddresses are equal.
float	floatValue() Implement Literal.floatValue().
DTEExtension	getDTEX() IFF IV.getDTE() returns DTE.Extension then this method will report the DTEExtension value that specifies the intrinsic datatype for this IV.
Long	getInlineValue() Returns the inline value.
String	getLabel() Implement Literal.getLabel().
int	hashCode() Return a hash code based on the value of the point in the value space.
BigInteger	integerValue() Implement Literal.integerValue().
int	intValue() Implement Literal.intValue().
long	longValue() Implement Literal.longValue().
short	shortValue() Implement Literal.shortValue().
String	toString()

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

byteValue, calendarValue, getDatatype, getLanguage, needsMaterialization, stringValue

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 org.openrdf.model.Literal

byteValue, calendarValue, getDatatype, getLanguage

Methods inherited from interface org.openrdf.model.Value

stringValue

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

Field Detail

PACKED_LONG

public static final org.openrdf.model.URI PACKED_LONG

MAX_POS_LONG_WITH_LEADING_ZERO_BYTE

public static final long MAX_POS_LONG_WITH_LEADING_ZERO_BYTE

The PackedLongIV uses the LongPacker to compress values. LongPacker.packLong(long, byte[], com.bigdata.io.LongPacker.IByteBuffer) is order preserving whenever the first byte is 0. Since the IV relies on an order preserving encoding, we restrict the supported range to values in [0;MAX_POS_LONG_WITH_LEADING_ZERO_BYTE], where MAX_POS_LONG_WITH_LEADING_ZERO_BYTE corresponds to the 64bit string 00000000111111111111111..., which equals 72057594037927935L. The value was (statically) verified as follows: long v1 = 72057594037927935L; long v2 = 72057594037927936L; System.out.println(( ( v1 >> 56 ) != 0 )); // condition used in LongPacker System.out.println(( ( v2 >> 56 ) != 0 )); // condition used in LongPacker outputs "false" followed by "true".

See Also:

Constant Field Values

Constructor Detail

PackedLongIV

public PackedLongIV(String value)

Ctor with string value specified.

PackedLongIV

public PackedLongIV(long value)

Ctor with internal value specified.

Method Detail

clone

public IV<V,Long> 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 BigdataLiteral,Long>

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 Long getInlineValue()
                    throws UnsupportedOperationException

Returns the inline value.

Specified by:

getInlineValue in interface IV<V extends BigdataLiteral,Long>

Returns:

The Object.

Throws:

UnsupportedOperationException - unless the RDF value is inline.

asValue

public V asValue(LexiconRelation lex)

Returns the Literal representation of this IV.

Specified by:

asValue in interface IVCache<V extends BigdataLiteral,Long>

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.

byteLength

public int byteLength()

Return the byte length for the byte[] encoded representation of this internal value. Depends on the byte length of the encoded inline value.

Specified by:

byteLength in interface IV<V extends BigdataLiteral,Long>

toString

public String toString()

Overrides:

toString in class AbstractLiteralIV<V extends BigdataLiteral,Long>

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<V extends BigdataLiteral,Long>

getLabel

public String getLabel()

Description copied from class: AbstractLiteralIV

Implement Literal.getLabel().

Specified by:

getLabel in interface org.openrdf.model.Literal

Overrides:

getLabel in class AbstractLiteralIV<V extends BigdataLiteral,Long>

equals

public boolean equals(Object o)

Two PackedLongIV are equal if their InetAddresses are equal.

Specified by:

equals in interface org.openrdf.model.Literal

Specified by:

equals in class AbstractIV<V extends BigdataLiteral,Long>

_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 BigdataLiteral,Long>

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<V extends BigdataLiteral,Long>

Overrides:

getDTEX in class AbstractIV<V extends BigdataLiteral,Long>

See Also:

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

booleanValue

public boolean booleanValue()

Implement Literal.booleanValue().

Specified by:

booleanValue in interface org.openrdf.model.Literal

Overrides:

booleanValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

shortValue

public short shortValue()

Implement Literal.shortValue().

Specified by:

shortValue in interface org.openrdf.model.Literal

Overrides:

shortValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

intValue

public int intValue()

Implement Literal.intValue().

Specified by:

intValue in interface org.openrdf.model.Literal

Overrides:

intValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

longValue

public long longValue()

Implement Literal.longValue().

Specified by:

longValue in interface org.openrdf.model.Literal

Overrides:

longValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

floatValue

public float floatValue()

Implement Literal.floatValue().

Specified by:

floatValue in interface org.openrdf.model.Literal

Overrides:

floatValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

doubleValue

public double doubleValue()

Implement Literal.doubleValue().

Specified by:

doubleValue in interface org.openrdf.model.Literal

Overrides:

doubleValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

integerValue

public BigInteger integerValue()

Implement Literal.integerValue().

Specified by:

integerValue in interface org.openrdf.model.Literal

Overrides:

integerValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>

decimalValue

public BigDecimal decimalValue()

Implement Literal.decimalValue().

Specified by:

decimalValue in interface org.openrdf.model.Literal

Overrides:

decimalValue in class AbstractLiteralIV<V extends BigdataLiteral,Long>