方法详细信息

• capacity

  public final int capacity()

  返回此缓冲区的容量。

  结果

  这个缓冲区的容量

• position

  public final int position()

  返回此缓冲区的位置。

  结果

  这个缓冲区的位置

• position

  public Buffer position​(int newPosition)

  设置此缓冲区的位置。 如果标记已定义且大于新位置，则将其丢弃。

  参数

  newPosition - 新的头寸价值; 必须是非负的且不大于当前限制

  结果

  这个缓冲区

  异常

  IllegalArgumentException -如果前提 newPosition不成立

• limit

  public final int limit()

  返回此缓冲区的限制。

  结果

  这个缓冲区的限制

• limit

  public Buffer limit​(int newLimit)

  设置此缓冲区的限制。 如果该位置大于新限制，则将其设置为新限制。 如果标记已定义且大于新限制，则将其丢弃。

  参数

  newLimit - 新的限制值; 必须是非负的且不大于此缓冲区的容量

  结果

  这个缓冲区

  异常

  IllegalArgumentException -如果前提 newLimit不成立

• mark

  public Buffer mark()

  在此位置设置此缓冲区的标记。

  结果

  这个缓冲区

• reset

  public Buffer reset()

  将此缓冲区的位置重置为先前标记的位置。

  调用此方法既不会更改也不会丢弃标记的值。

  结果

  这个缓冲区

  异常

  InvalidMarkException - 如果尚未设置标记

• clear

  public Buffer clear()

  清除此缓冲区。 位置设置为零，限制设置为容量，标记将被丢弃。

  在使用一系列通道读取或放置操作来填充此缓冲区之前调用此方法。 例如：

   buf.clear();     // Prepare buffer for reading
   in.read(buf);    // Read data

  这种方法实际上并没有擦除缓冲区中的数据，但是它的命名就好像它一样，因为它最常用于那种情况。

  结果

  这个缓冲区

• flip

  public Buffer flip()

  翻转此缓冲区。 限制设置为当前位置，然后将位置设置为零。 如果定义了标记，则将其丢弃。

  在一系列通道读取或放置操作之后，调用此方法以准备一系列通道写入或相对获取操作。 例如：

   buf.put(magic);    // Prepend header
   in.read(buf);      // Read data into rest of buffer
   buf.flip();        // Flip buffer
   out.write(buf);    // Write header + data to channel

  将数据从一个地方传输到另一个地方时，此方法通常与compact方法结合使用。

  结果

  这个缓冲区

• rewind

  public Buffer rewind()

  倒回这个缓冲区。 位置设置为零，标记被丢弃。

  假设已经适当地设置了限制，在一系列通道写入或获取操作之前调用此方法。 例如：

   out.write(buf);    // Write remaining data
   buf.rewind();      // Rewind buffer
   buf.get(array);    // Copy data into array

  结果

  这个缓冲区

• remaining

  public final int remaining()

  返回当前位置和限制之间的元素数。

  结果

  此缓冲区中剩余的元素数

• hasRemaining

  public final boolean hasRemaining()

  告知当前位置和限制之间是否存在任何元素。

  结果

  true if且且仅当此缓冲区中至少有一个元素剩余时

• isReadOnly

  public abstract boolean isReadOnly()

  判断此缓冲区是否为只读。

  结果

  true当且仅当此缓冲区为只读时

• hasArray

  public abstract boolean hasArray()

  判断此缓冲区是否由可访问的数组支持。

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

  结果

  true当且仅当此缓冲区由数组支持且不是只读时

  从以下版本开始：

  1.6

• array

  public abstract Object array()

  返回支持此缓冲区的数组（可选操作） 。

  此方法旨在允许更高效地将阵列支持的缓冲区传递给本机代码。 具体子类为此方法提供更强类型的返回值。

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

  在调用此方法之前调用hasArray方法，以确保此缓冲区具有可访问的后备阵列。

  结果

  支持此缓冲区的数组

  异常

  ReadOnlyBufferException - 如果此缓冲区由数组支持但是只读

  UnsupportedOperationException - 如果此缓冲区未由可访问的数组支持

  从以下版本开始：

  1.6

• arrayOffset

  public abstract int arrayOffset()

  返回此缓冲区缓冲区第一个元素的后备数组中的偏移量（可选操作） 。

  如果此缓冲区由数组支持，则缓冲区位置p对应于数组索引p + arrayOffset() 。

  在调用此方法之前调用hasArray方法，以确保此缓冲区具有可访问的后备阵列。

  结果

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

  异常

  ReadOnlyBufferException - 如果此缓冲区由数组支持但是只读

  UnsupportedOperationException - 如果此缓冲区未由可访问的数组支持

  从以下版本开始：

  1.6

• isDirect

  public abstract boolean isDirect()

  判断此缓冲区是否为 direct 。

  结果

  true当且仅当此缓冲区是直接的

  从以下版本开始：

  1.6

• slice

  public abstract Buffer slice()

  创建一个新缓冲区，其内容是此缓冲区内容的共享子序列。

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

  新缓冲区的位置将为零，其容量和限制将是此缓冲区中剩余的元素数，其标记将是未定义的。 当且仅当此缓冲区是直接缓冲区时，新缓冲区将是直接的，并且当且仅当此缓冲区是只读时，它才是只读的。

  结果

  新的缓冲区

  从以下版本开始：

  9

• duplicate

  public abstract Buffer duplicate()

  创建一个共享此缓冲区内容的新缓冲区。

  新缓冲区的内容将是此缓冲区的内容。 对此缓冲区内容的更改将在新缓冲区中可见，反之亦然; 两个缓冲区的位置，限制和标记值将是独立的。

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

  结果

  新的缓冲区

  从以下版本开始：

  9