org.cloudgraph.store.mapping.codec

Class NativeKeyFieldCodec

java.lang.Object

org.cloudgraph.store.mapping.codec.DefaultKeyFieldCodec

org.cloudgraph.store.mapping.codec.NativeKeyFieldCodec

All Implemented Interfaces:

KeyFieldCodec

public class NativeKeyFieldCodec
extends DefaultKeyFieldCodec
implements KeyFieldCodec

A non-lexicographic KeyFieldCodec which emits the DataType specific native byte representation for the given value. This codec cannot be used for composite row keys, as the native encoding of say integral types may easily result in, for example one byte out of a 4-byte int being the same byte/char as the declared delimiter field. Support for certain binary compatible delimiter characters like '\0' should be explored.

This codec saves on space by terminating with the minimum added bytes possible for the native DataType.

Since:

1.1.0

Author:

Scott Cinnamond

See Also:

Type, DataFlavor

Field Summary

Fields inherited from class org.cloudgraph.store.mapping.codec.DefaultKeyFieldCodec

keyField

Constructor Summary

Constructors

Constructor and Description
NativeKeyFieldCodec(KeyFieldMapping keyField)

Method Summary

Modifier and Type	Method and Description
boolean	checkEncodeOverflow(byte[] keyValue) Returns true if the given encoded value will overflow the underlying key field.
Object	decode(byte[] value) Returns the object representation for the given encoded bytes value.
byte[]	encode(Object value) Returns the encoded bytes representation for the given object or literal value.
byte[]	encodeNext(Object value) Returns the encoded "next" bytes representation for the given object or literal value, where the next value depends on the coded implementation and may typically be the lexicographic next value.
org.plasma.sdo.DataFlavor	getDataFlavor()
boolean	isLexicographic() Return true if the encoded values support lexicographic ordering.
boolean	isTransforming() Return true if the encoded values are fundamentally transformed father than formatted or padded in some way.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NativeKeyFieldCodec

public NativeKeyFieldCodec(KeyFieldMapping keyField)

Method Detail

isLexicographic

public boolean isLexicographic()

Description copied from interface: KeyFieldCodec

Return true if the encoded values support lexicographic ordering. For example integer values are not encoded natively but as the integer string representation.

Specified by:

isLexicographic in interface KeyFieldCodec

Returns:

true if the encoded values support lexicographic ordering

isTransforming

public boolean isTransforming()

Description copied from interface: KeyFieldCodec

Return true if the encoded values are fundamentally transformed father than formatted or padded in some way.

Specified by:

isTransforming in interface KeyFieldCodec

Returns:

true if the encoded values are fundamentally transformed father than formatted or padded in some way.

encode

public byte[] encode(Object value)

Description copied from interface: KeyFieldCodec

Returns the encoded bytes representation for the given object or literal value.

Specified by:

encode in interface KeyFieldCodec

Parameters:

value - the object or literal value

Returns:

the encoded bytes representation

checkEncodeOverflow

public boolean checkEncodeOverflow(byte[] keyValue)

Description copied from interface: KeyFieldCodec

Returns true if the given encoded value will overflow the underlying key field.

Specified by:

checkEncodeOverflow in interface KeyFieldCodec

Returns:

true if the given encoded value will overflow the underlying key field.

encodeNext

public byte[] encodeNext(Object value)

Description copied from interface: KeyFieldCodec

Returns the encoded "next" bytes representation for the given object or literal value, where the next value depends on the coded implementation and may typically be the lexicographic next value.

Specified by:

encodeNext in interface KeyFieldCodec

Parameters:

value - the object or literal value

Returns:

the encoded bytes representation

decode

public Object decode(byte[] value)

Description copied from interface: KeyFieldCodec

Returns the object representation for the given encoded bytes value.

Specified by:

decode in interface KeyFieldCodec

Parameters:

value - encoded bytes value

Returns:

the object representation for the given encoded bytes value

getDataFlavor

public org.plasma.sdo.DataFlavor getDataFlavor()