bytebuffer 的 capacity 表示该缓冲区能够容纳的最大字节数,它是创建时确定的固定上限。理解它的关键在于区分它与 limit(当前可操作范围)和 position(当前位置)的关系:capacity 是物理边界,而 limit 是逻辑边界。只要 limit 不超过 capacity,你就可以通过修改 limit 来复用同一块内存空间。

如何验证 capacity 与 limit 的初始关系
在 Java NIO 中,新创建的 ByteBuffer 其 limit 默认等于 capacity。这意味着刚分配好的缓冲区,从位置 0 到末尾的所有空间都是可用的。我们可以通过一个简单的程序来观察这一初始状态,并确认 capacity 是不可变的属性。

import java.nio.ByteBuffer;
public class CapacityDemo {
public static void main(String[] args) {
// 创建一个容量为 10 的 ByteBuffer
ByteBuffer buffer = ByteBuffer.allocate(10);
// 获取初始状态
System.out.println("Capacity: " + buffer.capacity());
System.out.println("Position: " + buffer.position());
System.out.println("Limit: " + buffer.limit());
// 尝试修改 capacity 会抛出异常,证明其不可变性
try {
buffer.capacity(5);
} catch (Exception e) {
System.out.println("Cannot change capacity directly");
}
}
}
运行上述代码,预期输出如下:
- Capacity: 10
- Position: 0
- Limit: 10
- Cannot change capacity directly
这证实了 capacity 是固定的,且初始状态下 limit 与 capacity 一致。
如何通过 flip() 改变 limit 以复用 capacity
在实际读写操作中,我们通常不会直接使用整个 capacity。例如,写入数据后,需要切换到读取模式,此时 limit 会被设置为当前的 position,从而限制可读范围,但 capacity 保持不变。这种机制允许我们在不重新分配内存的情况下,高效地复用缓冲区。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

import java.nio.ByteBuffer;
public class FlipDemo {
public static void main(String[] args) {
ByteBuffer buffer = ByteBuffer.allocate(10);
// 写入前状态
System.out.println("Before write - Cap: " + buffer.capacity() + ", Lim: " + buffer.limit());
// 模拟写入 5 个字节
for (int i = 0; i < 5; i++) {
buffer.put((byte) i);
}
// 切换为读取模式
buffer.flip();
// 写入后/翻转后状态
System.out.println("After flip - Cap: " + buffer.capacity() + ", Lim: " + buffer.limit() + ", Pos: " + buffer.position());
// 读取 3 个字节
for (int i = 0; i < 3; i++) {
buffer.get();
}
// 再次切换回写入模式
buffer.compact();
System.out.println("After compact - Cap: " + buffer.capacity() + ", Lim: " + buffer.limit() + ", Pos: " + buffer.position());
}
}
运行结果分析:
- 初始时 Cap: 10, Lim: 10。
- 写入 5 字节后,position 变为 5。flip() 后,limit 变为 5,position 归零,capacity 仍为 10。
- 读取 3 字节后,position 变为 3。
- compact() 将未读数据移至开头,position 设为剩余空间起始处,limit 恢复为 capacity(即 10),capacity 依然保持 10 不变。
当 position 超过 limit 时会发生什么
如果在 flip() 之后继续调用 get() 直到 position 等于 limit,再尝试读取就会抛出 BufferUnderflowException。这是因为 limit 限制了有效数据的边界,而 capacity 只是底层数组的大小,并不参与运行时访问检查。理解这一点有助于避免常见的越界错误。

















