@InterfaceAudience.Private @InterfaceStability.Evolving public abstract class AbstractPositionedByteRange extends AbstractByteRange implements PositionedByteRange
SimpleByteRange
implementation with position
support. 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.限定符和类型 | 字段和说明 |
---|---|
protected int |
limit |
protected int |
position
The current index into the range.
|
bytes, hash, length, offset, UNSET_HASH_VALUE
构造器和说明 |
---|
AbstractPositionedByteRange() |
限定符和类型 | 方法和说明 |
---|---|
abstract 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.
|
abstract PositionedByteRange |
put(byte val)
Store
val at the next position in this range. |
abstract PositionedByteRange |
put(byte[] val)
Store the content of
val in this range, starting at the next position. |
abstract PositionedByteRange |
put(byte[] val,
int offset,
int length)
Store
length bytes from val into this range. |
abstract PositionedByteRange |
put(int index,
byte val)
Store
val at index . |
abstract PositionedByteRange |
put(int index,
byte[] val)
Store
val at index . |
abstract PositionedByteRange |
put(int index,
byte[] val,
int offset,
int length)
Store
length bytes from val into this range, starting at
index . |
abstract PositionedByteRange |
putInt(int val)
Store int
val at the next position in this range. |
abstract PositionedByteRange |
putInt(int index,
int val)
Store the int value at
index |
abstract PositionedByteRange |
putLong(int index,
long val)
Store the long value at
index |
abstract PositionedByteRange |
putLong(long val)
Store long
val at the next position in this range. |
abstract PositionedByteRange |
putShort(int index,
short val)
Store the short value at
index |
abstract PositionedByteRange |
putShort(short val)
Store short
val at the next position in this range. |
abstract int |
putVLong(int index,
long val)
Store the long value at
index as a VLong |
abstract 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. |
abstract PositionedByteRange |
shallowCopy()
Create a new
ByteRange that points at this range's byte[]. |
abstract PositionedByteRange |
shallowCopySubRange(int innerOffset,
int copyLength)
Create a new
ByteRange that points at this range's byte[]. |
abstract PositionedByteRange |
unset()
Nullifies this ByteRange.
|
clearHashCache, compareTo, deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, equals, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, getVLongSize, hashCode, isEmpty, isEmpty, isHashCached, toString
deepCopySubRangeTo, deepCopyTo, deepCopyToNewArray, get, getBytes, getInt, getLength, getLong, getOffset, getShort, getVLong, isEmpty
compareTo
protected int position
ByteBuffer
position, it
points to the next value that will be read/written in the array. It
provides the appearance of being 0-indexed, even though its value is
calculated according to offset.
Position is considered transient and does not participate in
AbstractByteRange.equals(Object)
or AbstractByteRange.hashCode()
comparisons.
protected int limit
public abstract PositionedByteRange unset()
ByteRange
unset
在接口中 ByteRange
unset
在接口中 PositionedByteRange
unset
在类中 AbstractByteRange
public PositionedByteRange set(int capacity)
ByteRange
ByteRange
over a new byte[]. offset
is set to
0 and length
is set to capacity
.set
在接口中 ByteRange
set
在接口中 PositionedByteRange
set
在类中 AbstractByteRange
capacity
- the size of a new byte[].public PositionedByteRange set(byte[] bytes)
ByteRange
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
set
在接口中 PositionedByteRange
set
在类中 AbstractByteRange
bytes
- the array to wrap.public PositionedByteRange set(byte[] bytes, int offset, int length)
ByteRange
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
set
在接口中 PositionedByteRange
set
在类中 AbstractByteRange
bytes
- The array to wrap.offset
- The offset into bytes
considered the beginning of
this range.length
- The length of this range.public PositionedByteRange setOffset(int offset)
offset + length
may not be
greater than bytes.length
. Resets position
to 0.setOffset
在接口中 ByteRange
setOffset
在接口中 PositionedByteRange
setOffset
在类中 AbstractByteRange
offset
- the new start of this range.public PositionedByteRange setLength(int length)
offset + length
should not be
greater than bytes.length
. If position
is greater than the
new length
, sets position
to length
.setLength
在接口中 ByteRange
setLength
在接口中 PositionedByteRange
setLength
在类中 AbstractByteRange
length
- The new length of this range.public int getPosition()
PositionedByteRange
position
marker. This valuae is 0-indexed, relative to
the beginning of the range.getPosition
在接口中 PositionedByteRange
public PositionedByteRange setPosition(int position)
PositionedByteRange
position
index. May not be greater than length
.setPosition
在接口中 PositionedByteRange
position
- the new position in this range.public int getRemaining()
PositionedByteRange
getRemaining
在接口中 PositionedByteRange
public byte peek()
PositionedByteRange
peek
在接口中 PositionedByteRange
public byte get()
PositionedByteRange
get
在接口中 PositionedByteRange
public PositionedByteRange get(byte[] dst)
PositionedByteRange
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.get
在接口中 PositionedByteRange
dst
- the destination of the copy.public PositionedByteRange get(byte[] dst, int offset, int length)
PositionedByteRange
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.get
在接口中 PositionedByteRange
dst
- the destination of the copy.offset
- the offset into dst
to start the copy.length
- the number of bytes to copy into dst
.public abstract PositionedByteRange put(byte val)
PositionedByteRange
val
at the next position in this range.put
在接口中 PositionedByteRange
val
- the new value.public abstract PositionedByteRange put(byte[] val)
PositionedByteRange
val
in this range, starting at the next position.put
在接口中 PositionedByteRange
val
- the new value.public abstract PositionedByteRange put(byte[] val, int offset, int length)
PositionedByteRange
length
bytes from val
into this range. Bytes from
val
are copied starting at offset
into the range, starting at
the current position.put
在接口中 PositionedByteRange
val
- the new value.offset
- the offset in val
from which to start copying.length
- the number of bytes to copy from val
.public abstract PositionedByteRange putInt(int index, int val)
ByteRange
index
putInt
在接口中 ByteRange
putInt
在接口中 PositionedByteRange
putInt
在类中 AbstractByteRange
index
- the index in the range where val
is storedval
- the value to storepublic abstract PositionedByteRange putLong(int index, long val)
ByteRange
index
putLong
在接口中 ByteRange
putLong
在接口中 PositionedByteRange
putLong
在类中 AbstractByteRange
index
- the index in the range where val
is storedval
- the value to storepublic abstract PositionedByteRange putShort(int index, short val)
ByteRange
index
putShort
在接口中 ByteRange
putShort
在接口中 PositionedByteRange
putShort
在类中 AbstractByteRange
index
- the index in the range where val
is storedval
- the value to storepublic abstract PositionedByteRange putInt(int val)
PositionedByteRange
val
at the next position in this range.putInt
在接口中 PositionedByteRange
val
- the new value.public abstract PositionedByteRange putLong(long val)
PositionedByteRange
val
at the next position in this range.putLong
在接口中 PositionedByteRange
val
- the new value.public abstract PositionedByteRange putShort(short val)
PositionedByteRange
val
at the next position in this range.putShort
在接口中 PositionedByteRange
val
- the new value.public abstract int putVLong(int index, long val)
ByteRange
index
as a VLongputVLong
在接口中 ByteRange
putVLong
在类中 AbstractByteRange
index
- the index in the range where val
is storedval
- the value to storepublic abstract int putVLong(long val)
PositionedByteRange
val
at the next position as a VLongputVLong
在接口中 PositionedByteRange
val
- the value to storepublic PositionedByteRange get(int index, byte[] dst)
ByteRange
dst
with bytes from the range, starting from index
.get
在接口中 ByteRange
get
在接口中 PositionedByteRange
get
在类中 AbstractByteRange
index
- zero-based index into this range.dst
- the destination of the copy.public PositionedByteRange get(int index, byte[] dst, int offset, int length)
ByteRange
dst
with bytes from the range, starting from index
.
length
bytes are copied into dst
, starting at offset
.get
在接口中 ByteRange
get
在接口中 PositionedByteRange
get
在类中 AbstractByteRange
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
.public short getShort()
PositionedByteRange
getShort
在接口中 PositionedByteRange
public int getInt()
PositionedByteRange
getInt
在接口中 PositionedByteRange
public long getLong()
PositionedByteRange
getLong
在接口中 PositionedByteRange
public long getVLong()
PositionedByteRange
getVLong
在接口中 PositionedByteRange
public abstract PositionedByteRange put(int index, byte val)
ByteRange
val
at index
.put
在接口中 ByteRange
put
在接口中 PositionedByteRange
put
在类中 AbstractByteRange
index
- the index in the range where val
is stored.val
- the value to store.public abstract PositionedByteRange put(int index, byte[] val)
ByteRange
val
at index
.put
在接口中 ByteRange
put
在接口中 PositionedByteRange
put
在类中 AbstractByteRange
index
- the index in the range where val
is stored.val
- the value to store.public abstract PositionedByteRange put(int index, byte[] val, int offset, int length)
ByteRange
length
bytes from val
into this range, starting at
index
. Bytes from val
are copied starting at offset
into the range.put
在接口中 ByteRange
put
在接口中 PositionedByteRange
put
在类中 AbstractByteRange
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
.public abstract PositionedByteRange deepCopy()
ByteRange
ByteRange
with new backing byte[] containing a copy
of the content from this
range's window.deepCopy
在接口中 ByteRange
deepCopy
在接口中 PositionedByteRange
public abstract PositionedByteRange shallowCopy()
ByteRange
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
shallowCopy
在接口中 PositionedByteRange
ByteRange
object referencing this range's byte[].public abstract PositionedByteRange shallowCopySubRange(int innerOffset, int copyLength)
ByteRange
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
shallowCopySubRange
在接口中 PositionedByteRange
innerOffset
- First byte of clone will be this.offset + copyOffset.copyLength
- Number of bytes in the clone.ByteRange
object referencing this range's byte[].public PositionedByteRange setLimit(int limit)
PositionedByteRange
setLimit
在接口中 PositionedByteRange
public int getLimit()
PositionedByteRange
getLimit
在接口中 PositionedByteRange
Copyright © 2007–2021 The Apache Software Foundation. All rights reserved.