public class DefaultDataBuffer extends java.lang.Object implements DataBuffer
DataBuffer
interface that uses a
ByteBuffer
internally. with separate read and write positions.
Constructed using the DefaultDataBufferFactory
.
Inspired by Netty's ByteBuf
. Introduced so that non-Netty runtimes (i.e. Servlet)
do not require Netty on the classpath.
DefaultDataBufferFactory
Modifier and Type | Class and Description |
---|---|
private class |
DefaultDataBuffer.DefaultDataBufferInputStream |
private class |
DefaultDataBuffer.DefaultDataBufferOutputStream |
private static class |
DefaultDataBuffer.SlicedDefaultDataBuffer |
Modifier and Type | Field and Description |
---|---|
private java.nio.ByteBuffer |
byteBuffer |
private int |
capacity |
private static int |
CAPACITY_THRESHOLD |
private DefaultDataBufferFactory |
dataBufferFactory |
private static int |
MAX_CAPACITY |
private int |
readPosition |
private int |
writePosition |
Modifier | Constructor and Description |
---|---|
private |
DefaultDataBuffer(DefaultDataBufferFactory dataBufferFactory,
java.nio.ByteBuffer byteBuffer) |
Modifier and Type | Method and Description |
---|---|
private static java.nio.ByteBuffer |
allocate(int capacity,
boolean direct) |
java.nio.ByteBuffer |
asByteBuffer()
Expose this buffer's bytes as a
ByteBuffer . |
java.nio.ByteBuffer |
asByteBuffer(int index,
int length)
Expose a subsequence of this buffer's bytes as a
ByteBuffer . |
java.io.InputStream |
asInputStream()
Expose this buffer's data as an
InputStream . |
java.io.OutputStream |
asOutputStream()
Expose this buffer's data as an
OutputStream . |
private static void |
assertIndex(boolean expression,
java.lang.String format,
java.lang.Object... args) |
private int |
calculateCapacity(int neededCapacity) |
int |
capacity()
Return the number of bytes that this buffer can contain.
|
DataBuffer |
capacity(int newCapacity)
Sets the number of bytes that this buffer can contain.
|
private void |
checkIndex(int index,
int length) |
private void |
ensureCapacity(int length) |
boolean |
equals(java.lang.Object obj) |
DefaultDataBufferFactory |
factory()
Return the
DataBufferFactory that created this buffer. |
(package private) static DefaultDataBuffer |
fromEmptyByteBuffer(DefaultDataBufferFactory dataBufferFactory,
java.nio.ByteBuffer byteBuffer) |
(package private) static DefaultDataBuffer |
fromFilledByteBuffer(DefaultDataBufferFactory dataBufferFactory,
java.nio.ByteBuffer byteBuffer) |
java.nio.ByteBuffer |
getNativeBuffer()
Directly exposes the native
ByteBuffer that this buffer is based on. |
int |
hashCode() |
int |
indexOf(java.util.function.IntPredicate predicate,
int fromIndex)
Return the index of the first byte in this buffer that matches the given
predicate.
|
int |
lastIndexOf(java.util.function.IntPredicate predicate,
int fromIndex)
Return the index of the last byte in this buffer that matches the given
predicate.
|
byte |
read()
Read a single byte from the current reading position of this data buffer.
|
DefaultDataBuffer |
read(byte[] destination)
Read this buffer's data into the specified destination, starting at the current
reading position of this buffer.
|
DefaultDataBuffer |
read(byte[] destination,
int offset,
int length)
Read at most
length bytes of this buffer into the specified destination,
starting at the current reading position of this buffer. |
int |
readableByteCount()
Return the number of bytes that can be read from this data buffer.
|
int |
readPosition()
Return the position from which this buffer will read.
|
DataBuffer |
readPosition(int readPosition)
Set the position from which this buffer will read.
|
private void |
setNativeBuffer(java.nio.ByteBuffer byteBuffer) |
DataBuffer |
slice(int index,
int length)
Create a new
DataBuffer whose contents is a shared subsequence of this
data buffer's content. |
java.lang.String |
toString() |
int |
writableByteCount()
Return the number of bytes that can be written to this data buffer.
|
DefaultDataBuffer |
write(byte b)
Write a single byte into this buffer at the current writing position.
|
DefaultDataBuffer |
write(byte[] source)
Write the given source into this buffer, startin at the current writing position
of this buffer.
|
DefaultDataBuffer |
write(byte[] source,
int offset,
int length)
Write at most
length bytes of the given source into this buffer, starting
at the current writing position of this buffer. |
DefaultDataBuffer |
write(java.nio.ByteBuffer... byteBuffers)
Write one or more
ByteBuffer to this buffer, starting at the current
writing position. |
private void |
write(java.nio.ByteBuffer source) |
DataBuffer |
write(DataBuffer... buffers)
Write one or more
DataBuffer s to this buffer, starting at the current
writing position. |
int |
writePosition()
Return the position to which this buffer will write.
|
DataBuffer |
writePosition(int writePosition)
Set the position to which this buffer will write.
|
private static final int MAX_CAPACITY
private static final int CAPACITY_THRESHOLD
private final DefaultDataBufferFactory dataBufferFactory
private java.nio.ByteBuffer byteBuffer
private int readPosition
private int writePosition
private int capacity
private DefaultDataBuffer(DefaultDataBufferFactory dataBufferFactory, java.nio.ByteBuffer byteBuffer)
static DefaultDataBuffer fromFilledByteBuffer(DefaultDataBufferFactory dataBufferFactory, java.nio.ByteBuffer byteBuffer)
static DefaultDataBuffer fromEmptyByteBuffer(DefaultDataBufferFactory dataBufferFactory, java.nio.ByteBuffer byteBuffer)
public java.nio.ByteBuffer getNativeBuffer()
ByteBuffer
that this buffer is based on.private void setNativeBuffer(java.nio.ByteBuffer byteBuffer)
public DefaultDataBufferFactory factory()
DataBuffer
DataBufferFactory
that created this buffer.factory
in interface DataBuffer
public int indexOf(java.util.function.IntPredicate predicate, int fromIndex)
DataBuffer
indexOf
in interface DataBuffer
predicate
- the predicate to matchfromIndex
- the index to start the search frompredicate
; or -1
if none matchpublic int lastIndexOf(java.util.function.IntPredicate predicate, int fromIndex)
DataBuffer
lastIndexOf
in interface DataBuffer
predicate
- the predicate to matchfromIndex
- the index to start the search frompredicate
; or -1
if none matchpublic int readableByteCount()
DataBuffer
readableByteCount
in interface DataBuffer
public int writableByteCount()
DataBuffer
writableByteCount
in interface DataBuffer
public int readPosition()
DataBuffer
readPosition
in interface DataBuffer
public DataBuffer readPosition(int readPosition)
DataBuffer
readPosition
in interface DataBuffer
readPosition
- the new read positionpublic int writePosition()
DataBuffer
writePosition
in interface DataBuffer
public DataBuffer writePosition(int writePosition)
DataBuffer
writePosition
in interface DataBuffer
writePosition
- the new write positionpublic int capacity()
DataBuffer
capacity
in interface DataBuffer
public DataBuffer capacity(int newCapacity)
DataBuffer
capacity
in interface DataBuffer
newCapacity
- the new capacityprivate static java.nio.ByteBuffer allocate(int capacity, boolean direct)
public byte read()
DataBuffer
read
in interface DataBuffer
public DefaultDataBuffer read(byte[] destination)
DataBuffer
read
in interface DataBuffer
destination
- the array into which the bytes are to be writtenpublic DefaultDataBuffer read(byte[] destination, int offset, int length)
DataBuffer
length
bytes of this buffer into the specified destination,
starting at the current reading position of this buffer.read
in interface DataBuffer
destination
- the array into which the bytes are to be writtenoffset
- the index within destination
of the first byte to be writtenlength
- the maximum number of bytes to be written in destination
public DefaultDataBuffer write(byte b)
DataBuffer
write
in interface DataBuffer
b
- the byte to be writtenpublic DefaultDataBuffer write(byte[] source)
DataBuffer
write
in interface DataBuffer
source
- the bytes to be written into this bufferpublic DefaultDataBuffer write(byte[] source, int offset, int length)
DataBuffer
length
bytes of the given source into this buffer, starting
at the current writing position of this buffer.write
in interface DataBuffer
source
- the bytes to be written into this bufferoffset
- the index withing source
to start writing fromlength
- the maximum number of bytes to be written from source
public DataBuffer write(DataBuffer... buffers)
DataBuffer
DataBuffer
s to this buffer, starting at the current
writing position. It is the responsibility of the caller to
release the given data buffers.write
in interface DataBuffer
buffers
- the byte buffers to write into this bufferpublic DefaultDataBuffer write(java.nio.ByteBuffer... byteBuffers)
DataBuffer
ByteBuffer
to this buffer, starting at the current
writing position.write
in interface DataBuffer
byteBuffers
- the byte buffers to write into this bufferprivate void write(java.nio.ByteBuffer source)
public DataBuffer slice(int index, int length)
DataBuffer
DataBuffer
whose contents is a shared subsequence of this
data buffer's content. Data between this data buffer and the returned buffer is
shared; though changes in the returned buffer's position will not be reflected
in the reading nor writing position of this data buffer.slice
in interface DataBuffer
index
- the index at which to start the slicelength
- the length of the slicepublic java.nio.ByteBuffer asByteBuffer()
DataBuffer
ByteBuffer
. Data between this
DataBuffer
and the returned ByteBuffer
is shared; though
changes in the returned buffer's position
will not be reflected in the reading nor writing position of this data buffer.asByteBuffer
in interface DataBuffer
public java.nio.ByteBuffer asByteBuffer(int index, int length)
DataBuffer
ByteBuffer
. Data between this
DataBuffer
and the returned ByteBuffer
is shared; though
changes in the returned buffer's position
will not be reflected in the reading nor writing position of this data buffer.asByteBuffer
in interface DataBuffer
index
- the index at which to start the byte bufferlength
- the length of the returned byte bufferpublic java.io.InputStream asInputStream()
DataBuffer
InputStream
. Both data and read position are
shared between the returned stream and this data buffer.asInputStream
in interface DataBuffer
public java.io.OutputStream asOutputStream()
DataBuffer
OutputStream
. Both data and write position are
shared between the returned stream and this data buffer.asOutputStream
in interface DataBuffer
private void ensureCapacity(int length)
private int calculateCapacity(int neededCapacity)
io.netty.buffer.AbstractByteBufAllocator#calculateNewCapacity(int, int)
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object
public java.lang.String toString()
toString
in class java.lang.Object
private void checkIndex(int index, int length)
private static void assertIndex(boolean expression, java.lang.String format, java.lang.Object... args)