@InterfaceAudience.Private @InterfaceStability.Evolving public abstract class AbstractByteRange extends Object implements ByteRange
Modifier and Type | Field and Description |
---|---|
protected byte[] |
bytes
The array containing the bytes in this range.
|
protected int |
hash
Variable for lazy-caching the hashCode of this range.
|
protected int |
length
The number of bytes in the range.
|
protected int |
offset
The index of the first byte in this range.
|
static int |
UNSET_HASH_VALUE |
Constructor and Description |
---|
AbstractByteRange() |
Modifier and Type | Method and Description |
---|---|
protected void |
clearHashCache() |
int |
compareTo(ByteRange other)
Bitwise comparison of each byte in the array.
|
void |
deepCopySubRangeTo(int innerOffset,
int copyLength,
byte[] destination,
int destinationOffset)
Wrapper for System.arraycopy.
|
void |
deepCopyTo(byte[] destination,
int destinationOffset)
Wrapper for System.arraycopy.
|
byte[] |
deepCopyToNewArray()
Instantiate a new byte[] with exact length, which is at least 24 bytes + length.
|
boolean |
equals(Object obj) |
byte |
get(int index)
Retrieve the byte at
index . |
ByteRange |
get(int index,
byte[] dst)
Fill
dst with bytes from the range, starting from index . |
ByteRange |
get(int index,
byte[] dst,
int offset,
int length)
Fill
dst with bytes from the range, starting from index . |
byte[] |
getBytes()
The underlying byte[].
|
int |
getInt(int index)
Retrieve the int value at
index |
int |
getLength()
The length of the range.
|
long |
getLong(int index)
Retrieve the long value at
index |
int |
getOffset()
The offset, the index into the underlying byte[] at which this range begins.
|
short |
getShort(int index)
Retrieve the short value at
index |
long |
getVLong(int index)
Retrieve the long value at
index which is stored as VLong |
static int |
getVLongSize(long val) |
int |
hashCode() |
boolean |
isEmpty()
Returns true when this range is of zero length, false otherwise.
|
static boolean |
isEmpty(ByteRange range)
Returns true when
range is of zero length, false otherwise. |
protected boolean |
isHashCached() |
ByteRange |
set(byte[] bytes)
Reuse this
ByteRange over a new byte[]. |
ByteRange |
set(byte[] bytes,
int offset,
int length)
Reuse this
ByteRange over a new byte[]. |
ByteRange |
set(int capacity)
Reuse this
ByteRange over a new byte[]. |
ByteRange |
setLength(int length)
Update the length of this range.
|
ByteRange |
setOffset(int offset)
Update the beginning of this range.
|
String |
toString() |
public static final int UNSET_HASH_VALUE
protected byte[] bytes
protected int offset
ByteRange.get(0)
will return bytes[offset].protected int length
protected int hash
public AbstractByteRange()
public byte[] getBytes()
ByteRange
public ByteRange set(int capacity)
ByteRange
ByteRange
over a new byte[]. offset
is set to 0 and length
is set to capacity
.public ByteRange 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()
.public ByteRange 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
.public int getOffset()
ByteRange
getOffset
in interface ByteRange
ByteRange.getBytes()
public ByteRange setOffset(int offset)
ByteRange
offset + length
may not be greater than
bytes.length
.public int getLength()
ByteRange
public ByteRange setLength(int length)
ByteRange
offset + length
should not be greater than
bytes.length
.public boolean isEmpty()
ByteRange
public static boolean isEmpty(ByteRange range)
range
is of zero length, false otherwise.public byte get(int index)
ByteRange
index
.public ByteRange get(int index, byte[] dst)
ByteRange
dst
with bytes from the range, starting from index
.public ByteRange 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
.public short getShort(int index)
ByteRange
index
public int getInt(int index)
ByteRange
index
public long getLong(int index)
ByteRange
index
public long getVLong(int index)
ByteRange
index
which is stored as VLongpublic static int getVLongSize(long val)
public byte[] deepCopyToNewArray()
ByteRange
deepCopyToNewArray
in interface ByteRange
public void deepCopyTo(byte[] destination, int destinationOffset)
ByteRange
deepCopyTo
in interface ByteRange
destination
- Copy to this arraydestinationOffset
- First index in the destination array.public void deepCopySubRangeTo(int innerOffset, int copyLength, byte[] destination, int destinationOffset)
ByteRange
deepCopySubRangeTo
in interface ByteRange
innerOffset
- Start copying from this index in this source ByteRange. First byte
copied is bytes[offset + innerOffset]copyLength
- Copy this many bytesdestination
- Copy to this arraydestinationOffset
- First index in the destination array.protected boolean isHashCached()
protected void clearHashCache()
public int compareTo(ByteRange other)
compareTo
in interface Comparable<ByteRange>
Copyright © 2007–2020 The Apache Software Foundation. All rights reserved.