Unpooled (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.buffer.Unpooled

```
public final class Unpooled
extends java.lang.Object
```
通过分配新空间或通过包装或复制现有字节数组，字节缓冲区和字符串来创建新的ByteBuf 。
使用静态导入
此类旨在用于Java 5静态导入语句：
```
  import static io.netty.buffer.Unpooled.*;

 ByteBuf heapBuffer    = buffer(128);
 ByteBuf directBuffer  = directBuffer(256);
 ByteBuf wrappedBuffer = wrappedBuffer(new byte[128], new byte[256]);
 ByteBuf copiedBuffer  = copiedBuffer(ByteBuffer.allocate(128)); 
```
分配一个新的缓冲区
开箱即用提供三种缓冲类型。
- buffer(int)分配一个新的固定容量堆缓冲区。
- directBuffer(int)分配一个新的固定容量直接缓冲区。
创建一个包装缓冲区
包装缓冲区是一个缓冲区，它是一个或多个现有字节数组和字节缓冲区的视图。原始数组或缓冲区内容的任何更改都将在包装缓冲区中可见。提供了各种包装方法，其名称均为wrappedBuffer() 。如果要创建由多个数组组成的缓冲区以减少内存副本的数量，则可能需要仔细查看接受可变长度的方法。
创建复制的缓冲区
复制缓冲区是一个或多个现有字节数组，字节缓冲区或字符串的深层副本。与包装缓冲区不同，原始数据和复制缓冲区之间没有共享数据。提供了各种复制方法，其名称均为copiedBuffer() 。使用此操作将多个缓冲区合并到一个缓冲区也很方便。

Field Summary

Fields
Modifier and Type	Field and Description
`static java.nio.ByteOrder`	`BIG_ENDIAN` 大端字节顺序。
`static ByteBuf`	`EMPTY_BUFFER` 容量为 `0`缓冲区。
`static java.nio.ByteOrder`	`LITTLE_ENDIAN` 小端字节顺序。

方法摘要

所有方法静态方法具体的方法弃用的方法
Modifier and Type	Method and Description
`static ByteBuf`	`buffer()` 创建一个具有相当小的初始容量的新的大端Java堆缓冲区，可根据需要无限扩展其容量。
`static ByteBuf`	`buffer(int initialCapacity)` 使用指定的 `capacity`创建新的大端Java堆缓冲区，该缓冲区根据需要无限扩展其容量。
`static ByteBuf`	`buffer(int initialCapacity, int maxCapacity)` 用指定的 `initialCapacity`创建一个新的大端Java堆缓冲区，该缓冲区可能长达 `maxCapacity`新缓冲区的 `readerIndex`和 `writerIndex`是 `0` 。
`static CompositeByteBuf`	`compositeBuffer()` 返回没有组件的新的big-endian复合缓冲区。
`static CompositeByteBuf`	`compositeBuffer(int maxNumComponents)` 返回没有组件的新的big-endian复合缓冲区。
`static ByteBuf`	`copiedBuffer(byte[]... arrays)` 创建一个新的大端缓冲区，其内容是指定的 `arrays`的合并副本。
`static ByteBuf`	`copiedBuffer(byte[] array)` 创建一个新的大端缓冲区，其内容是指定的 `array`的副本。
`static ByteBuf`	`copiedBuffer(byte[] array, int offset, int length)` 创建一个新的大端缓冲区，其内容是指定的 `array`的子区域的副本。
`static ByteBuf`	`copiedBuffer(ByteBuf... buffers)` 创建一个新的缓冲区，其内容是指定的 `buffers`可读字节的合并副本。
`static ByteBuf`	`copiedBuffer(ByteBuf buffer)` 创建一个新的缓冲区，其内容是指定的 `buffer`可读字节的副本。
`static ByteBuf`	`copiedBuffer(java.nio.ByteBuffer... buffers)` 创建一个新的缓冲区，其内容是指定的 `buffers` '切片的合并副本。
`static ByteBuf`	`copiedBuffer(java.nio.ByteBuffer buffer)` 创建一个新的缓冲区，其内容是指定的 `buffer`的当前片的副本。
`static ByteBuf`	`copiedBuffer(char[] array, java.nio.charset.Charset charset)` 创建一个新的大端缓冲区，其内容是在指定的 `array`编码的指定 `charset` 。
`static ByteBuf`	`copiedBuffer(char[] array, int offset, int length, java.nio.charset.Charset charset)` 创建一个新的大端缓冲区，其内容是在指定的 `array`编码的指定 `charset` 。
`static ByteBuf`	`copiedBuffer(java.lang.CharSequence string, java.nio.charset.Charset charset)` 创建一个新的大端缓冲区，其内容是在指定的 `string`编码的指定 `charset` 。
`static ByteBuf`	`copiedBuffer(java.lang.CharSequence string, int offset, int length, java.nio.charset.Charset charset)` 创建一个新的大端缓冲区，其内容是在指定的 `string`编码的指定 `charset` 。
`static ByteBuf`	`copyBoolean(boolean... values)` 创建一个包含指定布尔值序列的新的大端缓冲区。
`static ByteBuf`	`copyBoolean(boolean value)` 创建一个包含指定布尔值的新的单字节大端缓冲区。
`static ByteBuf`	`copyDouble(double... values)` 创建一个新的大端缓冲区，它包含一系列指定的64位浮点数。
`static ByteBuf`	`copyDouble(double value)` 创建一个新的8字节大端缓冲区，该缓冲区保存指定的64位浮点数。
`static ByteBuf`	`copyFloat(float... values)` 创建一个新的大端缓冲区，其中包含一系列指定的32位浮点数。
`static ByteBuf`	`copyFloat(float value)` 创建一个新的4字节大端缓冲区，该缓冲区保存指定的32位浮点数。
`static ByteBuf`	`copyInt(int... values)` 创建一个包含指定32位整数序列的大端缓冲区。
`static ByteBuf`	`copyInt(int value)` 创建一个新的4字节大端缓冲区，其中包含指定的32位整数。
`static ByteBuf`	`copyLong(long... values)` 创建一个新的大端缓冲区，其中包含指定的64位整数序列。
`static ByteBuf`	`copyLong(long value)` 创建一个新的8字节大端缓冲区，该缓冲区保存指定的64位整数。
`static ByteBuf`	`copyMedium(int... values)` 创建一个新的大端缓冲区，其中包含指定的24位整数序列。
`static ByteBuf`	`copyMedium(int value)` 创建一个新的3字节的big-endian缓冲区，该缓冲区保存指定的24位整数。
`static ByteBuf`	`copyShort(int... values)` 创建一个新的大端缓冲区，其中包含指定的16位整数序列。
`static ByteBuf`	`copyShort(int value)` 创建一个新的2字节大端缓冲区，该缓冲区保存指定的16位整数。
`static ByteBuf`	`copyShort(short... values)` 创建一个新的大端缓冲区，其中包含指定的16位整数序列。
`static ByteBuf`	`directBuffer()` 以合理的小初始容量创建新的大端直接缓冲区，根据需要无限扩展其容量。
`static ByteBuf`	`directBuffer(int initialCapacity)` 使用指定的 `capacity`创建新的大端直接缓冲区，该缓冲区根据需要无限扩展其容量。
`static ByteBuf`	`directBuffer(int initialCapacity, int maxCapacity)` 用指定的 `initialCapacity`创建一个新的big-endian直接缓冲区，该缓冲区可能长达 `maxCapacity` 。
`static ByteBuf`	`unmodifiableBuffer(ByteBuf... buffers)` 将给定的`ByteBuf`包装在一个不可修改的`ByteBuf`中。
`static ByteBuf`	`unmodifiableBuffer(ByteBuf buffer)` 已过时。使用`ByteBuf.asReadOnly()` 。
`static ByteBuf`	`unreleasableBuffer(ByteBuf buf)` 在给定的`ByteBuf`上返回一个无法释放的视图，它将忽略释放并保留呼叫。
`static ByteBuf`	`wrappedBuffer(byte[]... arrays)` 创建一个新的大端组合缓冲区，它将指定的数组进行封装而不复制它们。
`static ByteBuf`	`wrappedBuffer(byte[] array)` 创建一个包含指定 `array`的新的大端缓冲区。
`static ByteBuf`	`wrappedBuffer(byte[] array, int offset, int length)` 创建一个新的大端缓冲区，它包装指定的 `array`的子区域。
`static ByteBuf`	`wrappedBuffer(ByteBuf... buffers)` 创建一个新的big-endian复合缓冲区，它包装指定缓冲区的可读字节而不复制它们。
`static ByteBuf`	`wrappedBuffer(ByteBuf buffer)` 创建一个包装指定缓冲区可读字节的新缓冲区。
`static ByteBuf`	`wrappedBuffer(java.nio.ByteBuffer... buffers)` 创建一个新的big-endian复合缓冲区，它包装指定的NIO缓冲区的片段而不复制它们。
`static ByteBuf`	`wrappedBuffer(java.nio.ByteBuffer buffer)` 创建一个包装指定的NIO缓冲区当前分片的新缓冲区。
`static ByteBuf`	`wrappedBuffer(int maxNumComponents, byte[]... arrays)` 创建一个新的大端组合缓冲区，它将指定的数组进行封装而不复制它们。
`static ByteBuf`	`wrappedBuffer(int maxNumComponents, ByteBuf... buffers)` 创建一个新的big-endian复合缓冲区，它包装指定缓冲区的可读字节而不复制它们。
`static ByteBuf`	`wrappedBuffer(int maxNumComponents, java.nio.ByteBuffer... buffers)` 创建一个新的big-endian复合缓冲区，它包装指定的NIO缓冲区的片段而不复制它们。
`static ByteBuf`	`wrappedBuffer(long memoryAddress, int size, boolean doFree)` 创建一个包装指定内存地址的新缓冲区。

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

- 字段详细信息
  - BIG_ENDIAN
```
public static final java.nio.ByteOrder BIG_ENDIAN
```
    大端字节顺序。
  - LITTLE_ENDIAN
```
public static final java.nio.ByteOrder LITTLE_ENDIAN
```
    小端字节顺序。
  - EMPTY_BUFFER
```
public static final ByteBuf EMPTY_BUFFER
```
    容量为 0缓冲区。
- 方法详细信息
  - buffer
```
public static ByteBuf buffer()
```
    创建一个具有相当小的初始容量的新的大端Java堆缓冲区，可根据需要无限扩展其容量。
  - directBuffer
```
public static ByteBuf directBuffer()
```
    以合理的小初始容量创建新的大端直接缓冲区，根据需要无限扩展其容量。
  - buffer
```
public static ByteBuf buffer(int initialCapacity)
```
    使用指定的capacity创建新的大端Java堆缓冲区，该缓冲区根据需要无限扩展其容量。新缓冲区的readerIndex和writerIndex是0 。
  - directBuffer
```
public static ByteBuf directBuffer(int initialCapacity)
```
    用指定的capacity创建一个新的big-endian直接缓冲区，它根据需要无限扩展其容量。新缓冲区的readerIndex和writerIndex是0 。
  - buffer
```
public static ByteBuf buffer(int initialCapacity,
                             int maxCapacity)
```
    用指定的 initialCapacity创建一个新的大端Java堆缓冲区，该缓冲区可能长达 maxCapacity新缓冲区的 readerIndex和 writerIndex是 0 。
  - directBuffer
```
public static ByteBuf directBuffer(int initialCapacity,
                                   int maxCapacity)
```
    用指定的initialCapacity创建一个新的big-endian直接缓冲区，该缓冲区可能长达maxCapacity 。新的缓冲区readerIndex和writerIndex是0 。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(byte[] array)
```
    创建一个包含指定array的新的大端缓冲区。对指定数组的内容的修改将对返回的缓冲区可见。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(byte[] array,
                                    int offset,
                                    int length)
```
    创建一个新的大端缓冲区，它包装指定的array的子区域。对指定数组的内容的修改将对返回的缓冲区可见。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(java.nio.ByteBuffer buffer)
```
    创建一个包装指定的NIO缓冲区当前分片的新缓冲区。对指定缓冲区内容的修改对于返回的缓冲区将是可见的。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(long memoryAddress,
                                    int size,
                                    boolean doFree)
```
    创建一个包装指定内存地址的新缓冲区。如果doFree为真，则一旦ByteBuf的引用计数达到0 ，memoryAddress将自动释放。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(ByteBuf buffer)
```
    创建一个包装指定缓冲区可读字节的新缓冲区。对指定缓冲区内容的修改对于返回的缓冲区将是可见的。
    
    参数
    
    buffer - 要包装的缓冲区。此变量的引用计数所有权转移到此方法。
    
    结果
    
    buffer的可读部分，如果没有可读部分，则为空缓冲区。调用者负责释放这个缓冲区。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(byte[]... arrays)
```
    创建一个新的大端组合缓冲区，它将指定的数组进行封装而不复制它们。对指定数组的内容的修改对于返回的缓冲区是可见的。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(ByteBuf... buffers)
```
    创建一个新的big-endian复合缓冲区，它包装指定缓冲区的可读字节而不复制它们。对指定缓冲区的内容的修改对于返回的缓冲区是可见的。
    
    参数
    
    buffers - 要包装的缓冲区。所有变量的引用计数所有权转移到此方法。
    
    结果
    
    buffers的可读部分。调用者负责释放这个缓冲区。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(java.nio.ByteBuffer... buffers)
```
    创建一个新的big-endian复合缓冲区，它包装指定的NIO缓冲区的片段而不复制它们。对指定缓冲区的内容的修改对于返回的缓冲区是可见的。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(int maxNumComponents,
                                    byte[]... arrays)
```
    创建一个新的大端组合缓冲区，它将指定的数组进行封装而不复制它们。对指定数组的内容的修改对于返回的缓冲区是可见的。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(int maxNumComponents,
                                    ByteBuf... buffers)
```
    创建一个新的big-endian复合缓冲区，它包装指定缓冲区的可读字节而不复制它们。对指定缓冲区的内容的修改对于返回的缓冲区是可见的。
    
    参数
    
    maxNumComponents - 关于在整合发生之前允许存在多少独立缓冲区的建议。
    
    buffers - 要包装的缓冲区。所有变量的引用计数所有权转移到此方法。
    
    结果
    
    buffers的可读部分。调用者负责释放这个缓冲区。
  - wrappedBuffer
```
public static ByteBuf wrappedBuffer(int maxNumComponents,
                                    java.nio.ByteBuffer... buffers)
```
    创建一个新的big-endian复合缓冲区，它包装指定的NIO缓冲区的片段而不复制它们。对指定缓冲区的内容的修改对于返回的缓冲区是可见的。
  - compositeBuffer
```
public static CompositeByteBuf compositeBuffer()
```
    返回没有组件的新的big-endian复合缓冲区。
  - compositeBuffer
```
public static CompositeByteBuf compositeBuffer(int maxNumComponents)
```
    返回没有组件的新的big-endian复合缓冲区。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(byte[] array)
```
    创建一个新的大端缓冲区，其内容是指定的array的副本。新缓冲区的readerIndex和writerIndex分别是0和array.length 。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(byte[] array,
                                   int offset,
                                   int length)
```
    创建一个新的big-endian缓冲区，其内容是指定的array的子区域的副本。新缓冲区的readerIndex和writerIndex分别为0和length 。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(java.nio.ByteBuffer buffer)
```
    创建一个新的缓冲区，其内容是指定的buffer当前分片的副本。新缓冲区的readerIndex和writerIndex分别是0和buffer.remaining 。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(ByteBuf buffer)
```
    创建一个新缓冲区，其内容是指定buffer的可读字节的副本。新缓冲区的readerIndex和writerIndex分别是0和buffer.readableBytes 。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(byte[]... arrays)
```
    创建一个新的大端缓冲区，其内容是指定的arrays的合并副本。新缓冲区的readerIndex和writerIndex分别是0和所有阵列的总和length 。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(ByteBuf... buffers)
```
    创建一个新的缓冲区，其内容是指定的buffers '可读字节的合并副本。新缓冲区的readerIndex和writerIndex分别是0和所有缓冲区的总和readableBytes 。
    
    异常
    
    java.lang.IllegalArgumentException - 如果指定缓冲区的字节序彼此不同
  - copiedBuffer
```
public static ByteBuf copiedBuffer(java.nio.ByteBuffer... buffers)
```
    创建一个新的缓冲区，其内容是指定的buffers '切片的合并副本。新缓冲区的readerIndex和writerIndex分别是0和所有缓冲区的总和remaining 。
    
    异常
    
    java.lang.IllegalArgumentException - 如果指定的缓冲区的字节序彼此不同
  - copiedBuffer
```
public static ByteBuf copiedBuffer(java.lang.CharSequence string,
                                   java.nio.charset.Charset charset)
```
    创建一个新的big-endian缓冲区，其内容是在指定的string编码的指定charset 。新缓冲区的readerIndex和writerIndex分别是0和编码字符串的长度。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(java.lang.CharSequence string,
                                   int offset,
                                   int length,
                                   java.nio.charset.Charset charset)
```
    创建一个新的big-endian缓冲区，其内容是在指定的string编码的指定charset 。新缓冲区的readerIndex和writerIndex分别是0和编码字符串的长度。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(char[] array,
                                   java.nio.charset.Charset charset)
```
    创建一个新的big-endian缓冲区，其内容是在指定的array编码的指定charset 。新缓冲区的readerIndex和writerIndex分别是0和编码字符串的长度。
  - copiedBuffer
```
public static ByteBuf copiedBuffer(char[] array,
                                   int offset,
                                   int length,
                                   java.nio.charset.Charset charset)
```
    创建一个新的big-endian缓冲区，其内容是在指定的array编码的指定charset 。新缓冲区的readerIndex和writerIndex分别是0和编码字符串的长度。
  - unmodifiableBuffer
```
@Deprecated
public static ByteBuf unmodifiableBuffer(ByteBuf buffer)
```
    已过时。使用ByteBuf.asReadOnly() 。
    
    创建只读缓冲区，禁止在指定的buffer上进行任何修改操作。新缓冲区具有相同readerIndex和writerIndex与指定的buffer 。
  - copyInt
```
public static ByteBuf copyInt(int value)
```
    创建一个新的4字节大端缓冲区，其中包含指定的32位整数。
  - copyInt
```
public static ByteBuf copyInt(int... values)
```
    创建一个包含指定32位整数序列的大端缓冲区。
  - copyShort
```
public static ByteBuf copyShort(int value)
```
    创建一个新的2字节大端缓冲区，该缓冲区保存指定的16位整数。
  - copyShort
```
public static ByteBuf copyShort(short... values)
```
    创建一个新的大端缓冲区，其中包含指定的16位整数序列。
  - copyShort
```
public static ByteBuf copyShort(int... values)
```
    创建一个新的大端缓冲区，其中包含指定的16位整数序列。
  - copyMedium
```
public static ByteBuf copyMedium(int value)
```
    创建一个新的3字节的big-endian缓冲区，该缓冲区保存指定的24位整数。
  - copyMedium
```
public static ByteBuf copyMedium(int... values)
```
    创建一个新的大端缓冲区，其中包含指定的24位整数序列。
  - copyLong
```
public static ByteBuf copyLong(long value)
```
    创建一个新的8字节大端缓冲区，该缓冲区保存指定的64位整数。
  - copyLong
```
public static ByteBuf copyLong(long... values)
```
    创建一个新的大端缓冲区，其中包含指定的64位整数序列。
  - copyBoolean
```
public static ByteBuf copyBoolean(boolean value)
```
    创建一个包含指定布尔值的新的单字节大端缓冲区。
  - copyBoolean
```
public static ByteBuf copyBoolean(boolean... values)
```
    创建一个包含指定布尔值序列的新的大端缓冲区。
  - copyFloat
```
public static ByteBuf copyFloat(float value)
```
    创建一个新的4字节大端缓冲区，该缓冲区保存指定的32位浮点数。
  - copyFloat
```
public static ByteBuf copyFloat(float... values)
```
    创建一个新的大端缓冲区，其中包含一系列指定的32位浮点数。
  - copyDouble
```
public static ByteBuf copyDouble(double value)
```
    创建一个新的8字节大端缓冲区，该缓冲区保存指定的64位浮点数。
  - copyDouble
```
public static ByteBuf copyDouble(double... values)
```
    创建一个新的大端缓冲区，它包含一系列指定的64位浮点数。
  - unreleasableBuffer
```
public static ByteBuf unreleasableBuffer(ByteBuf buf)
```
    在给定的ByteBuf上返回一个无法释放的视图，它将忽略释放并保留呼叫。
  - unmodifiableBuffer
```
public static ByteBuf unmodifiableBuffer(ByteBuf... buffers)
```
    将给定的ByteBuf包装成不可修改的ByteBuf 。请注意，返回的ByteBuf不会尝试分割给定的ByteBuf以降低GC压力。

Class Unpooled

使用静态导入

分配一个新的缓冲区

创建一个包装缓冲区

创建复制的缓冲区

Field Summary

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

BIG_ENDIAN

LITTLE_ENDIAN

EMPTY_BUFFER

方法详细信息

buffer

directBuffer

buffer

directBuffer

buffer

directBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

wrappedBuffer

compositeBuffer

compositeBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

copiedBuffer

unmodifiableBuffer

copyInt

copyInt

copyShort

copyShort

copyShort

copyMedium

copyMedium

copyLong

copyLong

copyBoolean

copyBoolean

copyFloat

copyFloat

copyDouble

copyDouble

unreleasableBuffer

unmodifiableBuffer