Java IO流怎么使用 PushbackInputStream 实现带有预读和回退功能的字节流读取-java教程-PHP中文网

pushbackinputstream 是 java io 中提供预读和回退能力的装饰器流，通过内置缓冲区暂存字节，支持 unread() 将已读字节推回，适用于词法分析、协议解析等需“试探性读取”的场景。

java io流怎么使用 pushbackinputstream 实现带有预读和回退功能的字节流读取

PushbackInputStream 是 Java IO 中一个装饰器流（Decorator），它包装一个已有的 InputStream，并提供“预读（peek）”和“回退（unread）”能力——即可以先读一个或多个字节看看内容，再决定是否真正消费；如果发现不该读，就把它“推回去”，后续读取仍会拿到它。

核心作用与适用场景

它不改变底层流的行为，只在内存中维护一个小型缓冲区（默认 1 字节，可指定更大容量），用于暂存被 unread() 的字节。典型用途包括：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

词法分析器（Lexer）中判断下一个 token 类型（比如看到 '-' 后需看下一位是否是 '-' 或 '='）
解析自定义协议时跳过 BOM、识别文件头（如 PNG 的 89 50 4E 47）后还原字节继续处理
实现带条件分支的流解析逻辑，避免因“读过了不能撤回”而破坏流状态

基本用法：单字节预读与回退

最常用的是 read() + unread(int) 组合。注意：只能回退之前刚读过的字节，且不能超过缓冲区大小。

InputStream in = new FileInputStream("data.bin");
PushbackInputStream pbIn = new PushbackInputStream(in, 2); // 缓冲区设为2字节

int b1 = pbIn.read(); // 读第一个字节
if (b1 == '-') {
    int b2 = pbIn.read(); // 预读第二个
    if (b2 == '-') {
        System.out.println("遇到 '--' 注释开始");
        // 不需要消耗 b2，把它推回去，留给后续统一处理
        pbIn.unread(b2);
    } else if (b2 == '=') {
        System.out.println("遇到 '-=' 赋值操作");
        pbIn.unread(b2); // 同样推回，保持语义清晰
    }
}
// 此时 b1 已消费，b2 若被 unread，则下次 read() 会先返回它

多字节回退与缓冲区限制

构造时指定的缓冲区大小决定了最多能 unread 多少字节。调用 unread(byte[]) 或 unread(byte[], int, int) 可一次推回多个字节，但总长度不能超过缓冲区容量，否则抛 IOException。

缓冲区满时再调用 unread() 会触发异常
回退的字节按“后推先读”顺序返回（栈式行为）
例如：缓冲区大小为 3，执行 unread(new byte[]{1,2,3})，后续三次 read() 将依次返回 3、2、1

实际使用注意事项

始终检查 read() 返回值是否为 -1（流末尾），避免对空流调用 unread()
不要在 unread() 后又对同一位置重复 unread()，易覆盖或越界
若需更灵活的预读（如任意位置标记/重置），应考虑 BufferedInputStream.mark()/reset()，但注意它依赖底层支持且有 mark limit 限制
用完记得 close()，它会自动关闭被包装的底层流