org.jboss.netty.buffer

类 ByteBufferBackedChannelBuffer

java.lang.Object

org.jboss.netty.buffer.AbstractChannelBuffer

org.jboss.netty.buffer.ByteBufferBackedChannelBuffer

所有已实现的接口:

java.lang.Comparable<ChannelBuffer>, ChannelBuffer

public class ByteBufferBackedChannelBuffer
extends AbstractChannelBuffer

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

构造器概要

构造器

构造器和说明
ByteBufferBackedChannelBuffer(java.nio.ByteBuffer buffer) Creates a new buffer which wraps the specified buffer's slice.

方法概要

方法

限定符和类型	方法和说明
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.
ChannelBuffer	copy(int index, int length) Returns a copy of this buffer's sub-region.
ChannelBuffer	duplicate() Returns a buffer which shares the whole region of this buffer.
ChannelBufferFactory	factory() Returns the factory which creates a ChannelBuffer whose type and default ByteOrder are same with this buffer.
byte	getByte(int index) Gets a byte at the specified absolute index in this buffer.
void	getBytes(int index, byte[] dst, int dstIndex, int length) Transfers this buffer's data to the specified destination starting at the specified absolute index.
void	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.
void	getBytes(int index, ChannelBuffer 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.
void	getBytes(int index, java.io.OutputStream out, int length) Transfers this buffer's data to the specified stream 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	hasArray() Returns true if and only if this buffer has a backing byte array.
boolean	isDirect() Returns true if and only if this buffer is backed by an NIO direct buffer.
java.nio.ByteOrder	order() Returns the endianness of this buffer.
void	setByte(int index, int value) Sets the specified byte at the specified absolute index in this buffer.
void	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.
void	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.
void	setBytes(int index, ChannelBuffer 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.
void	setInt(int index, int value) Sets the specified 32-bit integer at the specified absolute index in this buffer.
void	setLong(int index, long value) Sets the specified 64-bit long integer at the specified absolute index in this buffer.
void	setMedium(int index, int value) Sets the specified 24-bit medium integer at the specified absolute index in this buffer.
void	setShort(int index, int value) Sets the specified 16-bit short integer at the specified absolute index in this buffer.
ChannelBuffer	slice(int index, int length) Returns a slice of this buffer's sub-region.
java.nio.ByteBuffer	toByteBuffer(int index, int length) Converts this buffer's sub-region into a NIO buffer.

从类继承的方法 org.jboss.netty.buffer.AbstractChannelBuffer

bytesBefore, bytesBefore, bytesBefore, bytesBefore, bytesBefore, bytesBefore, checkReadableBytes, clear, compareTo, copy, discardReadBytes, ensureWritableBytes, equals, getBytes, getBytes, getBytes, getChar, getDouble, getFloat, getMedium, getUnsignedByte, getUnsignedInt, getUnsignedShort, hashCode, indexOf, indexOf, markReaderIndex, markWriterIndex, readable, readableBytes, readByte, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readBytes, readChar, readDouble, readerIndex, readerIndex, readFloat, readInt, readLong, readMedium, readShort, readSlice, readUnsignedByte, readUnsignedInt, readUnsignedMedium, readUnsignedShort, resetReaderIndex, resetWriterIndex, setBytes, setBytes, setBytes, setChar, setDouble, setFloat, setIndex, setZero, skipBytes, slice, toByteBuffer, toByteBuffers, toByteBuffers, toString, toString, toString, writable, writableBytes, writeByte, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeBytes, writeChar, writeDouble, writeFloat, writeInt, writeLong, writeMedium, writerIndex, writerIndex, writeShort, writeZero

从类继承的方法 java.lang.Object

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

构造器详细资料

ByteBufferBackedChannelBuffer

public ByteBufferBackedChannelBuffer(java.nio.ByteBuffer buffer)

Creates a new buffer which wraps the specified buffer's slice.

方法详细资料

factory

public ChannelBufferFactory factory()

从接口复制的说明: ChannelBuffer

Returns the factory which creates a ChannelBuffer whose type and default ByteOrder are same with this buffer.

isDirect

public boolean isDirect()

从接口复制的说明: ChannelBuffer

Returns true if and only if this buffer is backed by an NIO direct buffer.

order

public java.nio.ByteOrder order()

从接口复制的说明: ChannelBuffer

Returns the endianness of this buffer.

capacity

public int capacity()

从接口复制的说明: ChannelBuffer

Returns the number of bytes (octets) this buffer can contain.

hasArray

public boolean hasArray()

从接口复制的说明: ChannelBuffer

Returns true if and only if this buffer has a backing byte array. If this method returns true, you can safely call ChannelBuffer.array() and ChannelBuffer.arrayOffset().

array

public byte[] array()

从接口复制的说明: ChannelBuffer

Returns the backing byte array of this buffer.

arrayOffset

public int arrayOffset()

从接口复制的说明: ChannelBuffer

Returns the offset of the first byte within the backing byte array of this buffer.

getByte

public byte getByte(int index)

从接口复制的说明: ChannelBuffer

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

getShort

public short getShort(int index)

从接口复制的说明: ChannelBuffer

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.

getUnsignedMedium

public int getUnsignedMedium(int index)

从接口复制的说明: ChannelBuffer

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.

getInt

public int getInt(int index)

从接口复制的说明: ChannelBuffer

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

getLong

public long getLong(int index)

从接口复制的说明: ChannelBuffer

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.

getBytes

public void getBytes(int index,
            ChannelBuffer dst,
            int dstIndex,
            int length)

从接口复制的说明: ChannelBuffer

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.

dstIndex - the first index of the destination

length - the number of bytes to transfer

getBytes

public void getBytes(int index,
            byte[] dst,
            int dstIndex,
            int length)

从接口复制的说明: ChannelBuffer

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.

dstIndex - the first index of the destination

length - the number of bytes to transfer

getBytes

public void getBytes(int index,
            java.nio.ByteBuffer dst)

从接口复制的说明: ChannelBuffer

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.

setByte

public void setByte(int index,
           int value)

从接口复制的说明: ChannelBuffer

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.

setShort

public void setShort(int index,
            int value)

从接口复制的说明: ChannelBuffer

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.

setMedium

public void setMedium(int index,
             int value)

从接口复制的说明: ChannelBuffer

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.

setInt

public void setInt(int index,
          int value)

从接口复制的说明: ChannelBuffer

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.

setLong

public void setLong(int index,
           long value)

从接口复制的说明: ChannelBuffer

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.

setBytes

public void setBytes(int index,
            ChannelBuffer src,
            int srcIndex,
            int length)

从接口复制的说明: ChannelBuffer

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.

srcIndex - the first index of the source

length - the number of bytes to transfer

setBytes

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

从接口复制的说明: ChannelBuffer

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.

setBytes

public void setBytes(int index,
            java.nio.ByteBuffer src)

从接口复制的说明: ChannelBuffer

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.

getBytes

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

从接口复制的说明: ChannelBuffer

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.

length - the number of bytes to transfer

抛出:

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

从接口复制的说明: ChannelBuffer

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.

length - the maximum number of bytes to transfer

返回:

the actual number of bytes written out to the specified channel

抛出:

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

从接口复制的说明: ChannelBuffer

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.

length - the number of bytes to transfer

返回:

the actual number of bytes read in from the specified channel. -1 if the specified channel is closed.

抛出:

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

从接口复制的说明: ChannelBuffer

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.

length - the maximum number of bytes to transfer

返回:

the actual number of bytes read in from the specified channel. -1 if the specified channel is closed.

抛出:

java.io.IOException - if the specified channel threw an exception during I/O

toByteBuffer

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

从接口复制的说明: ChannelBuffer

Converts this buffer's sub-region into a NIO buffer. The returned buffer might or might not share the content with this buffer, while they have separate indexes and marks. This method does not modify readerIndex or writerIndex of this buffer.

slice

public ChannelBuffer slice(int index,
                  int length)

从接口复制的说明: ChannelBuffer

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.

duplicate

public ChannelBuffer duplicate()

从接口复制的说明: ChannelBuffer

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 is identical to buf.slice(0, buf.capacity()). This method does not modify readerIndex or writerIndex of this buffer.

copy

public ChannelBuffer copy(int index,
                 int length)

从接口复制的说明: ChannelBuffer

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.