Java中如何判断OutputStream是否可继续写入？

核心前提 #

Java标准OutputStream没有类似InputStream返回-1的内置机制来标识"无法继续写入"，它的设计逻辑是：成功写入则无返回值，写入失败（包括缓冲区满、底层设备不可用等）则抛出IOException。

针对"有限缓冲区/字节数组"场景的实现 #

如果你的需求是向固定容量的缓冲区/字节数组写入数据，且调用API仅接受OutputStream参数，可以通过自定义OutputStream子类来实现"缓冲区满时告知调用方"的逻辑，最标准的方式是在缓冲区耗尽时抛出异常（符合OutputStream的契约）。

示例代码：带容量限制的ByteArrayOutputStream

import java.io.ByteArrayOutputStream;
import java.io.IOException;

public class BoundedByteArrayOutputStream extends ByteArrayOutputStream {
    private final int maxCapacity;

    public BoundedByteArrayOutputStream(int maxCapacity) {
        this.maxCapacity = maxCapacity;
    }

    @Override
    public void write(int b) throws IOException {
        if (count + 1 > maxCapacity) {
            throw new IOException("缓冲区已写满，最大容量：" + maxCapacity);
        }
        super.write(b);
    }

    @Override
    public void write(byte[] b, int off, int len) throws IOException {
        if (count + len > maxCapacity) {
            throw new IOException("缓冲区剩余空间不足，无法写入指定长度的数据");
        }
        super.write(b, off, len);
    }

    // 可选：提供主动检查是否已满的方法
    public boolean isFull() {
        return count >= maxCapacity;
    }
}

调用逻辑

将这个自定义流传入目标API，当API尝试写入超出缓冲区容量的数据时，会触发IOException，调用方捕获该异常即可判断写入已终止：

try {
    BoundedByteArrayOutputStream boundedStream = new BoundedByteArrayOutputStream(1024);
    // 传入需要调用的API，比如someApi.writeData(boundedStream);
    someApi.writeData(boundedStream);
} catch (IOException e) {
    // 处理缓冲区满的情况
    System.out.println("写入终止：" + e.getMessage());
}

补充说明 #

• 不推荐仅通过自定义标记位（比如isFull()）来告知调用方，因为绝大多数通用API不会主动调用这类自定义方法，无法及时感知缓冲区已满。
• 抛出IOException是符合Java IO设计规范的方式，调用方通常已经具备处理IO异常的逻辑，无需额外修改太多代码。

内容的提问来源于stack exchange，提问作者FredSuvn