org.apache.hadoop.hbase.util

接口 PositionedByteRange

所有超级接口:

ByteRange, Comparable<ByteRange>

所有已知实现类:

AbstractPositionedByteRange, SimplePositionedByteRange, SimplePositionedMutableByteRange

@InterfaceAudience.Public
@InterfaceStability.Evolving
public interface PositionedByteRange
extends ByteRange

Extends ByteRange with additional methods to support tracking a consumers position within the viewport. The API is extended with methods get() and put(byte) for interacting with the backing array from the current position forward. This frees the caller from managing their own index into the array.

Designed to be a slimmed-down, mutable alternative to ByteBuffer.

方法概要

方法

限定符和类型	方法和说明
PositionedByteRange	deepCopy() Create a new ByteRange with new backing byte[] containing a copy of the content from this range's window.
byte	get() Retrieve the next byte from this range.
PositionedByteRange	get(byte[] dst) Fill dst with bytes from the range, starting from position.
PositionedByteRange	get(byte[] dst, int offset, int length) Fill dst with bytes from the range, starting from the current position.
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.
int	getInt() Retrieve the next int value from this range.
int	getLimit() Return the current limit
long	getLong() Retrieve the next long value from this range.
int	getPosition() The current position marker.
int	getRemaining() The number of bytes remaining between position and the end of the range.
short	getShort() Retrieve the next short value from this range.
long	getVLong() Retrieve the next long value, which is stored as VLong, from this range
byte	peek() Retrieve the next byte from this range without incrementing position.
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(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	setLength(int length) Update the length of this range.
PositionedByteRange	setLimit(int limit) Limits the byte range upto a specified value.
PositionedByteRange	setOffset(int offset) Update the beginning of this range.
PositionedByteRange	setPosition(int position) Update the position index.
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.

从接口继承的方法 org.apache.hadoop.hbase.util.ByteRange

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

从接口继承的方法 java.lang.Comparable

compareTo

方法详细资料

getPosition

int getPosition()

The current position marker. This valuae is 0-indexed, relative to the beginning of the range.

setPosition

PositionedByteRange setPosition(int position)

Update the position index. May not be greater than length.

参数:

position - the new position in this range.

返回:

this.

getRemaining

int getRemaining()

The number of bytes remaining between position and the end of the range.

peek

byte peek()

Retrieve the next byte from this range without incrementing position.

get

byte get()

Retrieve the next byte from this range.

getShort

short getShort()

Retrieve the next short value from this range.

getInt

int getInt()

Retrieve the next int value from this range.

getLong

long getLong()

Retrieve the next long value from this range.

getVLong

long getVLong()

Retrieve the next long value, which is stored as VLong, from this range

返回:

the long value which is stored as VLong

get

PositionedByteRange get(byte[] dst)

Fill dst with bytes from the range, starting from position. This range's position is incremented by the length of dst, the number of bytes copied.

参数:

dst - the destination of the copy.

返回:

this.

get

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

Fill dst with bytes from the range, starting from the current position. length bytes are copied into dst, starting at offset. This range's position is incremented by the number of bytes copied.

参数:

dst - the destination of the copy.

offset - the offset into dst to start the copy.

length - the number of bytes to copy into dst.

返回:

this.

put

PositionedByteRange put(byte val)

Store val at the next position in this range.

参数:

val - the new value.

返回:

this.

putShort

PositionedByteRange putShort(short val)

Store short val at the next position in this range.

参数:

val - the new value.

返回:

this.

putInt

PositionedByteRange putInt(int val)

Store int val at the next position in this range.

参数:

val - the new value.

返回:

this.

putLong

PositionedByteRange putLong(long val)

Store long val at the next position in this range.

参数:

val - the new value.

返回:

this.

putVLong

int putVLong(long val)

Store the long val at the next position as a VLong

参数:

val - the value to store

返回:

number of bytes written

put

PositionedByteRange put(byte[] val)

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

参数:

val - the new value.

返回:

this.

put

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

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

参数:

val - the new value.

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

length - the number of bytes to copy from val.

返回:

this.

setLimit

PositionedByteRange setLimit(int limit)

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

参数:

limit -

返回:

PositionedByteRange

getLimit

int getLimit()

Return the current limit

返回:

limit

unset

PositionedByteRange unset()

从接口复制的说明: ByteRange

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

指定者:

unset 在接口中 ByteRange

返回:

this

set

PositionedByteRange set(int capacity)

从接口复制的说明: ByteRange

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

指定者:

set 在接口中 ByteRange

参数:

capacity - the size of a new byte[].

返回:

this

set

PositionedByteRange set(byte[] bytes)

从接口复制的说明: 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().

指定者:

set 在接口中 ByteRange

参数:

bytes - the array to wrap.

返回:

this

set

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

从接口复制的说明: 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.

指定者:

set 在接口中 ByteRange

参数:

bytes - The array to wrap.

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

length - The length of this range.

返回:

this.

setOffset

PositionedByteRange setOffset(int offset)

从接口复制的说明: ByteRange

Update the beginning of this range. offset + length may not be greater than bytes.length.

指定者:

setOffset 在接口中 ByteRange

参数:

offset - the new start of this range.

返回:

this.

setLength

PositionedByteRange setLength(int length)

从接口复制的说明: ByteRange

Update the length of this range. offset + length should not be greater than bytes.length.

指定者:

setLength 在接口中 ByteRange

参数:

length - The new length of this range.

返回:

this.

get

PositionedByteRange get(int index,
                      byte[] dst)

从接口复制的说明: ByteRange

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

指定者:

get 在接口中 ByteRange

参数:

index - zero-based index into this range.

dst - the destination of the copy.

返回:

this.

get

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

从接口复制的说明: ByteRange

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

指定者:

get 在接口中 ByteRange

参数:

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.

返回:

this.

put

PositionedByteRange put(int index,
                      byte val)

从接口复制的说明: ByteRange

Store val at index.

指定者:

put 在接口中 ByteRange

参数:

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

val - the value to store.

返回:

this.

putShort

PositionedByteRange putShort(int index,
                           short val)

从接口复制的说明: ByteRange

Store the short value at index

指定者:

putShort 在接口中 ByteRange

参数:

index - the index in the range where val is stored

val - the value to store

返回:

this

putInt

PositionedByteRange putInt(int index,
                         int val)

从接口复制的说明: ByteRange

Store the int value at index

指定者:

putInt 在接口中 ByteRange

参数:

index - the index in the range where val is stored

val - the value to store

返回:

this

putLong

PositionedByteRange putLong(int index,
                          long val)

从接口复制的说明: ByteRange

Store the long value at index

指定者:

putLong 在接口中 ByteRange

参数:

index - the index in the range where val is stored

val - the value to store

返回:

this

put

PositionedByteRange put(int index,
                      byte[] val)

从接口复制的说明: ByteRange

Store val at index.

指定者:

put 在接口中 ByteRange

参数:

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

val - the value to store.

返回:

this.

put

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

从接口复制的说明: ByteRange

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

指定者:

put 在接口中 ByteRange

参数:

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.

返回:

this.

deepCopy

PositionedByteRange deepCopy()

从接口复制的说明: ByteRange

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

指定者:

deepCopy 在接口中 ByteRange

返回:

Deep copy

shallowCopy

PositionedByteRange shallowCopy()

从接口复制的说明: 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.

指定者:

shallowCopy 在接口中 ByteRange

返回:

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

shallowCopySubRange

PositionedByteRange shallowCopySubRange(int innerOffset,
                                      int copyLength)

从接口复制的说明: 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.

指定者:

shallowCopySubRange 在接口中 ByteRange

参数:

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

copyLength - Number of bytes in the clone.

返回:

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