UnpooledUnsafeDirectByteBuf (Netty API Reference (4.0.56.Final))

java.lang.Object
- io.netty.buffer.ByteBuf
- - io.netty.buffer.AbstractByteBuf
  - - io.netty.buffer.AbstractReferenceCountedByteBuf
    - - io.netty.buffer.UnpooledUnsafeDirectByteBuf

All Implemented Interfaces:

ReferenceCounted, java.lang.Comparable<ByteBuf>
```
public class UnpooledUnsafeDirectByteBuf
extends AbstractReferenceCountedByteBuf
```
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 and Description
`protected`	`UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc, java.nio.ByteBuffer initialBuffer, int maxCapacity)` Creates a new direct buffer by wrapping the specified initial buffer.
	`UnpooledUnsafeDirectByteBuf(ByteBufAllocator alloc, int initialCapacity, int maxCapacity)` Creates a new direct buffer.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected byte`	`_getByte(int index)`
`protected int`	`_getInt(int index)`
`protected long`	`_getLong(int index)`
`protected short`	`_getShort(int index)`
`protected int`	`_getUnsignedMedium(int index)`
`protected void`	`_setByte(int index, int value)`
`protected void`	`_setInt(int index, int value)`
`protected void`	`_setLong(int index, long value)`
`protected void`	`_setMedium(int index, int value)`
`protected void`	`_setShort(int index, int value)`
`ByteBufAllocator`	`alloc()` Returns the `ByteBufAllocator` which created this buffer.
`protected java.nio.ByteBuffer`	`allocateDirect(int initialCapacity)` Allocate a new direct `ByteBuffer` with the given initialCapacity.
`byte[]`	`array()` Returns the backing byte array of this buffer.
`int`	`arrayOffset()` Returns the offset of the first byte within the backing byte array of this buffer.
`int`	`capacity()` Returns the number of bytes (octets) this buffer can contain.
`ByteBuf`	`capacity(int newCapacity)` Adjusts the capacity of this buffer.
`ByteBuf`	`copy(int index, int length)` Returns a copy of this buffer's sub-region.
`protected void`	`deallocate()` Called once `AbstractReferenceCountedByteBuf.refCnt()` is equals 0.
`protected void`	`freeDirect(java.nio.ByteBuffer buffer)` Free a direct `ByteBuffer`
`ByteBuf`	`getBytes(int index, byte[] dst, int dstIndex, int length)` Transfers this buffer's data to the specified destination starting at the specified absolute `index`.
`ByteBuf`	`getBytes(int index, java.nio.ByteBuffer dst)` Transfers this buffer's data to the specified destination starting at the specified absolute `index` until the destination's position reaches its limit.
`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`	`getBytes(int index, java.nio.channels.GatheringByteChannel out, int length)` Transfers this buffer's data to the specified channel starting at the specified absolute `index`.
`ByteBuf`	`getBytes(int index, java.io.OutputStream out, int length)` Transfers this buffer's data to the specified stream starting at the specified absolute `index`.
`boolean`	`hasArray()` Returns `true` if and only if this buffer has a backing byte array.
`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.
`java.nio.ByteBuffer`	`internalNioBuffer(int index, int length)` Internal use only: Exposes the internal NIO buffer.
`boolean`	`isDirect()` Returns `true` if and only if this buffer is backed by an NIO direct buffer.
`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.
`java.nio.ByteBuffer`	`nioBuffer(int index, int length)` Exposes this buffer's sub-region as an NIO `ByteBuffer`.
`int`	`nioBufferCount()` Returns the maximum number of NIO `ByteBuffer`s that consist this buffer.
`java.nio.ByteBuffer[]`	`nioBuffers(int index, int length)` Exposes this buffer's bytes as an NIO `ByteBuffer`'s for the specified index and length The returned buffer either share or contains the copied content of this buffer, while changing the position and limit of the returned NIO buffer does not affect the indexes and marks of this buffer.
`java.nio.ByteOrder`	`order()` Returns the endianness of this buffer.
`ByteBuf`	`readBytes(java.nio.ByteBuffer dst)` Transfers this buffer's data to the specified destination starting at the current `readerIndex` until the destination's position reaches its limit, and increases the `readerIndex` by the number of the transferred bytes.
`int`	`readBytes(java.nio.channels.GatheringByteChannel out, int length)` Transfers this buffer's data to the specified stream starting at the current `readerIndex`.
`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, java.nio.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`	`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, java.io.InputStream in, int length)` Transfers the content of the specified source stream to this buffer starting at the specified absolute `index`.
`int`	`setBytes(int index, java.nio.channels.ScatteringByteChannel in, int length)` Transfers the content of the specified source channel to this buffer starting at the specified absolute `index`.
`ByteBuf`	`setZero(int index, int length)` Fills this buffer with `NUL (0x00)` starting at the specified absolute `index`.
`ByteBuf`	`unwrap()` Return the underlying buffer instance if this buffer is a wrapper of another buffer.
`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 io.netty.buffer.AbstractReferenceCountedByteBuf
refCnt, release, release, retain, retain, setRefCnt

Methods inherited from class io.netty.buffer.AbstractByteBuf
adjustMarkers, bytesBefore, bytesBefore, bytesBefore, checkDstIndex, checkIndex, checkIndex, checkNewCapacity, checkReadableBytes, checkSrcIndex, clear, compareTo, copy, discardReadBytes, discardSomeReadBytes, duplicate, ensureAccessible, ensureWritable, ensureWritable, equals, forEachByte, forEachByte, forEachByteDesc, forEachByteDesc, getBoolean, getByte, getBytes, getBytes, getBytes, getChar, getDouble, getFloat, getInt, getLong, getMedium, getShort, getUnsignedByte, getUnsignedInt, getUnsignedMedium, getUnsignedShort, hashCode, indexOf, isReadable, isReadable, isWritable, isWritable, markReaderIndex, markWriterIndex, maxCapacity, maxCapacity, maxWritableBytes, nioBuffer, nioBuffers, order, readableBytes, readBoolean, readByte, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readChar, readDouble, readerIndex, readerIndex, readFloat, readInt, readLong, readMedium, readShort, readSlice, readUnsignedByte, readUnsignedInt, readUnsignedMedium, readUnsignedShort, resetReaderIndex, resetWriterIndex, setBoolean, setByte, setBytes, setBytes, setBytes, setChar, setDouble, setFloat, setIndex, setInt, setLong, setMedium, setShort, skipBytes, slice, slice, toString, toString, toString, writableBytes, writeBoolean, writeByte, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeChar, writeDouble, writeFloat, writeInt, writeLong, writeMedium, writerIndex, writerIndex, writeShort

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - 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,
                                      java.nio.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
- Method Detail
  - allocateDirect
```
protected java.nio.ByteBuffer allocateDirect(int initialCapacity)
```
    Allocate a new direct ByteBuffer with the given initialCapacity.
  - freeDirect
```
protected void freeDirect(java.nio.ByteBuffer buffer)
```
    Free a direct ByteBuffer
  - isDirect
```
public boolean isDirect()
```
    Description copied from class: ByteBuf
    
    Returns true if and only if this buffer is backed by an NIO direct buffer.
    
    Specified by:
    
    isDirect in class ByteBuf
  - capacity
```
public int capacity()
```
    Description copied from class: ByteBuf
    
    Returns the number of bytes (octets) this buffer can contain.
    
    Specified by:
    
    capacity in class ByteBuf
  - capacity
```
public ByteBuf capacity(int newCapacity)
```
    Description copied from class: ByteBuf
    
    Adjusts the capacity of this buffer. If the newCapacity is less than the current capacity, the content of this buffer is truncated. If the newCapacity is greater than the current capacity, the buffer is appended with unspecified data whose length is (newCapacity - currentCapacity).
    
    Specified by:
    
    capacity in class ByteBuf
  - alloc
```
public ByteBufAllocator alloc()
```
    Description copied from class: ByteBuf
    
    Returns the ByteBufAllocator which created this buffer.
    
    Specified by:
    
    alloc in class ByteBuf
  - order
```
public java.nio.ByteOrder order()
```
    Description copied from class: ByteBuf
    
    Returns the endianness of this buffer.
    
    Specified by:
    
    order in class ByteBuf
  - hasArray
```
public boolean hasArray()
```
    Description copied from class: ByteBuf
    
    Returns true if and only if this buffer has a backing byte array. If this method returns true, you can safely call ByteBuf.array() and ByteBuf.arrayOffset().
    
    Specified by:
    
    hasArray in class ByteBuf
  - array
```
public byte[] array()
```
    Description copied from class: ByteBuf
    
    Returns the backing byte array of this buffer.
    
    Specified by:
    
    array in class ByteBuf
  - arrayOffset
```
public int arrayOffset()
```
    Description copied from class: ByteBuf
    
    Returns the offset of the first byte within the backing byte array of this buffer.
    
    Specified by:
    
    arrayOffset in class ByteBuf
  - 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.
    
    Specified by:
    
    hasMemoryAddress in class ByteBuf
  - 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.
    
    Specified by:
    
    memoryAddress in class ByteBuf
  - _getByte
```
protected byte _getByte(int index)
```
    Specified by:
    
    _getByte in class AbstractByteBuf
  - _getShort
```
protected short _getShort(int index)
```
    Specified by:
    
    _getShort in class AbstractByteBuf
  - _getUnsignedMedium
```
protected int _getUnsignedMedium(int index)
```
    Specified by:
    
    _getUnsignedMedium in class AbstractByteBuf
  - _getInt
```
protected int _getInt(int index)
```
    Specified by:
    
    _getInt in class AbstractByteBuf
  - _getLong
```
protected long _getLong(int index)
```
    Specified by:
    
    _getLong in class AbstractByteBuf
  - 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.
    
    Specified by:
    
    getBytes in class ByteBuf
    
    dstIndex - the first index of the destination
    
    length - the number of bytes to transfer
  - getBytes
```
public ByteBuf getBytes(int index,
                        byte[] 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 this buffer.
    
    Specified by:
    
    getBytes in class ByteBuf
    
    dstIndex - the first index of the destination
    
    length - the number of bytes to transfer
  - getBytes
```
public ByteBuf getBytes(int index,
                        java.nio.ByteBuffer dst)
```
    Description copied from class: ByteBuf
    
    Transfers this buffer's data to the specified destination starting at the specified absolute index until the destination's position reaches its limit. This method does not modify readerIndex or writerIndex of this buffer while the destination's position will be increased.
    
    Specified by:
    
    getBytes in class ByteBuf
  - readBytes
```
public ByteBuf readBytes(java.nio.ByteBuffer dst)
```
    Description copied from class: ByteBuf
    
    Transfers this buffer's data to the specified destination starting at the current readerIndex until the destination's position reaches its limit, and increases the readerIndex by the number of the transferred bytes.
    
    Overrides:
    
    readBytes in class AbstractByteBuf
  - _setByte
```
protected void _setByte(int index,
                        int value)
```
    Specified by:
    
    _setByte in class AbstractByteBuf
  - _setShort
```
protected void _setShort(int index,
                         int value)
```
    Specified by:
    
    _setShort in class AbstractByteBuf
  - _setMedium
```
protected void _setMedium(int index,
                          int value)
```
    Specified by:
    
    _setMedium in class AbstractByteBuf
  - _setInt
```
protected void _setInt(int index,
                       int value)
```
    Specified by:
    
    _setInt in class AbstractByteBuf
  - _setLong
```
protected void _setLong(int index,
                        long value)
```
    Specified by:
    
    _setLong in class AbstractByteBuf
  - 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.
    
    Specified by:
    
    setBytes in class ByteBuf
    
    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.
    
    Specified by:
    
    setBytes in class ByteBuf
  - setBytes
```
public ByteBuf setBytes(int index,
                        java.nio.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.
    
    Specified by:
    
    setBytes in class ByteBuf
  - getBytes
```
public ByteBuf getBytes(int index,
                        java.io.OutputStream out,
                        int length)
                 throws java.io.IOException
```
    Description copied from class: ByteBuf
    
    Transfers this buffer's data to the specified stream starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.
    
    Specified by:
    
    getBytes in class ByteBuf
    
    length - the number of bytes to transfer
    
    Throws:
    
    java.io.IOException - if the specified stream threw an exception during I/O
  - getBytes
```
public int getBytes(int index,
                    java.nio.channels.GatheringByteChannel out,
                    int length)
             throws java.io.IOException
```
    Description copied from class: ByteBuf
    
    Transfers this buffer's data to the specified channel starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.
    
    Specified by:
    
    getBytes in class ByteBuf
    
    length - the maximum number of bytes to transfer
    
    Returns:
    
    the actual number of bytes written out to the specified channel
    
    Throws:
    
    java.io.IOException - if the specified channel threw an exception during I/O
  - readBytes
```
public int readBytes(java.nio.channels.GatheringByteChannel out,
                     int length)
              throws java.io.IOException
```
    Description copied from class: ByteBuf
    
    Transfers this buffer's data to the specified stream starting at the current readerIndex.
    
    Overrides:
    
    readBytes in class AbstractByteBuf
    
    length - the maximum number of bytes to transfer
    
    Returns:
    
    the actual number of bytes written out to the specified channel
    
    Throws:
    
    java.io.IOException - if the specified channel threw an exception during I/O
  - setBytes
```
public int setBytes(int index,
                    java.io.InputStream in,
                    int length)
             throws java.io.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.
    
    Specified by:
    
    setBytes in class ByteBuf
    
    length - the number of bytes to transfer
    
    Returns:
    
    the actual number of bytes read in from the specified channel. -1 if the specified channel is closed.
    
    Throws:
    
    java.io.IOException - if the specified stream threw an exception during I/O
  - setBytes
```
public int setBytes(int index,
                    java.nio.channels.ScatteringByteChannel in,
                    int length)
             throws java.io.IOException
```
    Description copied from class: ByteBuf
    
    Transfers the content of the specified source channel to this buffer starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer.
    
    Specified by:
    
    setBytes in class ByteBuf
    
    length - the maximum number of bytes to transfer
    
    Returns:
    
    the actual number of bytes read in from the specified channel. -1 if the specified channel is closed.
    
    Throws:
    
    java.io.IOException - if the specified channel threw an exception during I/O
  - nioBufferCount
```
public int nioBufferCount()
```
    Description copied from class: ByteBuf
    
    Returns the maximum number of NIO ByteBuffers that consist this buffer. Note that ByteBuf.nioBuffers() or ByteBuf.nioBuffers(int, int) might return a less number of ByteBuffers.
    
    Specified by:
    
    nioBufferCount in class ByteBuf
    
    Returns:
    
    -1 if this buffer has no underlying ByteBuffer. the number of the underlying ByteBuffers if this buffer has at least one underlying ByteBuffer. Note that this method does not return 0 to avoid confusion.
    
    See Also:
    
    ByteBuf.nioBuffer(), ByteBuf.nioBuffer(int, int), ByteBuf.nioBuffers(), ByteBuf.nioBuffers(int, int)
  - nioBuffers
```
public java.nio.ByteBuffer[] nioBuffers(int index,
                                        int length)
```
    Description copied from class: ByteBuf
    
    Exposes this buffer's bytes as an NIO ByteBuffer's for the specified index and length The returned buffer either share or contains the copied content of this buffer, while changing the position and limit of the returned NIO buffer does not affect the indexes and marks of this buffer. This method does not modify readerIndex or writerIndex of this buffer. Please note that the returned NIO buffer will not see the changes of this buffer if this buffer is a dynamic buffer and it adjusted its capacity.
    
    Specified by:
    
    nioBuffers in class ByteBuf
    
    See Also:
    
    ByteBuf.nioBufferCount(), ByteBuf.nioBuffer(), ByteBuf.nioBuffer(int, int)
  - 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.
    
    Specified by:
    
    copy in class ByteBuf
  - internalNioBuffer
```
public java.nio.ByteBuffer internalNioBuffer(int index,
                                             int length)
```
    Description copied from class: ByteBuf
    
    Internal use only: Exposes the internal NIO buffer.
    
    Specified by:
    
    internalNioBuffer in class ByteBuf
  - nioBuffer
```
public java.nio.ByteBuffer nioBuffer(int index,
                                     int length)
```
    Description copied from class: ByteBuf
    
    Exposes this buffer's sub-region as an NIO ByteBuffer. The returned buffer either share or contains the copied content of this buffer, while changing the position and limit of the returned NIO buffer does not affect the indexes and marks of this buffer. This method does not modify readerIndex or writerIndex of this buffer. Please note that the returned NIO buffer will not see the changes of this buffer if this buffer is a dynamic buffer and it adjusted its capacity.
    
    Specified by:
    
    nioBuffer in class ByteBuf
    
    See Also:
    
    ByteBuf.nioBufferCount(), ByteBuf.nioBuffers(), ByteBuf.nioBuffers(int, int)
  - deallocate
```
protected void deallocate()
```
    Description copied from class: AbstractReferenceCountedByteBuf
    
    Called once AbstractReferenceCountedByteBuf.refCnt() is equals 0.
    
    Specified by:
    
    deallocate in class AbstractReferenceCountedByteBuf
  - unwrap
```
public ByteBuf unwrap()
```
    Description copied from class: ByteBuf
    
    Return the underlying buffer instance if this buffer is a wrapper of another buffer.
    
    Specified by:
    
    unwrap in class ByteBuf
    
    Returns:
    
    null if this buffer is not a wrapper
  - 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
    
    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.
    
    Overrides:
    
    writeZero in class AbstractByteBuf
    
    Parameters:
    
    length - the number of NULs to write to the buffer

Class UnpooledUnsafeDirectByteBuf

Constructor Summary

Method Summary

Methods inherited from class io.netty.buffer.AbstractReferenceCountedByteBuf

Methods inherited from class io.netty.buffer.AbstractByteBuf

Methods inherited from class java.lang.Object

Constructor Detail

UnpooledUnsafeDirectByteBuf

UnpooledUnsafeDirectByteBuf

Method Detail

allocateDirect

freeDirect

isDirect

capacity

capacity

alloc

order

hasArray

array

arrayOffset

hasMemoryAddress

memoryAddress

_getByte

_getShort

_getUnsignedMedium

_getInt

_getLong

getBytes

getBytes

getBytes

readBytes

_setByte

_setShort

_setMedium

_setInt

_setLong

setBytes

setBytes

setBytes

getBytes

getBytes

readBytes

setBytes

setBytes

nioBufferCount

nioBuffers

copy

internalNioBuffer

nioBuffer

deallocate

unwrap

newSwappedByteBuf

setZero

writeZero