Package com.illumon.util.codec

Class LocalDateCodec

java.lang.Object

com.illumon.util.codec.LocalDateCodec

All Implemented Interfaces:

ObjectCodec<LocalDate>, ObjectDecoder<LocalDate>

public class LocalDateCodec
extends Object
implements ObjectCodec<LocalDate>

LocalDate codec, with support for "full" and "compact" encodings. The full (default) encoding is a 5-byte packed integer format that can represent the full range of dates that a LocalDate object can hold (years -999,999,999 to 999,999,999). The compact encoding is a 3-byte packed-integer. This format is constrained to represent dates in the range 0000-01-01 to 9999-01-01. This encoding covers the range supported by many SQL databases, so is often a good candidate for imported data sets. Both encodings are "nullable", indicated by setting the most significant byte to 0xFF (this can never represent a valid value in the ranges specified for each encoding).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LocalDateCodec.Domain

Field Summary

Fields inherited from interface com.illumon.util.codec.ObjectDecoder

VARIABLE_WIDTH_SENTINEL

Constructor Summary

Constructors

Constructor	Description
LocalDateCodec(String arguments)

Method Summary

Modifier and Type	Method	Description
LocalDate	decode(byte[] input, int offset, int length)	Decode an object from an array of bytes.
byte[]	encode(LocalDate input)	Encode the specified input as an array of bytes.
int	expectedObjectWidth()	What width byte array does this ObjectCodec expect to encode and decode?
int	getPrecision()	If applicable, the maximum encodable precision.
int	getScale()	If applicable, the maximum encodable scale.
boolean	isNullable()	Does this codec support encoding of null values?

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.illumon.util.codec.ObjectDecoder

checkWidth

Constructor Details

LocalDateCodec

public LocalDateCodec(@Nullable String arguments)

Method Details

isNullable

public boolean isNullable()

Description copied from interface: ObjectCodec

Does this codec support encoding of null values?

Specified by:

isNullable in interface ObjectCodec<LocalDate>

Returns:

if null values are supported

getPrecision

public int getPrecision()

Description copied from interface: ObjectCodec

If applicable, the maximum encodable precision. If precision is not applicable (i.e. for non-numeric types) this method should return zero.

Specified by:

getPrecision in interface ObjectCodec<LocalDate>

Returns:

the numeric precision supported by this codec

getScale

public int getScale()

Description copied from interface: ObjectCodec

If applicable, the maximum encodable scale. If scale is not applicable (i.e. for non-numeric types) this method should return zero.

Specified by:

getScale in interface ObjectCodec<LocalDate>

Returns:

the numeric scale (digits after the decimal point) supported by this codec

encode

@NotNull public byte[] encode(@Nullable LocalDate input)

Description copied from interface: ObjectCodec

Encode the specified input as an array of bytes. Note that it is up to the implementation how to encode null inputs. The use of a zero-length byte array (e.g. CollectionUtil.ZERO_LENGTH_BYTE_ARRAY) is strongly encouraged.

Specified by:

encode in interface ObjectCodec<LocalDate>

Parameters:

input - The input object, possibly null

Returns:

The output byte array

decode

@Nullable public LocalDate decode(@NotNull byte[] input, int offset, int length)

Description copied from interface: ObjectDecoder

Decode an object from an array of bytes.

Specified by:

decode in interface ObjectDecoder<LocalDate>

Parameters:

input - The input byte array containing bytes to decode

offset - The offset into the byte array to start decoding from

length - The length of the byte array to decode from, starting at the offset

Returns:

The output object, possibly null

expectedObjectWidth

public int expectedObjectWidth()

Description copied from interface: ObjectDecoder

What width byte array does this ObjectCodec expect to encode and decode?

Specified by:

expectedObjectWidth in interface ObjectDecoder<LocalDate>

Returns:

VARIABLE_WIDTH_SENTINEL if the codec must encode and decode variable width columns, otherwise the fixed size of byte array that must be decoded and encoded.