Class UnpooledUnsafeDirectByteBuf

java.lang.Object

io.netty.buffer.ByteBuf

io.netty.buffer.AbstractByteBuf

io.netty.buffer.AbstractReferenceCountedByteBuf

io.netty.buffer.UnpooledDirectByteBuf

io.netty.buffer.UnpooledUnsafeDirectByteBuf

All Implemented Interfaces:

ByteBufConvertible, ReferenceCounted, Comparable<ByteBuf>

public class UnpooledUnsafeDirectByteBuf
extends UnpooledDirectByteBuf

A NIO ByteBuffer based buffer. It is recommended to use AbstractByteBufAllocator.directBuffer(int, int), Unpooled.directBuffer(int) and Unpooled.wrappedBuffer(ByteBuffer) instead of calling the constructor explicitly.}

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc, boolean slice, ByteBuffer initialBuffer, int maxCapacity)	Creates a new direct ByteBuf by wrapping the specified initial buffer.
	UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc, int initialCapacity, int maxCapacity)	Creates a new direct buffer.
protected	UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc, ByteBuffer initialBuffer, int maxCapacity)	Creates a new direct buffer by wrapping the specified initial buffer.

Method Summary

Modifier and Type	Method	Description
protected byte	_getByte(int index)
protected int	_getInt(int index)
protected int	_getIntLE(int index)
protected long	_getLong(int index)
protected long	_getLongLE(int index)
protected short	_getShort(int index)
protected short	_getShortLE(int index)
protected int	_getUnsignedMedium(int index)
protected int	_getUnsignedMediumLE(int index)
protected void	_setByte(int index, int value)
protected void	_setInt(int index, int value)
protected void	_setIntLE(int index, int value)
protected void	_setLong(int index, long value)
protected void	_setLongLE(int index, long value)
protected void	_setMedium(int index, int value)
protected void	_setMediumLE(int index, int value)
protected void	_setShort(int index, int value)
protected void	_setShortLE(int index, int value)
ByteBuf	copy(int index, int length)	Returns a copy of this buffer's sub-region.
byte	getByte(int index)	Gets a byte at the specified absolute index in this buffer.
ByteBuf	getBytes(int index, ByteBuf dst, int dstIndex, int length)	Transfers this buffer's data to the specified destination starting at the specified absolute index.
int	getInt(int index)	Gets a 32-bit integer at the specified absolute index in this buffer.
long	getLong(int index)	Gets a 64-bit long integer at the specified absolute index in this buffer.
short	getShort(int index)	Gets a 16-bit short integer at the specified absolute index in this buffer.
int	getUnsignedMedium(int index)	Gets an unsigned 24-bit medium integer at the specified absolute index in this buffer.
boolean	hasMemoryAddress()	Returns true if and only if this buffer has a reference to the low-level memory address that points to the backing data.
long	memoryAddress()	Returns the low-level memory address that point to the first byte of ths backing data.
protected SwappedByteBuf	newSwappedByteBuf()	Creates a new SwappedByteBuf for this ByteBuf instance.
ByteBuf	setByte(int index, int value)	Sets the specified byte at the specified absolute index in this buffer.
ByteBuf	setBytes(int index, byte[] src, int srcIndex, int length)	Transfers the specified source array's data to this buffer starting at the specified absolute index.
ByteBuf	setBytes(int index, ByteBuf src, int srcIndex, int length)	Transfers the specified source buffer's data to this buffer starting at the specified absolute index.
int	setBytes(int index, InputStream in, int length)	Transfers the content of the specified source stream to this buffer starting at the specified absolute index.
ByteBuf	setBytes(int index, ByteBuffer src)	Transfers the specified source buffer's data to this buffer starting at the specified absolute index until the source buffer's position reaches its limit.
ByteBuf	setInt(int index, int value)	Sets the specified 32-bit integer at the specified absolute index in this buffer.
ByteBuf	setLong(int index, long value)	Sets the specified 64-bit long integer at the specified absolute index in this buffer.
ByteBuf	setMedium(int index, int value)	Sets the specified 24-bit medium integer at the specified absolute index in this buffer.
ByteBuf	setShort(int index, int value)	Sets the specified 16-bit short integer at the specified absolute index in this buffer.
ByteBuf	setZero(int index, int length)	Fills this buffer with NUL (0x00) starting at the specified absolute index.
ByteBuf	writeZero(int length)	Fills this buffer with NUL (0x00) starting at the current writerIndex and increases the writerIndex by the specified length.

Methods inherited from class UnpooledDirectByteBuf

alloc, allocateDirect, allocateDirectBuffer, array, arrayOffset, capacity, capacity, deallocate, freeDirect, getBytes, getBytes, getBytes, getBytes, getBytes, getIntLE, getLongLE, getShortLE, hasArray, internalNioBuffer, isContiguous, isDirect, nioBuffer, nioBufferCount, nioBuffers, order, readBytes, readBytes, readBytes, readBytes, readBytes, setBytes, setBytes, setIntLE, setLongLE, setMediumLE, setShortLE, unwrap

Methods inherited from class AbstractReferenceCountedByteBuf

refCnt, release, release, resetRefCnt, retain, retain, setRefCnt, touch, touch

Methods inherited from class AbstractByteBuf

adjustMarkers, asReadOnly, bytesBefore, bytesBefore, bytesBefore, checkDstIndex, checkDstIndex, checkIndex, checkIndex, checkNewCapacity, checkReadableBytes, checkSrcIndex, clear, compareTo, copy, discardReadBytes, discardSomeReadBytes, duplicate, ensureAccessible, ensureWritable, ensureWritable, equals, forEachByte, forEachByte, forEachByteDesc, forEachByteDesc, getBoolean, getBytes, getBytes, getBytes, getChar, getCharSequence, getDouble, getFloat, getMedium, getMediumLE, getUnsignedByte, getUnsignedInt, getUnsignedIntLE, getUnsignedMediumLE, getUnsignedShort, getUnsignedShortLE, hashCode, indexOf, isReadable, isReadable, isReadOnly, isWritable, isWritable, markReaderIndex, markWriterIndex, maxCapacity, maxCapacity, maxWritableBytes, nioBuffer, nioBuffers, order, readableBytes, readBoolean, readByte, readBytes, readBytes, readBytes, readBytes, readBytes, readChar, readCharSequence, readDouble, readerIndex, readerIndex, readFloat, readInt, readIntLE, readLong, readLongLE, readMedium, readMediumLE, readRetainedSlice, readShort, readShortLE, readSlice, readString, readUnsignedByte, readUnsignedInt, readUnsignedIntLE, readUnsignedMedium, readUnsignedMediumLE, readUnsignedShort, readUnsignedShortLE, resetReaderIndex, resetWriterIndex, retainedDuplicate, retainedSlice, retainedSlice, setBoolean, setBytes, setBytes, setBytes, setChar, setCharSequence, setDouble, setFloat, setIndex, skipBytes, slice, slice, toString, toString, toString, trimIndicesToCapacity, writableBytes, writeBoolean, writeByte, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeChar, writeCharSequence, writeDouble, writeFloat, writeInt, writeIntLE, writeLong, writeLongLE, writeMedium, writeMediumLE, writerIndex, writerIndex, writeShort, writeShortLE

Methods inherited from class ByteBuf

asByteBuf, getDoubleLE, getFloatLE, maxFastWritableBytes, readDoubleLE, readFloatLE, setDoubleLE, setFloatLE, writeDoubleLE, writeFloatLE

Methods inherited from class Object

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

Constructor Details

UnpooledUnsafeDirectByteBuf

public UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc,
 int initialCapacity,
 int maxCapacity)

Creates a new direct buffer.

Parameters:

initialCapacity - the initial capacity of the underlying direct buffer

maxCapacity - the maximum capacity of the underlying direct buffer

UnpooledUnsafeDirectByteBuf

protected UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc,
 ByteBuffer initialBuffer,
 int maxCapacity)

Creates a new direct buffer by wrapping the specified initial buffer.

Parameters:

maxCapacity - the maximum capacity of the underlying direct buffer

UnpooledUnsafeDirectByteBuf

@UnstableApi
protected UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc,
 boolean slice,
 ByteBuffer initialBuffer,
 int maxCapacity)

Creates a new direct ByteBuf by wrapping the specified initial buffer. Allows subclasses to control if initialBuffer.slice() should be invoked. Attention: this is a dangerous API and should only be used by someone who really knows the possible consequences. It allows to disable a protective slicing for the provided ByteBuffer instance and can cause sharing of this ByteBuffer instance between several UnpooledUnsafeDirectByteBuf objects, as a result modifications would be racy and unsafe.

Parameters:

slice - true means slice() should be called for the provided initialBuffer

maxCapacity - the maximum capacity of the underlying direct buffer

Method Details

hasMemoryAddress

public boolean hasMemoryAddress()

Description copied from class: ByteBuf

Returns true if and only if this buffer has a reference to the low-level memory address that points to the backing data.

Overrides:

hasMemoryAddress in class UnpooledDirectByteBuf

memoryAddress

public long memoryAddress()

Description copied from class: ByteBuf

Returns the low-level memory address that point to the first byte of ths backing data.

Overrides:

memoryAddress in class UnpooledDirectByteBuf

getByte

public byte getByte(int index)

Description copied from class: ByteBuf

Gets a byte at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

getByte in class UnpooledDirectByteBuf

_getByte

protected byte _getByte(int index)

Overrides:

_getByte in class UnpooledDirectByteBuf

getShort

public short getShort(int index)

Description copied from class: ByteBuf

Gets a 16-bit short integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

getShort in class UnpooledDirectByteBuf

_getShort

protected short _getShort(int index)

Overrides:

_getShort in class UnpooledDirectByteBuf

_getShortLE

protected short _getShortLE(int index)

Overrides:

_getShortLE in class UnpooledDirectByteBuf

getUnsignedMedium

public int getUnsignedMedium(int index)

Description copied from class: ByteBuf

Gets an unsigned 24-bit medium integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

getUnsignedMedium in class UnpooledDirectByteBuf

_getUnsignedMedium

protected int _getUnsignedMedium(int index)

Overrides:

_getUnsignedMedium in class UnpooledDirectByteBuf

_getUnsignedMediumLE

protected int _getUnsignedMediumLE(int index)

Overrides:

_getUnsignedMediumLE in class UnpooledDirectByteBuf

getInt

public int getInt(int index)

Description copied from class: ByteBuf

Gets a 32-bit integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

getInt in class UnpooledDirectByteBuf

_getInt

protected int _getInt(int index)

Overrides:

_getInt in class UnpooledDirectByteBuf

_getIntLE

protected int _getIntLE(int index)

Overrides:

_getIntLE in class UnpooledDirectByteBuf

getLong

public long getLong(int index)

Description copied from class: ByteBuf

Gets a 64-bit long integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

getLong in class UnpooledDirectByteBuf

_getLong

protected long _getLong(int index)

Overrides:

_getLong in class UnpooledDirectByteBuf

_getLongLE

protected long _getLongLE(int index)

Overrides:

_getLongLE in class UnpooledDirectByteBuf

getBytes

public ByteBuf getBytes(int index,
 ByteBuf dst,
 int dstIndex,
 int length)

Description copied from class: ByteBuf

Transfers this buffer's data to the specified destination starting at the specified absolute index. This method does not modify readerIndex or writerIndex of both the source (i.e. this) and the destination.

Overrides:

getBytes in class UnpooledDirectByteBuf

Parameters:

dstIndex - the first index of the destination

length - the number of bytes to transfer

setByte

public ByteBuf setByte(int index,
 int value)

Description copied from class: ByteBuf

Sets the specified byte at the specified absolute index in this buffer. The 24 high-order bits of the specified value are ignored. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setByte in class UnpooledDirectByteBuf

_setByte

protected void _setByte(int index,
 int value)

Overrides:

_setByte in class UnpooledDirectByteBuf

setShort

public ByteBuf setShort(int index,
 int value)

Description copied from class: ByteBuf

Sets the specified 16-bit short integer at the specified absolute index in this buffer. The 16 high-order bits of the specified value are ignored. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setShort in class UnpooledDirectByteBuf

_setShort

protected void _setShort(int index,
 int value)

Overrides:

_setShort in class UnpooledDirectByteBuf

_setShortLE

protected void _setShortLE(int index,
 int value)

Overrides:

_setShortLE in class UnpooledDirectByteBuf

setMedium

public ByteBuf setMedium(int index,
 int value)

Description copied from class: ByteBuf

Sets the specified 24-bit medium integer at the specified absolute index in this buffer. Please note that the most significant byte is ignored in the specified value. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setMedium in class UnpooledDirectByteBuf

_setMedium

protected void _setMedium(int index,
 int value)

Overrides:

_setMedium in class UnpooledDirectByteBuf

_setMediumLE

protected void _setMediumLE(int index,
 int value)

Overrides:

_setMediumLE in class UnpooledDirectByteBuf

setInt

public ByteBuf setInt(int index,
 int value)

Description copied from class: ByteBuf

Sets the specified 32-bit integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setInt in class UnpooledDirectByteBuf

_setInt

protected void _setInt(int index,
 int value)

Overrides:

_setInt in class UnpooledDirectByteBuf

_setIntLE

protected void _setIntLE(int index,
 int value)

Overrides:

_setIntLE in class UnpooledDirectByteBuf

setLong

public ByteBuf setLong(int index,
 long value)

Description copied from class: ByteBuf

Sets the specified 64-bit long integer at the specified absolute index in this buffer. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setLong in class UnpooledDirectByteBuf

_setLong

protected void _setLong(int index,
 long value)

Overrides:

_setLong in class UnpooledDirectByteBuf

_setLongLE

protected void _setLongLE(int index,
 long value)

Overrides:

_setLongLE in class UnpooledDirectByteBuf

setBytes

public ByteBuf setBytes(int index,
 ByteBuf src,
 int srcIndex,
 int length)

Description copied from class: ByteBuf

Transfers the specified source buffer's data to this buffer starting at the specified absolute index. This method does not modify readerIndex or writerIndex of both the source (i.e. this) and the destination.

Overrides:

setBytes in class UnpooledDirectByteBuf

Parameters:

srcIndex - the first index of the source

length - the number of bytes to transfer

setBytes

public ByteBuf setBytes(int index,
 byte[] src,
 int srcIndex,
 int length)

Description copied from class: ByteBuf

Transfers the specified source array's data to this buffer starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setBytes in class UnpooledDirectByteBuf

setBytes

public ByteBuf setBytes(int index,
 ByteBuffer src)

Description copied from class: ByteBuf

Transfers the specified source buffer's data to this buffer starting at the specified absolute index until the source buffer's position reaches its limit. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setBytes in class UnpooledDirectByteBuf

setBytes

public int setBytes(int index,
 InputStream in,
 int length)
             throws IOException

Description copied from class: ByteBuf

Transfers the content of the specified source stream to this buffer starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setBytes in class UnpooledDirectByteBuf

Parameters:

length - the number of bytes to transfer

Returns:

the actual number of bytes read in from the specified channel. -1 if the specified InputStream reached EOF.

Throws:

IOException - if the specified stream threw an exception during I/O

copy

public ByteBuf copy(int index,
 int length)

Description copied from class: ByteBuf

Returns a copy of this buffer's sub-region. Modifying the content of the returned buffer or this buffer does not affect each other at all. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

copy in class UnpooledDirectByteBuf

newSwappedByteBuf

protected SwappedByteBuf newSwappedByteBuf()

Description copied from class: AbstractByteBuf

Creates a new SwappedByteBuf for this ByteBuf instance.

Overrides:

newSwappedByteBuf in class AbstractByteBuf

setZero

public ByteBuf setZero(int index,
 int length)

Description copied from class: ByteBuf

Fills this buffer with NUL (0x00) starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.

Overrides:

setZero in class AbstractByteBuf

Parameters:

length - the number of NULs to write to the buffer

writeZero

public ByteBuf writeZero(int length)

Description copied from class: ByteBuf

Fills this buffer with NUL (0x00) starting at the current writerIndex and increases the writerIndex by the specified length. If this.writableBytes is less than length, ByteBuf.ensureWritable(int) will be called in an attempt to expand capacity to accommodate.

Overrides:

writeZero in class AbstractByteBuf

Parameters:

length - the number of NULs to write to the buffer