java nio 中,buffer 的 capacity 表示缓冲区能够容纳的数据元素的最大数量,这一属性在创建缓冲区时确定且不可更改。要设置或获取容量,需调用 capacity() 方法,但该方法仅用于读取当前容量,无法直接修改;若需改变容量,必须重新分配一个新的 buffer 实例。例如,通过 bytebuffer.allocate(1024) 可创建一个容量为 1024 字节的缓冲区,其初始位置、界限和标记均处于默认状态。

如何创建指定容量的 ByteBuffer
使用 ByteBuffer.allocate(int capacity) 静态方法可以创建一个具有指定容量的堆缓冲区。该方法的参数 capacity 即为缓冲区的总大小,单位为字节。创建后,可通过 capacity() 方法验证容量是否正确设置。此方法适用于大多数需要固定大小缓冲区的场景,如网络数据传输或文件读写。

import java.nio.ByteBuffer;
public class Main {
public static void main(String[] args) {
int desiredCapacity = 512;
ByteBuffer buffer = ByteBuffer.allocate(desiredCapacity);
System.out.println("Capacity: " + buffer.capacity());
System.out.println("Position: " + buffer.position());
System.out.println("Limit: " + buffer.limit());
}
}
运行上述代码将输出:
Capacity: 512
Position: 0
Limit: 512
如何检查并调整现有缓冲区的容量
由于 capacity() 是只读方法,无法直接修改已有缓冲区的容量。若需调整容量,应创建新缓冲区并将原数据复制过去。可使用 ByteBuffer.allocateNew(capacity)(Java 9+)或直接手动复制。以下示例展示如何将一个容量为 256 的缓冲区扩展至 1024,并保留原有数据。
立即学习“Java免费学习笔记(深入)”;

import java.nio.ByteBuffer;
public class Main {
public static void main(String[] args) {
ByteBuffer original = ByteBuffer.allocate(256);
original.put((byte) 'A');
original.flip(); // 准备读取
ByteBuffer expanded = ByteBuffer.allocate(1024);
original.rewind();
expanded.put(original);
System.out.println("Original Capacity: " + original.capacity());
System.out.println("Expanded Capacity: " + expanded.capacity());
}
}
该操作确保原数据不被丢失,同时获得更大容量的新缓冲区。注意:每次调整容量都涉及内存分配和数据拷贝,频繁操作可能影响性能。
当缓冲区已满时继续写入会发生什么
当缓冲区的位置等于限制(即 position() == limit())时,缓冲区被视为“满”。此时若尝试写入数据,将抛出 BufferOverflowException。为避免异常,应在写入前检查 remaining() 是否大于零,或调用 flip() 切换模式。例如,在写入前判断 buffer.remaining() > 0 可安全写入剩余空间。


















