org.apache.hadoop.hbase.util

Class SimplePositionedByteRange

java.lang.Object

org.apache.hadoop.hbase.util.AbstractByteRange

org.apache.hadoop.hbase.util.AbstractPositionedByteRange

org.apache.hadoop.hbase.util.SimplePositionedByteRange

All Implemented Interfaces:

Comparable<ByteRange>, ByteRange, PositionedByteRange

@InterfaceAudience.Public
public class SimplePositionedByteRange
extends org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Extends the basic SimpleMutableByteRange implementation with position support and it is a readonly version. position is considered transient, not fundamental to the definition of the range, and does not participate in AbstractByteRange.compareTo(ByteRange), AbstractByteRange.hashCode(), or AbstractByteRange.equals(Object). Position is retained by copy operations.

Field Summary

Fields inherited from class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

limit, position

Fields inherited from class org.apache.hadoop.hbase.util.AbstractByteRange

bytes, hash, length, offset, UNSET_HASH_VALUE

Constructor Summary

Constructors

Constructor and Description
SimplePositionedByteRange() Create a new PositionedByteRange lacking a backing array and with an undefined viewport.
SimplePositionedByteRange(byte[] bytes) Create a new PositionedByteRange over the provided bytes.
SimplePositionedByteRange(byte[] bytes, int offset, int length) Create a new PositionedByteRange over the provided bytes.
SimplePositionedByteRange(int capacity) Create a new PositionedByteRange over a new backing array of size capacity.

Method Summary

Modifier and Type	Method and Description
PositionedByteRange	deepCopy() Create a new ByteRange with new backing byte[] containing a copy of the content from this range's window.
PositionedByteRange	get(int index, byte[] dst) Fill dst with bytes from the range, starting from index.
PositionedByteRange	get(int index, byte[] dst, int offset, int length) Fill dst with bytes from the range, starting from index.
PositionedByteRange	put(byte val) Store val at the next position in this range.
PositionedByteRange	put(byte[] val) Store the content of val in this range, starting at the next position.
PositionedByteRange	put(byte[] val, int offset, int length) Store length bytes from val into this range.
PositionedByteRange	put(int index, byte val) Store val at index.
PositionedByteRange	put(int index, byte[] val) Store val at index.
PositionedByteRange	put(int index, byte[] val, int offset, int length) Store length bytes from val into this range, starting at index.
PositionedByteRange	putInt(int val) Store int val at the next position in this range.
PositionedByteRange	putInt(int index, int val) Store the int value at index
PositionedByteRange	putLong(int index, long val) Store the long value at index
PositionedByteRange	putLong(long val) Store long val at the next position in this range.
PositionedByteRange	putShort(int index, short val) Store the short value at index
PositionedByteRange	putShort(short val) Store short val at the next position in this range.
int	putVLong(int index, long val) Store the long value at index as a VLong
int	putVLong(long val) Store the long val at the next position as a VLong
PositionedByteRange	set(byte[] bytes) Reuse this ByteRange over a new byte[].
PositionedByteRange	set(byte[] bytes, int offset, int length) Reuse this ByteRange over a new byte[].
PositionedByteRange	set(int capacity) Reuse this ByteRange over a new byte[].
PositionedByteRange	setLimit(int limit) Limits the byte range upto a specified value.
PositionedByteRange	shallowCopy() Create a new ByteRange that points at this range's byte[].
PositionedByteRange	shallowCopySubRange(int innerOffset, int copyLength) Create a new ByteRange that points at this range's byte[].
PositionedByteRange	unset() Nullifies this ByteRange.

Methods inherited from class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

get, get, get, getInt, getLimit, getLong, getPosition, getRemaining, getShort, getVLong, peek, setLength, setOffset, setPosition

Methods inherited from class org.apache.hadoop.hbase.util.AbstractByteRange

clearHashCache, compareTo, deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, equals, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, getVLongSize, hashCode, isEmpty, isEmpty, isHashCached, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.hadoop.hbase.util.ByteRange

deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, isEmpty

Methods inherited from interface java.lang.Comparable

compareTo

Constructor Detail

SimplePositionedByteRange

public SimplePositionedByteRange()

Create a new PositionedByteRange lacking a backing array and with an undefined viewport.

SimplePositionedByteRange

public SimplePositionedByteRange(int capacity)

Create a new PositionedByteRange over a new backing array of size capacity. The range's offset and length are 0 and capacity, respectively.

Parameters:

capacity - the size of the backing array.

SimplePositionedByteRange

public SimplePositionedByteRange(byte[] bytes)

Create a new PositionedByteRange over the provided bytes.

Parameters:

bytes - The array to wrap.

SimplePositionedByteRange

public SimplePositionedByteRange(byte[] bytes,
                                 int offset,
                                 int length)

Create a new PositionedByteRange over the provided bytes.

Parameters:

bytes - The array to wrap.

offset - The offset into bytes considered the beginning of this range.

length - The length of this range.

Method Detail

set

public PositionedByteRange set(int capacity)

Description copied from interface: ByteRange

Reuse this ByteRange over a new byte[]. offset is set to 0 and length is set to capacity.

Specified by:

set in interface ByteRange

Specified by:

set in interface PositionedByteRange

Overrides:

set in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Parameters:

capacity - the size of a new byte[]. n

set

public PositionedByteRange set(byte[] bytes)

Description copied from interface: ByteRange

Reuse this ByteRange over a new byte[]. offset is set to 0 and length is set to bytes.length. A null bytes IS supported, in which case this method will behave equivalently to ByteRange.unset().

Specified by:

set in interface ByteRange

Specified by:

set in interface PositionedByteRange

Overrides:

set in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Parameters:

bytes - the array to wrap. n

set

public PositionedByteRange set(byte[] bytes,
                               int offset,
                               int length)

Description copied from interface: ByteRange

Reuse this ByteRange over a new byte[]. A null bytes IS supported, in which case this method will behave equivalently to ByteRange.unset(), regardless of the values of offset and length.

Specified by:

set in interface ByteRange

Specified by:

set in interface PositionedByteRange

Overrides:

set in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Parameters:

bytes - The array to wrap.

offset - The offset into bytes considered the beginning of this range.

length - The length of this range.

Returns:

this.

put

public PositionedByteRange put(byte val)

Description copied from interface: PositionedByteRange

Store val at the next position in this range.

Parameters:

val - the new value.

Returns:

this.

putShort

public PositionedByteRange putShort(short val)

Description copied from interface: PositionedByteRange

Store short val at the next position in this range.

Parameters:

val - the new value.

Returns:

this.

putInt

public PositionedByteRange putInt(int val)

Description copied from interface: PositionedByteRange

Store int val at the next position in this range.

Parameters:

val - the new value.

Returns:

this.

putLong

public PositionedByteRange putLong(long val)

Description copied from interface: PositionedByteRange

Store long val at the next position in this range.

Parameters:

val - the new value.

Returns:

this.

putVLong

public int putVLong(long val)

Description copied from interface: PositionedByteRange

Store the long val at the next position as a VLong

Parameters:

val - the value to store

Returns:

number of bytes written

put

public PositionedByteRange put(byte[] val)

Description copied from interface: PositionedByteRange

Store the content of val in this range, starting at the next position.

Parameters:

val - the new value.

Returns:

this.

put

public PositionedByteRange put(byte[] val,
                               int offset,
                               int length)

Description copied from interface: PositionedByteRange

Store length bytes from val into this range. Bytes from val are copied starting at offset into the range, starting at the current position.

Parameters:

val - the new value.

offset - the offset in val from which to start copying.

length - the number of bytes to copy from val.

Returns:

this.

get

public PositionedByteRange get(int index,
                               byte[] dst)

Description copied from interface: ByteRange

Fill dst with bytes from the range, starting from index.

Specified by:

get in interface ByteRange

Specified by:

get in interface PositionedByteRange

Overrides:

get in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Parameters:

index - zero-based index into this range.

dst - the destination of the copy.

Returns:

this.

get

public PositionedByteRange get(int index,
                               byte[] dst,
                               int offset,
                               int length)

Description copied from interface: ByteRange

Fill dst with bytes from the range, starting from index. length bytes are copied into dst, starting at offset.

Specified by:

get in interface ByteRange

Specified by:

get in interface PositionedByteRange

Overrides:

get in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

Parameters:

index - zero-based index into this range.

dst - the destination of the copy.

offset - the offset into dst to start the copy.

length - the number of bytes to copy into dst.

Returns:

this.

put

public PositionedByteRange put(int index,
                               byte val)

Description copied from interface: ByteRange

Store val at index.

Parameters:

index - the index in the range where val is stored.

val - the value to store.

Returns:

this.

putShort

public PositionedByteRange putShort(int index,
                                    short val)

Description copied from interface: ByteRange

Store the short value at index

Parameters:

index - the index in the range where val is stored

val - the value to store n

putInt

public PositionedByteRange putInt(int index,
                                  int val)

Description copied from interface: ByteRange

Store the int value at index

Parameters:

index - the index in the range where val is stored

val - the value to store n

putVLong

public int putVLong(int index,
                    long val)

Description copied from interface: ByteRange

Store the long value at index as a VLong

Parameters:

index - the index in the range where val is stored

val - the value to store

Returns:

number of bytes written

putLong

public PositionedByteRange putLong(int index,
                                   long val)

Description copied from interface: ByteRange

Store the long value at index

Parameters:

index - the index in the range where val is stored

val - the value to store n

put

public PositionedByteRange put(int index,
                               byte[] val)

Description copied from interface: ByteRange

Store val at index.

Parameters:

index - the index in the range where val is stored.

val - the value to store.

Returns:

this.

put

public PositionedByteRange put(int index,
                               byte[] val,
                               int offset,
                               int length)

Description copied from interface: ByteRange

Store length bytes from val into this range, starting at index. Bytes from val are copied starting at offset into the range.

Parameters:

index - position in this range to start the copy.

val - the value to store.

offset - the offset in val from which to start copying.

length - the number of bytes to copy from val.

Returns:

this.

deepCopy

public PositionedByteRange deepCopy()

Description copied from interface: ByteRange

Create a new ByteRange with new backing byte[] containing a copy of the content from this range's window.

Returns:

Deep copy

shallowCopy

public PositionedByteRange shallowCopy()

Description copied from interface: ByteRange

Create a new ByteRange that points at this range's byte[]. Modifying the shallowCopy will modify the bytes in this range's array. Pass over the hash code if it is already cached.

Returns:

new ByteRange object referencing this range's byte[].

shallowCopySubRange

public PositionedByteRange shallowCopySubRange(int innerOffset,
                                               int copyLength)

Description copied from interface: ByteRange

Create a new ByteRange that points at this range's byte[]. The new range can have different values for offset and length, but modifying the shallowCopy will modify the bytes in this range's array. Pass over the hash code if it is already cached.

Parameters:

innerOffset - First byte of clone will be this.offset + copyOffset.

copyLength - Number of bytes in the clone.

Returns:

new ByteRange object referencing this range's byte[].

setLimit

public PositionedByteRange setLimit(int limit)

Description copied from interface: PositionedByteRange

Limits the byte range upto a specified value. Limit cannot be greater than capacity nn

Specified by:

setLimit in interface PositionedByteRange

Overrides:

setLimit in class org.apache.hadoop.hbase.util.AbstractPositionedByteRange

unset

public PositionedByteRange unset()

Description copied from interface: ByteRange

Nullifies this ByteRange. That is, it becomes a husk, being a range over no byte[] whatsoever. n