com.bigdata.rdf.internal

Enum DTEExtension

java.lang.Object

java.lang.Enum<DTEExtension>

com.bigdata.rdf.internal.DTEExtension

All Implemented Interfaces:

Serializable, Comparable<DTEExtension>

public enum DTEExtension
extends Enum<DTEExtension>

An extension of the intrinsic types defined by DTE.

Author:

bryan

See Also:

(Implement support for DTE extension types for URIs) TODO add a variable length nibble encoding of a byte[]?

Enum Constant Summary

Enum Constants

Enum Constant and Description
ARRAY An array of inline IVs.
IPV4 An IPV4 address.
MOCKED_IV An mocked IV (used internally).
PACKED_LONG A packed long value, restricted to the range [0;72057594037927935L].
RESERVED This is a place holder for extension of the intrinsic data types.

Method Summary

Methods

Modifier and Type	Method and Description
Class<?>	getCls() The class of the Java object used to represent instances of the coded data type.
org.openrdf.model.URI	getDatatypeURI() The corresponding datatype URI.
int	len() The length of the data type value when represented as a component in an unsigned byte[] key -or- ZERO iff the key component has a variable length for that data type.
byte	v() An byte value whose whose lower 6 bits code the DTE.
static DTEExtension	valueOf(byte b)
static DTEExtension	valueOf(String name) Returns the enum constant of this type with the specified name.
static DTEExtension	valueOf(org.openrdf.model.URI datatype) Return the DTEExtension for the datatype URI.
static DTEExtension[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

IPV4

public static final DTEExtension IPV4

An IPV4 address.

PACKED_LONG

public static final DTEExtension PACKED_LONG

A packed long value, restricted to 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.

ARRAY

public static final DTEExtension ARRAY

An array of inline IVs.

MOCKED_IV

public static final DTEExtension MOCKED_IV

An mocked IV (used internally).

RESERVED

public static final DTEExtension RESERVED

This is a place holder for extension of the intrinsic data types. Its code corresponds to 0xff, which is to say all four bits are on. When this code is used, the next byte(s) must be examined to determine the actual intrinsic data type.

Note: This is NOT the same as the AbstractIV.isExtension() bit. The latter always indicates that an IV follows the flags byte and indicates the actual datatype URI. In contrast, RESERVED is a placeholder that could give us another byte to handle additional "intrinsic" types.

See Also:

(Implement support for DTE extension types for URIs) TODO If we wind up extending things again, it would perhaps be nicer to have an extension mechanism for non-intrinsic data types (ones that can be registered without having to explicitly create them in the code).

Method Detail

values

public static DTEExtension[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DTEExtension c : DTEExtension.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DTEExtension valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

valueOf

public static final DTEExtension valueOf(byte b)

valueOf

public static final DTEExtension valueOf(org.openrdf.model.URI datatype)

Return the DTEExtension for the datatype URI.

Parameters:

datatype - The datatype URI.

Returns:

The DTEException for that datatype -or- null if the datatype URI is none of the datatypes for which native support is provided.

v

public final byte v()

An byte value whose whose lower 6 bits code the DTE.

len

public final int len()

The length of the data type value when represented as a component in an unsigned byte[] key -or- ZERO iff the key component has a variable length for that data type.

getCls

public final Class<?> getCls()

The class of the Java object used to represent instances of the coded data type.

getDatatypeURI

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

The corresponding datatype URI.