pushbackinputstream是java io中支持预读与回退的装饰器流,通过内部缓冲区实现unread操作,适用于词法分析等需前瞻判断的场景;默认缓冲区大小为1,可指定更大容量,但超限或嵌套回退会抛ioexception。

PushbackInputStream 是 Java IO 中专为“预读+回退”场景设计的装饰器流,它在底层输入流前加了一小块缓冲区,允许你把刚读取的字节“推回去”,下次读取时会优先返回这些被推回的字节。这在实现带前瞻判断的解析器(比如词法分析、协议解析)时非常实用。
核心原理:缓冲区 + peek + unread
它内部维护一个固定大小的字节数组(默认1),用作“回退槽”。调用 read() 时,先检查缓冲区是否有字节,有则返回并清空;没有才从底层流读。调用 unread(int b) 或 unread(byte[] b) 时,并不是真正写入底层流,而是把字节存进缓冲区(若缓冲区已满会抛 IOException)。关键点是:回退操作必须在 read() 之后、且未被其他 read 消耗前进行。
典型使用模式:先 peek 再决定逻辑分支
常见于需要根据下一个字节判断后续处理方式的场景,例如解析以特定字符开头的结构:
- 读一个字节,判断是不是 '{' —— 是则按 JSON 对象解析;
- 如果不是,但可能是数字或字母,需把该字节“还回去”,再交给通用 token 解析器处理;
- 此时 unread(b) 就让这个字节重新“可见”,后续 read() 会拿到它。
注意缓冲区容量和异常边界
默认缓冲区只支持回退 1 字节。如果需要多字节回退(如 peek 多个字符),必须显式指定更大容量构造:
new PushbackInputStream(in, 4); // 支持最多回退 4 字节但要注意:
- unread 超过缓冲区容量会抛 IOException;
- 不能 unread 已经被 unread 过的字节(即不支持嵌套回退);
- 底层流本身不可回退,PushbackInputStream 的回退能力完全依赖其内部缓冲区。
实际解析示例:简单配置行识别
假设解析文本配置,每行以 '#' 开头为注释,以 'key=value' 形式为配置项:
- 用 PushbackInputStream 读第一个字节;
- 如果是 '#',跳过整行;
- 否则 unread 它,再用 BufferedReader.readLine() 完整读取该行并解析 key/value;
- 这样避免了因读走第一个字节导致行内容错位。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











