CompositeChannelBuffer (Netty 3.10.5.Final API文档

java.lang.Object
- org.jboss.netty.buffer.AbstractChannelBuffer
- - org.jboss.netty.buffer.CompositeChannelBuffer

所有已实现的接口:

java.lang.Comparable<ChannelBuffer>, ChannelBuffer
```
public class CompositeChannelBuffer
extends AbstractChannelBuffer
```
A virtual buffer which shows multiple buffers as a single merged buffer. It is recommended to use ChannelBuffers.wrappedBuffer(ChannelBuffer...) instead of calling the constructor explicitly.

构造器概要

构造器
构造器和说明

CompositeChannelBuffer(java.nio.ByteOrder endianness, java.util.List<ChannelBuffer> buffers, boolean gathering)

构造器
构造器和说明
`CompositeChannelBuffer(java.nio.ByteOrder endianness, java.util.List<ChannelBuffer> buffers, boolean gathering)`

方法概要

方法
限定符和类型	方法和说明
`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.
`java.util.List<ChannelBuffer>`	`decompose(int index, int length)` Same with `slice(int, int)` except that this method returns a list.
`void`	`discardReadBytes()` Discards the bytes between the 0th index and `readerIndex`.
`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.
`ChannelBuffer`	`getBuffer(int index)` Returns the `ChannelBuffer` portion of this `CompositeChannelBuffer` that contains the specified `index`.
`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.
`int`	`numComponents()`
`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.
`java.nio.ByteBuffer[]`	`toByteBuffers(int index, int length)` Converts this buffer's sub-region into an array of NIO buffers.
`java.lang.String`	`toString()` Returns the string representation of this buffer.
`boolean`	`useGathering()` Return `true` if gathering writes / reads should be used for this `CompositeChannelBuffer`

从类继承的方法 org.jboss.netty.buffer.AbstractChannelBuffer
bytesBefore, bytesBefore, bytesBefore, bytesBefore, bytesBefore, bytesBefore, checkReadableBytes, clear, compareTo, copy, 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, 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

- 构造器详细资料
  - CompositeChannelBuffer
```
public CompositeChannelBuffer(java.nio.ByteOrder endianness,
                      java.util.List<ChannelBuffer> buffers,
                      boolean gathering)
```
- 方法详细资料
  - useGathering
```
public boolean useGathering()
```
    Return true if gathering writes / reads should be used for this CompositeChannelBuffer
  - decompose
```
public java.util.List<ChannelBuffer> decompose(int index,
                                      int length)
```
    Same with slice(int, int) except that this method returns a list.
  - factory
```
public ChannelBufferFactory factory()
```
    从接口复制的说明: ChannelBuffer
    
    Returns the factory which creates a ChannelBuffer whose type and default ByteOrder are same with this buffer.
  - order
```
public java.nio.ByteOrder order()
```
    从接口复制的说明: ChannelBuffer
    
    Returns the endianness of this buffer.
  - isDirect
```
public boolean isDirect()
```
    从接口复制的说明: ChannelBuffer
    
    Returns true if and only if this buffer is backed by an NIO direct buffer.
  - 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.
  - capacity
```
public int capacity()
```
    从接口复制的说明: ChannelBuffer
    
    Returns the number of bytes (octets) this buffer can contain.
  - numComponents
```
public int numComponents()
```
  - 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,
            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.
  - 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 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
  - 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
  - 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,
            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.
  - 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 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
  - 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.
  - getBuffer
```
public ChannelBuffer getBuffer(int index)
```
    Returns the ChannelBuffer portion of this CompositeChannelBuffer that contains the specified index. This is an expert method!
    Please note that since a CompositeChannelBuffer is made up of multiple ChannelBuffers, this does not return the full buffer. Instead, it only returns a portion of the composite buffer where the index is located
    
    参数:
    index - The index to search for and include in the returned ChannelBuffer
    
    返回:
    The ChannelBuffer that contains the specified index
    
    抛出:
    
    java.lang.IndexOutOfBoundsException - when the specified index is less than zero, or larger than capacity()
  - 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.
  - 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.
  - toByteBuffers
```
public java.nio.ByteBuffer[] toByteBuffers(int index,
                                  int length)
```
    从接口复制的说明: ChannelBuffer
    
    Converts this buffer's sub-region into an array of NIO buffers. The returned buffers 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.
    
    指定者:
    
    toByteBuffers 在接口中 ChannelBuffer
    
    覆盖:
    
    toByteBuffers 在类中 AbstractChannelBuffer
  - discardReadBytes
```
public void discardReadBytes()
```
    从接口复制的说明: ChannelBuffer
    
    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.
    
    指定者:
    
    discardReadBytes 在接口中 ChannelBuffer
    
    覆盖:
    
    discardReadBytes 在类中 AbstractChannelBuffer
  - toString
```
public java.lang.String toString()
```
    从接口复制的说明: ChannelBuffer
    
    Returns the string representation of this buffer. This method does not necessarily return the whole content of the buffer but returns the values of the key properties such as ChannelBuffer.readerIndex(), ChannelBuffer.writerIndex() and ChannelBuffer.capacity().
    
    指定者:
    
    toString 在接口中 ChannelBuffer
    
    覆盖:
    
    toString 在类中 AbstractChannelBuffer

类 CompositeChannelBuffer

构造器概要

方法概要

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

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

构造器详细资料

CompositeChannelBuffer

方法详细资料

useGathering

decompose

factory

order

isDirect

hasArray

array

arrayOffset

capacity

numComponents

getByte

getShort

getUnsignedMedium

getInt

getLong

getBytes

getBytes

getBytes

getBytes

getBytes

setByte

setShort

setMedium

setInt

setLong

setBytes

setBytes

setBytes

setBytes

setBytes

duplicate

copy

getBuffer

slice

toByteBuffer

toByteBuffers

discardReadBytes

toString