Package io.netty.buffer

Class ReadOnlyByteBuf

java.lang.Object

io.netty.buffer.ByteBuf

io.netty.buffer.AbstractByteBuf

io.netty.buffer.AbstractDerivedByteBuf

io.netty.buffer.ReadOnlyByteBuf

All Implemented Interfaces:

ByteBufConvertible, ReferenceCounted, java.lang.Comparable<ByteBuf>

@Deprecated
public class ReadOnlyByteBuf
extends AbstractDerivedByteBuf

Deprecated.

Do not use.

A derived buffer which forbids any write requests to its parent. It is recommended to use Unpooled.unmodifiableBuffer(ByteBuf) instead of calling the constructor explicitly.

Constructor Summary

Constructors

Constructor	Description
ReadOnlyByteBuf(ByteBuf buffer)	Deprecated.

Method Summary

Modifier and Type	Method	Description
protected byte	_getByte(int index)	Deprecated.
protected int	_getInt(int index)	Deprecated.
protected int	_getIntLE(int index)	Deprecated.
protected long	_getLong(int index)	Deprecated.
protected long	_getLongLE(int index)	Deprecated.
protected short	_getShort(int index)	Deprecated.
protected short	_getShortLE(int index)	Deprecated.
protected int	_getUnsignedMedium(int index)	Deprecated.
protected int	_getUnsignedMediumLE(int index)	Deprecated.
protected void	_setByte(int index, int value)	Deprecated.
protected void	_setInt(int index, int value)	Deprecated.
protected void	_setIntLE(int index, int value)	Deprecated.
protected void	_setLong(int index, long value)	Deprecated.
protected void	_setLongLE(int index, long value)	Deprecated.
protected void	_setMedium(int index, int value)	Deprecated.
protected void	_setMediumLE(int index, int value)	Deprecated.
protected void	_setShort(int index, int value)	Deprecated.
protected void	_setShortLE(int index, int value)	Deprecated.
ByteBufAllocator	alloc()	Deprecated. Returns the ByteBufAllocator which created this buffer.
byte[]	array()	Deprecated. Returns the backing byte array of this buffer.
int	arrayOffset()	Deprecated. Returns the offset of the first byte within the backing byte array of this buffer.
ByteBuf	asReadOnly()	Deprecated. Returns a read-only version of this buffer.
int	capacity()	Deprecated. Returns the number of bytes (octets) this buffer can contain.
ByteBuf	capacity(int newCapacity)	Deprecated. Adjusts the capacity of this buffer.
ByteBuf	copy(int index, int length)	Deprecated. Returns a copy of this buffer's sub-region.
ByteBuf	discardReadBytes()	Deprecated. Discards the bytes between the 0th index and readerIndex.
ByteBuf	duplicate()	Deprecated. Returns a buffer which shares the whole region of this buffer.
ByteBuf	ensureWritable(int minWritableBytes)	Deprecated. Expands the buffer ByteBuf.capacity() to make sure the number of writable bytes is equal to or greater than the specified value.
int	ensureWritable(int minWritableBytes, boolean force)	Deprecated. Expands the buffer ByteBuf.capacity() to make sure the number of writable bytes is equal to or greater than the specified value.
int	forEachByte(int index, int length, ByteProcessor processor)	Deprecated. Iterates over the specified area of this buffer with the specified processor in ascending order.
int	forEachByteDesc(int index, int length, ByteProcessor processor)	Deprecated. Iterates over the specified area of this buffer with the specified processor in descending order.
byte	getByte(int index)	Deprecated. Gets a byte at the specified absolute index in this buffer.
ByteBuf	getBytes(int index, byte[] dst, int dstIndex, int length)	Deprecated. Transfers this buffer's data to the specified destination starting at the specified absolute index.
ByteBuf	getBytes(int index, ByteBuf dst, int dstIndex, int length)	Deprecated. Transfers this buffer's data to the specified destination starting at the specified absolute index.
ByteBuf	getBytes(int index, java.io.OutputStream out, int length)	Deprecated. Transfers this buffer's data to the specified stream starting at the specified absolute index.
ByteBuf	getBytes(int index, java.nio.ByteBuffer dst)	Deprecated. Transfers this buffer's data to the specified destination starting at the specified absolute index until the destination's position reaches its limit.
int	getBytes(int index, java.nio.channels.FileChannel out, long position, int length)	Deprecated. Transfers this buffer's data starting at the specified absolute index to the specified channel starting at the given file position.
int	getBytes(int index, java.nio.channels.GatheringByteChannel out, int length)	Deprecated. Transfers this buffer's data to the specified channel starting at the specified absolute index.
int	getInt(int index)	Deprecated. Gets a 32-bit integer at the specified absolute index in this buffer.
int	getIntLE(int index)	Deprecated. Gets a 32-bit integer at the specified absolute index in this buffer with Little Endian Byte Order.
long	getLong(int index)	Deprecated. Gets a 64-bit long integer at the specified absolute index in this buffer.
long	getLongLE(int index)	Deprecated. Gets a 64-bit long integer at the specified absolute index in this buffer in Little Endian Byte Order.
short	getShort(int index)	Deprecated. Gets a 16-bit short integer at the specified absolute index in this buffer.
short	getShortLE(int index)	Deprecated. Gets a 16-bit short integer at the specified absolute index in this buffer in Little Endian Byte Order.
int	getUnsignedMedium(int index)	Deprecated. Gets an unsigned 24-bit medium integer at the specified absolute index in this buffer.
int	getUnsignedMediumLE(int index)	Deprecated. Gets an unsigned 24-bit medium integer at the specified absolute index in this buffer in Little Endian Byte Order.
boolean	hasArray()	Deprecated. Returns true if and only if this buffer has a backing byte array.
boolean	hasMemoryAddress()	Deprecated. Returns true if and only if this buffer has a reference to the low-level memory address that points to the backing data.
boolean	isDirect()	Deprecated. Returns true if and only if this buffer is backed by an NIO direct buffer.
boolean	isReadOnly()	Deprecated. Returns true if and only if this buffer is read-only.
boolean	isWritable()	Deprecated. Returns true if and only if (this.capacity - this.writerIndex) is greater than 0.
boolean	isWritable(int numBytes)	Deprecated. Returns true if and only if this buffer has enough room to allow writing the specified number of elements.
long	memoryAddress()	Deprecated. Returns the low-level memory address that point to the first byte of ths backing data.
java.nio.ByteBuffer	nioBuffer(int index, int length)	Deprecated. Exposes this buffer's sub-region as an NIO ByteBuffer.
int	nioBufferCount()	Deprecated. Returns the maximum number of NIO ByteBuffers that consist this buffer.
java.nio.ByteBuffer[]	nioBuffers(int index, int length)	Deprecated. 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()	Deprecated.
ByteBuf	setByte(int index, int value)	Deprecated. Sets the specified byte at the specified absolute index in this buffer.
ByteBuf	setBytes(int index, byte[] src, int srcIndex, int length)	Deprecated. 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)	Deprecated. 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)	Deprecated. Transfers the content of the specified source stream to this buffer starting at the specified absolute index.
ByteBuf	setBytes(int index, java.nio.ByteBuffer src)	Deprecated. 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.
int	setBytes(int index, java.nio.channels.FileChannel in, long position, int length)	Deprecated. Transfers the content of the specified source channel starting at the given file position to this buffer starting at the specified absolute index.
int	setBytes(int index, java.nio.channels.ScatteringByteChannel in, int length)	Deprecated. Transfers the content of the specified source channel to this buffer starting at the specified absolute index.
ByteBuf	setInt(int index, int value)	Deprecated. Sets the specified 32-bit integer at the specified absolute index in this buffer.
ByteBuf	setIntLE(int index, int value)	Deprecated. Sets the specified 32-bit integer at the specified absolute index in this buffer with Little Endian byte order .
ByteBuf	setLong(int index, long value)	Deprecated. Sets the specified 64-bit long integer at the specified absolute index in this buffer.
ByteBuf	setLongLE(int index, long value)	Deprecated. Sets the specified 64-bit long integer at the specified absolute index in this buffer in Little Endian Byte Order.
ByteBuf	setMedium(int index, int value)	Deprecated. Sets the specified 24-bit medium integer at the specified absolute index in this buffer.
ByteBuf	setMediumLE(int index, int value)	Deprecated. Sets the specified 24-bit medium integer at the specified absolute index in this buffer in the Little Endian Byte Order.
ByteBuf	setShort(int index, int value)	Deprecated. Sets the specified 16-bit short integer at the specified absolute index in this buffer.
ByteBuf	setShortLE(int index, int value)	Deprecated. Sets the specified 16-bit short integer at the specified absolute index in this buffer with the Little Endian Byte Order.
ByteBuf	slice(int index, int length)	Deprecated. Returns a slice of this buffer's sub-region.
ByteBuf	unwrap()	Deprecated. Return the underlying buffer instance if this buffer is a wrapper of another buffer.

Methods inherited from class io.netty.buffer.AbstractDerivedByteBuf

internalNioBuffer, isContiguous, refCnt, release, release, retain, retain, touch, touch

Methods inherited from class io.netty.buffer.AbstractByteBuf

adjustMarkers, bytesBefore, bytesBefore, bytesBefore, checkDstIndex, checkDstIndex, checkIndex, checkIndex, checkNewCapacity, checkReadableBytes, checkSrcIndex, clear, compareTo, copy, discardSomeReadBytes, ensureAccessible, equals, forEachByte, forEachByteDesc, getBoolean, getBytes, getBytes, getBytes, getChar, getCharSequence, getDouble, getFloat, getMedium, getMediumLE, getUnsignedByte, getUnsignedInt, getUnsignedIntLE, getUnsignedShort, getUnsignedShortLE, hashCode, indexOf, isReadable, isReadable, markReaderIndex, markWriterIndex, maxCapacity, maxCapacity, maxWritableBytes, newSwappedByteBuf, nioBuffer, nioBuffers, order, readableBytes, readBoolean, readByte, readBytes, readBytes, readBytes, readBytes, readBytes, 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, setZero, skipBytes, 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, writeZero

Methods inherited from class io.netty.buffer.ByteBuf

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ReadOnlyByteBuf

public ReadOnlyByteBuf(ByteBuf buffer)

Deprecated.

Method Detail

isReadOnly

public boolean isReadOnly()

Deprecated.

Description copied from class: ByteBuf

Returns true if and only if this buffer is read-only.

Overrides:

isReadOnly in class AbstractDerivedByteBuf

isWritable

public boolean isWritable()

Deprecated.

Description copied from class: ByteBuf

Returns true if and only if (this.capacity - this.writerIndex) is greater than 0.

Overrides:

isWritable in class AbstractByteBuf

isWritable

public boolean isWritable(int numBytes)

Deprecated.

Description copied from class: ByteBuf

Returns true if and only if this buffer has enough room to allow writing the specified number of elements.

Overrides:

isWritable in class AbstractByteBuf

ensureWritable

public int ensureWritable(int minWritableBytes,
                          boolean force)

Deprecated.

Description copied from class: ByteBuf

Expands the buffer ByteBuf.capacity() to make sure the number of writable bytes is equal to or greater than the specified value. Unlike ByteBuf.ensureWritable(int), this method returns a status code.

Overrides:

ensureWritable in class AbstractByteBuf

Parameters:

minWritableBytes - the expected minimum number of writable bytes

force - When ByteBuf.writerIndex() + minWritableBytes > ByteBuf.maxCapacity():

• true - the capacity of the buffer is expanded to ByteBuf.maxCapacity()
• false - the capacity of the buffer is unchanged

Returns:

0 if the buffer has enough writable bytes, and its capacity is unchanged. 1 if the buffer does not have enough bytes, and its capacity is unchanged. 2 if the buffer has enough writable bytes, and its capacity has been increased. 3 if the buffer does not have enough bytes, but its capacity has been increased to its maximum.

ensureWritable

public ByteBuf ensureWritable(int minWritableBytes)

Deprecated.

Description copied from class: ByteBuf

Expands the buffer ByteBuf.capacity() to make sure the number of writable bytes is equal to or greater than the specified value. If there are enough writable bytes in this buffer, this method returns with no side effect.

Overrides:

ensureWritable in class AbstractByteBuf

Parameters:

minWritableBytes - the expected minimum number of writable bytes

See Also:

ByteBuf.capacity(int)

unwrap

public ByteBuf unwrap()

Deprecated.

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

alloc

public ByteBufAllocator alloc()

Deprecated.

Description copied from class: ByteBuf

Returns the ByteBufAllocator which created this buffer.

Specified by:

alloc in class ByteBuf

order

@Deprecated
public java.nio.ByteOrder order()

Deprecated.

Description copied from class: ByteBuf

Returns the endianness of this buffer.

Specified by:

order in class ByteBuf

isDirect

public boolean isDirect()

Deprecated.

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

hasArray

public boolean hasArray()

Deprecated.

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()

Deprecated.

Description copied from class: ByteBuf

Returns the backing byte array of this buffer.

Specified by:

array in class ByteBuf

arrayOffset

public int arrayOffset()

Deprecated.

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()

Deprecated.

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()

Deprecated.

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

discardReadBytes

public ByteBuf discardReadBytes()

Deprecated.

Description copied from class: ByteBuf

Discards the bytes between the 0th index and readerIndex. It moves the bytes between readerIndex and writerIndex to the 0th index, and sets readerIndex and writerIndex to 0 and oldWriterIndex - oldReaderIndex respectively.

Please refer to the class documentation for more detailed explanation.

Overrides:

discardReadBytes in class AbstractByteBuf

setBytes

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

Deprecated.

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)

Deprecated.

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)

Deprecated.

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

setByte

public ByteBuf setByte(int index,
                       int value)

Deprecated.

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 AbstractByteBuf

_setByte

protected void _setByte(int index,
                        int value)

Deprecated.

Specified by:

_setByte in class AbstractByteBuf

setShort

public ByteBuf setShort(int index,
                        int value)

Deprecated.

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 AbstractByteBuf

_setShort

protected void _setShort(int index,
                         int value)

Deprecated.

Specified by:

_setShort in class AbstractByteBuf

setShortLE

public ByteBuf setShortLE(int index,
                          int value)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

setShortLE in class AbstractByteBuf

_setShortLE

protected void _setShortLE(int index,
                           int value)

Deprecated.

Specified by:

_setShortLE in class AbstractByteBuf

setMedium

public ByteBuf setMedium(int index,
                         int value)

Deprecated.

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 AbstractByteBuf

_setMedium

protected void _setMedium(int index,
                          int value)

Deprecated.

Specified by:

_setMedium in class AbstractByteBuf

setMediumLE

public ByteBuf setMediumLE(int index,
                           int value)

Deprecated.

Description copied from class: ByteBuf

Sets the specified 24-bit medium integer at the specified absolute index in this buffer in the Little Endian Byte Order. 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:

setMediumLE in class AbstractByteBuf

_setMediumLE

protected void _setMediumLE(int index,
                            int value)

Deprecated.

Specified by:

_setMediumLE in class AbstractByteBuf

setInt

public ByteBuf setInt(int index,
                      int value)

Deprecated.

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 AbstractByteBuf

_setInt

protected void _setInt(int index,
                       int value)

Deprecated.

Specified by:

_setInt in class AbstractByteBuf

setIntLE

public ByteBuf setIntLE(int index,
                        int value)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

setIntLE in class AbstractByteBuf

_setIntLE

protected void _setIntLE(int index,
                         int value)

Deprecated.

Specified by:

_setIntLE in class AbstractByteBuf

setLong

public ByteBuf setLong(int index,
                       long value)

Deprecated.

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 AbstractByteBuf

_setLong

protected void _setLong(int index,
                        long value)

Deprecated.

Specified by:

_setLong in class AbstractByteBuf

setLongLE

public ByteBuf setLongLE(int index,
                         long value)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

setLongLE in class AbstractByteBuf

_setLongLE

protected void _setLongLE(int index,
                          long value)

Deprecated.

Specified by:

_setLongLE in class AbstractByteBuf

setBytes

public int setBytes(int index,
                    java.io.InputStream in,
                    int length)

Deprecated.

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 InputStream reached EOF.

setBytes

public int setBytes(int index,
                    java.nio.channels.ScatteringByteChannel in,
                    int length)

Deprecated.

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 or reached EOF.

setBytes

public int setBytes(int index,
                    java.nio.channels.FileChannel in,
                    long position,
                    int length)

Deprecated.

Description copied from class: ByteBuf

Transfers the content of the specified source channel starting at the given file position to this buffer starting at the specified absolute index. This method does not modify readerIndex or writerIndex of this buffer. This method does not modify the channel's position.

Specified by:

setBytes in class ByteBuf

position - the file position at which the transfer is to begin

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 or reached EOF.

getBytes

public int getBytes(int index,
                    java.nio.channels.GatheringByteChannel out,
                    int length)
             throws java.io.IOException

Deprecated.

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

getBytes

public int getBytes(int index,
                    java.nio.channels.FileChannel out,
                    long position,
                    int length)
             throws java.io.IOException

Deprecated.

Description copied from class: ByteBuf

Transfers this buffer's data starting at the specified absolute index to the specified channel starting at the given file position. This method does not modify readerIndex or writerIndex of this buffer. This method does not modify the channel's position.

Specified by:

getBytes in class ByteBuf

position - the file position at which the transfer is to begin

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

getBytes

public ByteBuf getBytes(int index,
                        java.io.OutputStream out,
                        int length)
                 throws java.io.IOException

Deprecated.

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 ByteBuf getBytes(int index,
                        byte[] dst,
                        int dstIndex,
                        int length)

Deprecated.

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,
                        ByteBuf dst,
                        int dstIndex,
                        int length)

Deprecated.

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,
                        java.nio.ByteBuffer dst)

Deprecated.

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

duplicate

public ByteBuf duplicate()

Deprecated.

Description copied from class: ByteBuf

Returns a buffer which shares the whole region of this buffer. Modifying the content of the returned buffer or this buffer affects each other's content while they maintain separate indexes and marks. This method does not modify readerIndex or writerIndex of this buffer.

The reader and writer marks will not be duplicated. Also be aware that this method will NOT call ByteBuf.retain() and so the reference count will NOT be increased.

Overrides:

duplicate in class AbstractByteBuf

Returns:

A buffer whose readable content is equivalent to the buffer returned by ByteBuf.slice(). However this buffer will share the capacity of the underlying buffer, and therefore allows access to all of the underlying content if necessary.

copy

public ByteBuf copy(int index,
                    int length)

Deprecated.

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

slice

public ByteBuf slice(int index,
                     int length)

Deprecated.

Description copied from class: ByteBuf

Returns a slice of this buffer's sub-region. Modifying the content of the returned buffer or this buffer affects each other's content while they maintain separate indexes and marks. This method does not modify readerIndex or writerIndex of this buffer.

Also be aware that this method will NOT call ByteBuf.retain() and so the reference count will NOT be increased.

Overrides:

slice in class AbstractByteBuf

getByte

public byte getByte(int index)

Deprecated.

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 AbstractByteBuf

_getByte

protected byte _getByte(int index)

Deprecated.

Specified by:

_getByte in class AbstractByteBuf

getShort

public short getShort(int index)

Deprecated.

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 AbstractByteBuf

_getShort

protected short _getShort(int index)

Deprecated.

Specified by:

_getShort in class AbstractByteBuf

getShortLE

public short getShortLE(int index)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

getShortLE in class AbstractByteBuf

_getShortLE

protected short _getShortLE(int index)

Deprecated.

Specified by:

_getShortLE in class AbstractByteBuf

getUnsignedMedium

public int getUnsignedMedium(int index)

Deprecated.

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 AbstractByteBuf

_getUnsignedMedium

protected int _getUnsignedMedium(int index)

Deprecated.

Specified by:

_getUnsignedMedium in class AbstractByteBuf

getUnsignedMediumLE

public int getUnsignedMediumLE(int index)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

getUnsignedMediumLE in class AbstractByteBuf

_getUnsignedMediumLE

protected int _getUnsignedMediumLE(int index)

Deprecated.

Specified by:

_getUnsignedMediumLE in class AbstractByteBuf

getInt

public int getInt(int index)

Deprecated.

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 AbstractByteBuf

_getInt

protected int _getInt(int index)

Deprecated.

Specified by:

_getInt in class AbstractByteBuf

getIntLE

public int getIntLE(int index)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

getIntLE in class AbstractByteBuf

_getIntLE

protected int _getIntLE(int index)

Deprecated.

Specified by:

_getIntLE in class AbstractByteBuf

getLong

public long getLong(int index)

Deprecated.

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 AbstractByteBuf

_getLong

protected long _getLong(int index)

Deprecated.

Specified by:

_getLong in class AbstractByteBuf

getLongLE

public long getLongLE(int index)

Deprecated.

Description copied from class: ByteBuf

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

Overrides:

getLongLE in class AbstractByteBuf

_getLongLE

protected long _getLongLE(int index)

Deprecated.

Specified by:

_getLongLE in class AbstractByteBuf

nioBufferCount

public int nioBufferCount()

Deprecated.

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)

nioBuffer

public java.nio.ByteBuffer nioBuffer(int index,
                                     int length)

Deprecated.

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.

Overrides:

nioBuffer in class AbstractDerivedByteBuf

See Also:

ByteBuf.nioBufferCount(), ByteBuf.nioBuffers(), ByteBuf.nioBuffers(int, int)

nioBuffers

public java.nio.ByteBuffer[] nioBuffers(int index,
                                        int length)

Deprecated.

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)

forEachByte

public int forEachByte(int index,
                       int length,
                       ByteProcessor processor)

Deprecated.

Description copied from class: ByteBuf

Iterates over the specified area of this buffer with the specified processor in ascending order. (i.e. index, (index + 1), .. (index + length - 1))

Overrides:

forEachByte in class AbstractByteBuf

Returns:

-1 if the processor iterated to or beyond the end of the specified area. The last-visited index If the ByteProcessor.process(byte) returned false.

forEachByteDesc

public int forEachByteDesc(int index,
                           int length,
                           ByteProcessor processor)

Deprecated.

Description copied from class: ByteBuf

Iterates over the specified area of this buffer with the specified processor in descending order. (i.e. (index + length - 1), (index + length - 2), ... index)

Overrides:

forEachByteDesc in class AbstractByteBuf

Returns:

-1 if the processor iterated to or beyond the beginning of the specified area. The last-visited index If the ByteProcessor.process(byte) returned false.

capacity

public int capacity()

Deprecated.

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)

Deprecated.

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

asReadOnly

public ByteBuf asReadOnly()

Deprecated.

Description copied from class: ByteBuf

Returns a read-only version of this buffer.

Overrides:

asReadOnly in class AbstractByteBuf