java中的字节缓冲区ByteBuffer

新缓冲区的内容将从此缓冲区的当前位置开始。此缓冲区内容的更改在新缓冲区中是可见的，反之亦然；这两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的位置将为零，其容量和界限将为此缓冲区中所剩余的字节数量，其标记是不确定的。当且仅当此缓冲区为直接时，新缓冲区才是直接的，当且仅当此缓冲区为只读时，新缓冲区才是只读的。  

新缓冲区的内容将为此缓冲区的内容。此缓冲区内容的更改在新缓冲区中是可见的，反之亦然；这两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的容量、界限、位置和标记值将与此缓冲区相同。当且仅当此缓冲区为直接时，新缓冲区才是直接的，当且仅当此缓冲区为只读时，新缓冲区才是只读的。

新缓冲区的内容将为此缓冲区的内容。此缓冲区内容的更改在新缓冲区中是可见的，但新缓冲区将是只读的并且不允许修改共享内容。两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的容量、界限、位置和标记值将与此缓冲区相同。

如果此缓冲区本身是只读的，则此方法与 duplicate 方法完全相同。

参数：index - 将从中读取该字节的索引

返回：给定索引处的字节

抛出： IndexOutOfBoundsException - 如果index 为负或不小于缓冲区界限

11、public abstract ByteBuffer put(int index,byte b) 绝对 put 方法（可选操作）。 将给定字节写入此缓冲区的给定索引处。 

参数：index - 将在该位置写入字节的索引

b - 要写入的字节值 

返回：此缓冲区 

抛出：IndexOutOfBoundsException - 如果index 为负或不小于缓冲区界限 

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

12、publicByteBufferget(byte[] dst, int offset,int length)

判断是否可通过一个可访问的 byte 数组实现此缓冲区。

如果此方法返回 true，则可以安全地调用 array 和arrayOffset 方法。

指定者：

类 Buffer 中的hasArray

返回：

当且仅当存在实现此缓冲区的数组，并且此缓冲区不是只读缓冲区时，返回 true

返回实现此缓冲区的 byte 数组（可选操作）。

此缓冲区的内容修改将导致返回的数组内容修改，反之亦然。

调用此方法之前要调用 hasArray 方法，以确保此缓冲区具有可访问的底层实现数组。

指定者：

类 Buffer 中的array

返回：

实现此缓冲区的数组

抛出：

ReadOnlyBufferException - 如果存在实现此缓冲区的数组，但缓冲区是只读的

UnsupportedOperationException - 如果不存在某个可访问的数组实现此缓冲区

返回此缓冲区中的第一个元素在缓冲区的底层实现数组中的偏移量（可选操作）。

如果存在实现此缓冲区的数组，则缓冲区位置 p 对应于数组索引 p + arrayOffset()。

调用此方法之前要调用 hasArray 方法，以确保此缓冲区具有可访问的底层实现数组。

指定者：

类 Buffer 中的arrayOffset

返回：

此缓冲区的第一个元素在缓冲区数组中的偏移量

抛出：

ReadOnlyBufferException - 如果存在实现此缓冲区的数组，但缓冲区是只读的

UnsupportedOperationException - 如果不存在某个可访问的数组实现此缓冲区

压缩此缓冲区（可选操作）。

将缓冲区的当前位置和界限之间的字节（如果有）复制到缓冲区的开始处。即将索引 p = position() 处的字节复制到索引 0 处，将索引p + 1 处的字节复制到索引 1 处，依此类推，直到将索引limit() - 1 处的字节复制到索引 n = limit() - 1 - p 处。然后将缓冲区的位置设置为n+1，并将其界限设置为其容量。如果已定义了标记，则丢弃它。

将缓冲区的位置设置为复制的字节数，而不是零，以便调用此方法后可以紧接着调用另一个相对 put 方法。

从缓冲区写入数据之后调用此方法，以防写入不完整。例如，以下循环语句通过 buf 缓冲区将字节从一个信道复制到另一个信道：

 buf.clear();          // Prepare buffer for use
  while (in.read(buf) >= 0 || buf.position != 0) {
     buf.flip();
     out.write(buf);
     buf.compact();    // In case of partial write
 }

返回：

此缓冲区

抛出：

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

判断此字节缓冲区是否为直接的。

指定者：

类 Buffer 中的isDirect

返回：

当且仅当此缓冲区为直接时，返回 true

返回汇总了此缓冲区状态的字符串。

覆盖：

类 Object 中的toString

返回：

一个汇总字符串

将此缓冲区与另一个缓冲区进行比较。

比较两个字节缓冲区的方法是按字典顺序比较它们的剩余元素序列，而不考虑每个序列在其对应缓冲区中的起始位置。

字节缓冲区不能与任何其他类型的对象进行比较。

指定者：

接口 Comparable<ByteBuffer> 中的compareTo

参数：

that - 要比较的对象。

返回：

当此缓冲区小于、等于或大于给定缓冲区时，返回负整数、零或正整数

用来写入 char 值的相对 put 方法（可选操作）。

将两个包含指定 char 值的字节按照当前的字节顺序写入到此缓冲区的当前位置，然后将该位置增加 2。

参数：

value - 要写入的 char 值

返回：

此缓冲区

抛出：

BufferOverflowException - 如果此缓冲区中的剩余字节数少于 2

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

参数：

index - 将从该位置读取字节的索引

返回：

给定索引处的 char 值

抛出：

IndexOutOfBoundsException - 如果index 为负数，或者不小于该缓冲区的界限 - 1 所得的值

用于写入 char 值的绝对 put 方法（可选操作）。

将两个包含给定 char 值的字节按照当前的字节顺序写入到此缓冲区的给定索引处。

参数：

index - 将在该位置写入字节的索引

value - 要写入的 char 值

返回：

此缓冲区

抛出：

IndexOutOfBoundsException - 如果index 为负数，或者不小于该缓冲区的界限 - 1 所得的值

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

用于读取 short 值的绝对 get 方法。

读取给定索引处的两个字节，根据当前的字节顺序将它们组成 short 值。

参数：

index - 将从该位置读取字节的索引

返回：

给定索引处的 short 值

抛出：

IndexOutOfBoundsException - 如果index 为负数，或者不小于该缓冲区的界限 - 1 所得的值

创建此字节缓冲区的视图，作为 short 缓冲区。

新缓冲区的内容将从此缓冲区的当前位置开始。此缓冲区内容的更改在新缓冲区中是可见的，反之亦然；这两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的位置将为零，其容量和界限将为此缓冲区中所剩余的字节数的二分之一，其标记是不确定的。当且仅当此缓冲区为直接时，新缓冲区才是直接的，当且仅当此缓冲区为只读时，新缓冲区才是只读的。

返回：

新的 short 缓冲区

用于读取 int 值的相对 get 方法。

读取此缓冲区的当前位置之后的 4 个字节，根据当前的字节顺序将它们组成 int 值，然后将该位置增加 4。

返回：

缓冲区当前位置的 int 值

抛出：

BufferUnderflowException - 如果此缓冲区中的剩余字节数少于 4

创建此字节缓冲区的视图，作为 int 缓冲区。

新缓冲区的内容将从此缓冲区的当前位置开始。此缓冲区内容的更改在新缓冲区中是可见的，反之亦然；这两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的位置将为零，其容量和界限将为此缓冲区中所剩余的字节数的四分之一，其标记是不确定的。当且仅当此缓冲区为直接时，新缓冲区才是直接的，当且仅当此缓冲区为只读时，新缓冲区才是只读的。

返回：

新的 int 缓冲区

用于读取 long 值的相对 get 方法。

读取此缓冲区的当前位置之后的 8 个字节，根据当前的字节顺序将它们组成 long 值，然后将该位置增加 8。

返回：

缓冲区当前位置的 long 值

抛出：

BufferUnderflowException - 如果此缓冲区中的剩余字节数少于 8

用于写入 long 值（可先操作） 的相对 put 方法。

将 8 个包含给定 long 值的字节按照当前的字节顺序写入到此缓冲区的当前位置，然后将该位置增加 8。

参数：

value - 要写入的 long 值

返回：

此缓冲区

抛出：

BufferOverflowException - 如果此缓冲区中的剩余字节数少于 8

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

用于读取 long 值的绝对 get 方法。

读取给定索引处的 8 个字节，根据当前的字节顺序将它们组成 long 值。

参数：

index - 将从该位置读取字节的索引

返回：

给定索引处的 long 值

抛出：

IndexOutOfBoundsException - 如果index 为负数，或者不小于该缓冲区的界限 - 7 所得的值

用于写入 long 值的绝对 put 方法（可选操作）。

将 8 个包含给定 long 值的字节按照当前的字节顺序写入到此缓冲区的给定索引处。

参数：

index - 将在该位置写入字节的索引

value - 要写入的 long 值

返回：

此缓冲区

抛出：

IndexOutOfBoundsException - 如果index 为负数，或者不小于该缓冲区的界限 - 7 所得的值

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

用于写入 float 值的相对 put 方法（可选操作）。

将 4 个包含给定 float 值的字节按照当前的字节顺序写入到此缓冲区的当前位置，然后然后将该位置增加 4。

参数：

value - 要写入的 float 值

返回：

此缓冲区

抛出：

BufferOverflowException - 如果此缓冲区中的剩余字节数少于 4

ReadOnlyBufferException - 如果此缓冲区是只读缓冲区

用于读取 double 值的相对 get 方法。

读取此缓冲区的当前位置之后的 8 个字节，根据当前的字节顺序将它们组成 double 值，然后将该位置增加 8。

返回：

缓冲区当前位置的 double 值

抛出：

BufferUnderflowException - 如果此缓冲区中的剩余字节数少于 8

创建此字节缓冲区的视图，作为 double 缓冲区。

新缓冲区的内容将从此缓冲区的当前位置开始。此缓冲区内容的更改在新缓冲区中是可见的，反之亦然；这两个缓冲区的位置、界限和标记值是相互独立的。

新缓冲区的位置将为零，其容量和界限将为此缓冲区中所剩余的字节数的八分之一，其标记是不确定的。当且仅当此缓冲区为直接时，新缓冲区才是直接的，当且仅当此缓冲区为只读时，新缓冲区才是只读的。

返回：

新的 double 缓冲区