Package io.datarouter.bytes.blockfile.row

Class BlockfileRow

java.lang.Object

io.datarouter.bytes.blockfile.row.BlockfileRow

public class BlockfileRow
extends Object

A generic KeyValue, plus a version represented as bytes. Entries are compared by key+version. Empty fields: - A key is generally required for any useful workload. - The version can be an empty byte[] if keys are unique. - The value can be an empty byte[] if all information is contained in the key. The bytes are interpreted lexicographically using Arrays::compareUnsigned. Many of these can be written to an OutputStream to be persisted for backup or further processing. Encodes KvFileEntry objects to bytes using the format: - varInt: total length of the all following fields - the total length is redundant, but can help split the InputStream faster for passing decoding to other threads - it can also help identify corruption, if the lengths don't add up - varInt: keyLength - bytes: key - varInt: versionLength - bytes: version - byte: opType - varInt: valueLength - bytes: value

Constructor Summary

Constructors

Constructor	Description
BlockfileRow(byte[] bytes, int offset, int length, int keyOffset, int keyLength, int versionOffset, int versionLength, BlockfileRowOp op, int valueOffset, int valueLength)

Method Summary

Modifier and Type	Method	Description
byte[]	backingBytes()
static int	compareKey(BlockfileRow left, BlockfileRow right)
static int	compareKeyVersionOpOptimized(BlockfileRow left, BlockfileRow right)
int	compareToKey(byte[] otherKey)
static int	compareVersion(BlockfileRow left, BlockfileRow right)
byte[]	copyOfBytes()
byte[]	copyOfKey()
byte[]	copyOfValue()
byte[]	copyOfVersion()
static BlockfileRow	create(byte[] key, byte[] version, BlockfileRowOp op, byte[] value)
static BlockfileRow	delete(byte[] key, byte[] version)
boolean	equals(Object obj)
boolean	equalsKey(byte[] otherKey)
static boolean	equalsKeyOptimized(BlockfileRow left, BlockfileRow right)
static boolean	equalsVersion(BlockfileRow left, BlockfileRow right)
int	hashCode()
int	keyLength()
int	keyOffset()
int	length()
int	offset()
BlockfileRowOp	op()
static BlockfileRow	putWithLongVersion(byte[] key, long version, byte[] value)
static BlockfileRow	putWithoutVersion(byte[] key, byte[] value)
BlockfileRowVersion	toRowVersion()
String	toString()
static int	totalLength(List<BlockfileRow> rows)
int	valueLength()
int	valueOffset()
int	versionLength()
int	versionOffset()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

BlockfileRow

public BlockfileRow(byte[] bytes,
 int offset,
 int length,
 int keyOffset,
 int keyLength,
 int versionOffset,
 int versionLength,
 BlockfileRowOp op,
 int valueOffset,
 int valueLength)

Method Details

create

public static BlockfileRow create(byte[] key,
 byte[] version,
 BlockfileRowOp op,
 byte[] value)

delete

public static BlockfileRow delete(byte[] key,
 byte[] version)

putWithoutVersion

public static BlockfileRow putWithoutVersion(byte[] key,
 byte[] value)

putWithLongVersion

public static BlockfileRow putWithLongVersion(byte[] key,
 long version,
 byte[] value)

equalsKey

public boolean equalsKey(byte[] otherKey)

equalsKeyOptimized

public static boolean equalsKeyOptimized(BlockfileRow left,
 BlockfileRow right)

equalsVersion

public static boolean equalsVersion(BlockfileRow left,
 BlockfileRow right)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

compareToKey

public int compareToKey(byte[] otherKey)

compareKey

public static int compareKey(BlockfileRow left,
 BlockfileRow right)

compareVersion

public static int compareVersion(BlockfileRow left,
 BlockfileRow right)

compareKeyVersionOpOptimized

public static int compareKeyVersionOpOptimized(BlockfileRow left,
 BlockfileRow right)

toRowVersion

public BlockfileRowVersion toRowVersion()

totalLength

public static int totalLength(List<BlockfileRow> rows)

backingBytes

public byte[] backingBytes()

copyOfBytes

public byte[] copyOfBytes()

offset

public int offset()

length

public int length()

keyOffset

public int keyOffset()

keyLength

public int keyLength()

copyOfKey

public byte[] copyOfKey()

versionOffset

public int versionOffset()

versionLength

public int versionLength()

copyOfVersion

public byte[] copyOfVersion()

op

public BlockfileRowOp op()

valueOffset

public int valueOffset()

valueLength

public int valueLength()

copyOfValue

public byte[] copyOfValue()