org.apache.hadoop.hbase.nio

类 MultiByteBuff

java.lang.Object

org.apache.hadoop.hbase.nio.ByteBuff

org.apache.hadoop.hbase.nio.MultiByteBuff

@InterfaceAudience.Private
public class MultiByteBuff
extends ByteBuff

Provides a unified view of all the underlying ByteBuffers and will look as if a bigger sequential buffer. This class provides similar APIs as in ByteBuffer to put/get int, short, long etc and doing operations like mark, reset, slice etc. This has to be used when data is split across multiple byte buffers and we don't want copy them to single buffer for reading from it.

构造器概要

构造器

构造器和说明
MultiByteBuff(ByteBuffer... items)

方法概要

限定符和类型	方法和说明
byte[]	array()
int	arrayOffset()
ByteBuffer	asSubByteBuffer(int length) Returns bytes from current position till length specified, as a single ByteBuffer.
void	asSubByteBuffer(int offset, int length, ObjectIntPair<ByteBuffer> pair) Returns bytes from given offset till length specified, as a single ByteBuffer.
int	capacity()
MultiByteBuff	duplicate() Returns an MBB which is a duplicate version of this MBB.
boolean	equals(Object obj)
byte	get() A relative method that returns byte at the current position.
void	get(byte[] dst) Copies the content from this MBB's current position to the byte array and fills it.
void	get(byte[] dst, int offset, int length) Copies the specified number of bytes from this MBB's current position to the byte[]'s offset.
void	get(ByteBuffer out, int sourceOffset, int length) Copies the content from an this MBB to a ByteBuffer
byte	get(int index) Fetches the byte at the given index.
void	get(int sourceOffset, byte[] dst, int offset, int length) Copies the specified number of bytes from this ByteBuff's given position to the byte[]'s offset.
byte	getByteAfterPosition(int offset) Fetches the byte at the given offset from current position.
ByteBuffer[]	getEnclosingByteBuffers()
int	getInt() Returns the int value at the current position.
int	getInt(int index) Fetches the int at the given index.
int	getIntAfterPosition(int offset) Fetches the int value at the given offset from current position.
long	getLong() Returns the long value at the current position.
long	getLong(int index) Fetches the long at the given index.
long	getLongAfterPosition(int offset) Fetches the long value at the given offset from current position.
short	getShort() Returns the short value at the current position.
short	getShort(int index) Fetches the short at the given index.
short	getShortAfterPosition(int offset) Fetches the short value at the given offset from current position.
boolean	hasArray()
int	hashCode()
boolean	hasRemaining() Returns true if there are elements between the current position and the limt
int	limit() Returns the limit of this MBB
MultiByteBuff	limit(int limit) Marks the limit of this MBB.
MultiByteBuff	mark() Marks the current position of the MBB
MultiByteBuff	moveBack(int length) Jumps back the current position of this MBB by specified length.
int	position()
MultiByteBuff	position(int position) Sets this MBB's position to the given value.
MultiByteBuff	put(byte b) Writes a byte to this MBB at the current position and increments the position
MultiByteBuff	put(byte[] src) Copies from the given byte[] to this MBB
MultiByteBuff	put(byte[] src, int offset, int length) Copies from the given byte[] to this MBB
MultiByteBuff	put(int index, byte b) Writes a byte to this MBB at the given index
MultiByteBuff	put(int offset, ByteBuff src, int srcOffset, int length) Copies from a src MBB to this MBB.
MultiByteBuff	putInt(int val) Writes an int to this MBB at its current position.
MultiByteBuff	putLong(long val) Writes a long to this MBB at its current position.
int	read(ReadableByteChannel channel) Reads bytes from the given channel into this ByteBuff
int	remaining() Returns the number of elements between the current position and the limit.
MultiByteBuff	reset() Similar to ByteBuffer.reset(), ensures that this MBB is reset back to last marked position.
MultiByteBuff	rewind() Rewinds this MBB and the position is set to 0
MultiByteBuff	skip(int length) Jumps the current position of this MBB by specified length.
MultiByteBuff	slice() Returns an MBB which is a sliced version of this MBB.
byte[]	toBytes(int offset, int length) Copy the content from this MBB to a byte[] based on the given offset and length

从类继承的方法 org.apache.hadoop.hbase.nio.ByteBuff

channelRead, compareTo, readCompressedInt, readLong, readVLong, toBytes, toString, toStringBinary, unsignedBinarySearch

从类继承的方法 java.lang.Object

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

构造器详细资料

MultiByteBuff

public MultiByteBuff(ByteBuffer... items)

方法详细资料

array

public byte[] array()

指定者:

array 在类中 ByteBuff

返回:

the byte[] if the underlying BB has single BB and hasArray true

抛出:

UnsupportedOperationException - MBB does not support array based operations

arrayOffset

public int arrayOffset()

指定者:

arrayOffset 在类中 ByteBuff

返回:

the arrayOffset of the byte[] incase of a single BB backed ByteBuff

抛出:

UnsupportedOperationException - MBB does not support array based operations

hasArray

public boolean hasArray()

指定者:

hasArray 在类中 ByteBuff

返回:

false. MBB does not support array based operations

capacity

public int capacity()

指定者:

capacity 在类中 ByteBuff

返回:

the total capacity of this MultiByteBuffer.

get

public byte get(int index)

Fetches the byte at the given index. Does not change position of the underlying ByteBuffers

指定者:

get 在类中 ByteBuff

参数:

index -

返回:

the byte at the given index

getByteAfterPosition

public byte getByteAfterPosition(int offset)

从类复制的说明: ByteBuff

Fetches the byte at the given offset from current position. Does not change position of the underlying ByteBuffers.

指定者:

getByteAfterPosition 在类中 ByteBuff

返回:

the byte value at the given index.

getInt

public int getInt(int index)

Fetches the int at the given index. Does not change position of the underlying ByteBuffers

指定者:

getInt 在类中 ByteBuff

参数:

index -

返回:

the int value at the given index

getIntAfterPosition

public int getIntAfterPosition(int offset)

从类复制的说明: ByteBuff

Fetches the int value at the given offset from current position. Does not change position of the underlying ByteBuffers.

指定者:

getIntAfterPosition 在类中 ByteBuff

返回:

the int value at the given index.

getShort

public short getShort(int index)

Fetches the short at the given index. Does not change position of the underlying ByteBuffers

指定者:

getShort 在类中 ByteBuff

参数:

index -

返回:

the short value at the given index

getShortAfterPosition

public short getShortAfterPosition(int offset)

从类复制的说明: ByteBuff

Fetches the short value at the given offset from current position. Does not change position of the underlying ByteBuffers.

指定者:

getShortAfterPosition 在类中 ByteBuff

返回:

the short value at the given index.

getLong

public long getLong(int index)

Fetches the long at the given index. Does not change position of the underlying ByteBuffers

指定者:

getLong 在类中 ByteBuff

参数:

index -

返回:

the long value at the given index

getLongAfterPosition

public long getLongAfterPosition(int offset)

从类复制的说明: ByteBuff

Fetches the long value at the given offset from current position. Does not change position of the underlying ByteBuffers.

指定者:

getLongAfterPosition 在类中 ByteBuff

返回:

the long value at the given index.

position

public int position()

指定者:

position 在类中 ByteBuff

返回:

this MBB's current position

position

public MultiByteBuff position(int position)

Sets this MBB's position to the given value.

指定者:

position 在类中 ByteBuff

参数:

position -

返回:

this object

rewind

public MultiByteBuff rewind()

Rewinds this MBB and the position is set to 0

指定者:

rewind 在类中 ByteBuff

返回:

this object

mark

public MultiByteBuff mark()

Marks the current position of the MBB

指定者:

mark 在类中 ByteBuff

返回:

this object

reset

public MultiByteBuff reset()

Similar to ByteBuffer.reset(), ensures that this MBB is reset back to last marked position.

指定者:

reset 在类中 ByteBuff

返回:

This MBB

remaining

public int remaining()

Returns the number of elements between the current position and the limit.

指定者:

remaining 在类中 ByteBuff

返回:

the remaining elements in this MBB

hasRemaining

public final boolean hasRemaining()

Returns true if there are elements between the current position and the limt

指定者:

hasRemaining 在类中 ByteBuff

返回:

true if there are elements, false otherwise

get

public byte get()

A relative method that returns byte at the current position. Increments the current position by the size of a byte.

指定者:

get 在类中 ByteBuff

返回:

the byte at the current position

getShort

public short getShort()

Returns the short value at the current position. Also advances the position by the size of short

指定者:

getShort 在类中 ByteBuff

返回:

the short value at the current position

getInt

public int getInt()

Returns the int value at the current position. Also advances the position by the size of int

指定者:

getInt 在类中 ByteBuff

返回:

the int value at the current position

getLong

public long getLong()

Returns the long value at the current position. Also advances the position by the size of long

指定者:

getLong 在类中 ByteBuff

返回:

the long value at the current position

get

public void get(byte[] dst)

Copies the content from this MBB's current position to the byte array and fills it. Also advances the position of the MBB by the length of the byte[].

指定者:

get 在类中 ByteBuff

参数:

dst -

get

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

Copies the specified number of bytes from this MBB's current position to the byte[]'s offset. Also advances the position of the MBB by the given length.

指定者:

get 在类中 ByteBuff

参数:

dst -

offset - within the current array

length - upto which the bytes to be copied

get

public void get(int sourceOffset,
                byte[] dst,
                int offset,
                int length)

从类复制的说明: ByteBuff

Copies the specified number of bytes from this ByteBuff's given position to the byte[]'s offset. The position of the ByteBuff remains in the current position only

指定者:

get 在类中 ByteBuff

参数:

sourceOffset - the offset in this ByteBuff from where the copy should happen

dst - the byte[] to which the ByteBuff's content is to be copied

offset - within the current array

length - upto which the bytes to be copied

limit

public MultiByteBuff limit(int limit)

Marks the limit of this MBB.

指定者:

limit 在类中 ByteBuff

参数:

limit -

返回:

This MBB

limit

public int limit()

Returns the limit of this MBB

指定者:

limit 在类中 ByteBuff

返回:

limit of the MBB

slice

public MultiByteBuff slice()

Returns an MBB which is a sliced version of this MBB. The position, limit and mark of the new MBB will be independent than that of the original MBB. The content of the new MBB will start at this MBB's current position

指定者:

slice 在类中 ByteBuff

返回:

a sliced MBB

duplicate

public MultiByteBuff duplicate()

Returns an MBB which is a duplicate version of this MBB. The position, limit and mark of the new MBB will be independent than that of the original MBB. The content of the new MBB will start at this MBB's current position The position, limit and mark of the new MBB would be identical to this MBB in terms of values.

指定者:

duplicate 在类中 ByteBuff

返回:

a sliced MBB

put

public MultiByteBuff put(byte b)

Writes a byte to this MBB at the current position and increments the position

指定者:

put 在类中 ByteBuff

参数:

b -

返回:

this object

put

public MultiByteBuff put(int index,
                         byte b)

Writes a byte to this MBB at the given index

指定者:

put 在类中 ByteBuff

参数:

index -

b -

返回:

this object

put

public MultiByteBuff put(int offset,
                         ByteBuff src,
                         int srcOffset,
                         int length)

Copies from a src MBB to this MBB.

指定者:

put 在类中 ByteBuff

参数:

offset - the position in this MBB to which the copy should happen

src - the src MBB

srcOffset - the offset in the src MBB from where the elements should be read

length - the length upto which the copy should happen

putInt

public MultiByteBuff putInt(int val)

Writes an int to this MBB at its current position. Also advances the position by size of int

指定者:

putInt 在类中 ByteBuff

参数:

val - Int value to write

返回:

this object

put

public final MultiByteBuff put(byte[] src)

Copies from the given byte[] to this MBB

指定者:

put 在类中 ByteBuff

参数:

src -

返回:

this MBB

put

public MultiByteBuff put(byte[] src,
                         int offset,
                         int length)

Copies from the given byte[] to this MBB

指定者:

put 在类中 ByteBuff

参数:

src -

offset - the position in the byte array from which the copy should be done

length - the length upto which the copy should happen

返回:

this MBB

putLong

public MultiByteBuff putLong(long val)

Writes a long to this MBB at its current position. Also advances the position by size of long

指定者:

putLong 在类中 ByteBuff

参数:

val - Long value to write

返回:

this object

skip

public MultiByteBuff skip(int length)

Jumps the current position of this MBB by specified length.

指定者:

skip 在类中 ByteBuff

参数:

length -

moveBack

public MultiByteBuff moveBack(int length)

Jumps back the current position of this MBB by specified length.

指定者:

moveBack 在类中 ByteBuff

参数:

length -

asSubByteBuffer

public ByteBuffer asSubByteBuffer(int length)

Returns bytes from current position till length specified, as a single ByteBuffer. When all these bytes happen to be in a single ByteBuffer, which this object wraps, that ByteBuffer item as such will be returned. So users are warned not to change the position or limit of this returned ByteBuffer. The position of the returned byte buffer is at the begin of the required bytes. When the required bytes happen to span across multiple ByteBuffers, this API will copy the bytes to a newly created ByteBuffer of required size and return that.

指定者:

asSubByteBuffer 在类中 ByteBuff

参数:

length - number of bytes required.

返回:

bytes from current position till length specified, as a single ByteButter.

asSubByteBuffer

public void asSubByteBuffer(int offset,
                            int length,
                            ObjectIntPair<ByteBuffer> pair)

Returns bytes from given offset till length specified, as a single ByteBuffer. When all these bytes happen to be in a single ByteBuffer, which this object wraps, that ByteBuffer item as such will be returned (with offset in this ByteBuffer where the bytes starts). So users are warned not to change the position or limit of this returned ByteBuffer. When the required bytes happen to span across multiple ByteBuffers, this API will copy the bytes to a newly created ByteBuffer of required size and return that.

指定者:

asSubByteBuffer 在类中 ByteBuff

参数:

offset - the offset in this MBB from where the subBuffer should be created

length - the length of the subBuffer

pair - a pair that will have the bytes from the current position till length specified, as a single ByteBuffer and offset in that Buffer where the bytes starts. The method would set the values on the pair that is passed in by the caller

get

public void get(ByteBuffer out,
                int sourceOffset,
                int length)

Copies the content from an this MBB to a ByteBuffer

指定者:

get 在类中 ByteBuff

参数:

out - the ByteBuffer to which the copy has to happen

sourceOffset - the offset in the MBB from which the elements has to be copied

length - the length in the MBB upto which the elements has to be copied

toBytes

public byte[] toBytes(int offset,
                      int length)

Copy the content from this MBB to a byte[] based on the given offset and length

指定者:

toBytes 在类中 ByteBuff

参数:

offset - the position from where the copy should start

length - the length upto which the copy has to be done

返回:

byte[] with the copied contents from this MBB.

read

public int read(ReadableByteChannel channel)
         throws IOException

从类复制的说明: ByteBuff

Reads bytes from the given channel into this ByteBuff

指定者:

read 在类中 ByteBuff

返回:

The number of bytes read from the channel

抛出:

IOException

equals

public boolean equals(Object obj)

覆盖:

equals 在类中 Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object

getEnclosingByteBuffers

public ByteBuffer[] getEnclosingByteBuffers()

返回:

the ByteBuffers which this wraps.