pushbackinputstream 是 java 中支持字节回退的装饰器流，通过内部 pushback 缓冲区实现预读与重用，适用于词法分析、协议解析等场景，需合理规划缓冲区容量并注意 unread 限制。
PushbackInputStream 是 Java 中用于“回退”已读字节的装饰器流，适用于需要预读（peek）或解析时临时消耗字节但后续又需重用的场景，比如词法分析、协议解析等。它本身不提供新功能，而是包装一个底层输入流，并维护一个内部缓冲区（pushback buffer），把“退回”的字节暂存其中，下次 read() 会优先从该缓冲区返回。
核心机制：缓冲区 + 预读控制
PushbackInputStream 内部使用一个固定大小的字节数组作为 pushback 缓冲区，默认容量为 1 字节（可通过构造函数指定更大值）。调用 unread(int b) 或 unread(byte[] b) 时，字节被压入缓冲区前端；后续 read() 会先检查缓冲区是否有数据，有则返回并移除，否则才委托给底层流。
- 缓冲区满时调用
unread()会抛出IOException，所以务必确保容量足够或及时判断剩余空间 - 不能退回未真正读取过的字节（比如直接 unread 任意值），只能退回刚从本流中读出的字节
- 不支持标记（mark/reset），与
BufferedInputStream的 mark 不同
基本用法示例：简单预读判断
假设要读取一个整数，但不确定下一个字符是否是数字（可能以空格或换行开头），可先 peek 一个字节再决定处理逻辑：
InputStream in = new ByteArrayInputStream(" 42".getBytes());
PushbackInputStream pbIn = new PushbackInputStream(in, 1); // 容量 1
int b = pbIn.read(); // 读到空格 ' '
if (Character.isWhitespace(b)) {
pbIn.unread(b); // 退回空格，让后续解析器统一处理空白
}
// 后续代码可安全调用 read()，空格会被再次读到
实用技巧与注意事项
-
容量规划：若需预读多个字节（如识别 "HTTP/1.1"），构造时指定足够容量，例如
new PushbackInputStream(in, 10) -
避免 unread 失败：使用前可用
available()判断缓冲区是否还有空位（注意：它返回的是缓冲区剩余容量，不是底层流可读字节数） -
配合 read(byte[], int, int)：可一次性 unread 多个字节，顺序为数组逆序压入（即
b[2]先被读出，b[0]最后） - 资源管理：和普通流一样，需在 try-with-resources 中关闭，它会自动关闭底层流
典型适用场景
- 手写简易 JSON/XML 解析器中跳过空白、识别起始符号（
{、[、"） - HTTP 响应头解析时，读取状态行后根据状态码决定是否继续读 body
- 自定义文本协议中实现 “if next byte is X, do Y else do Z” 的分支逻辑
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
