BufferedOutputStream

java.lang.Object

|---java.io.OutputStream

|---|---java.io.FilterOutputStream

|---|---|---java.io.BufferedOutputStream

public class BufferedOutputStream
extends FilterOutputStream

该类实现了一个缓冲的输出流。 通过设置这样的输出流，应用程序可以将字节写入底层输出流，而不必为每个写入的字节调用底层系统。

Since:

JDK1.0

字段摘要

修饰符和类型	字段	描述
protected byte[]	buf	存储数据的内部缓冲区。
protected int	count	缓冲区中的有效字节数。

从类 java.io.FilterOutputStream 继承的字段
out

构造函数摘要

构造函数	描述
BufferedOutputStream(OutputStream out)	创建一个新的缓冲输出流以将数据写入指定的基础输出流。
BufferedOutputStream(OutputStream out, int size)	创建一个新的缓冲输出流，以将数据写入具有指定缓冲区大小的指定基础输出流。

方法总结

修饰符和类型	方法	描述
void	flush()	刷新此缓冲输出流。
void	write(byte[] b, int off, int len)	从偏移量 off 开始的指定字节数组中写入 len 个字节到此缓冲输出流。
void	write(int b)	将指定字节写入此缓冲输出流。

从类 java.io.FilterOutputStream 继承的方法
close, write

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

buf

protected byte[] buf

存储数据的内部缓冲区。

count

protected int count

缓冲区中的有效字节数。 该值始终在 0 到 buf.length 的范围内； 元素 buf[0] 到 buf[count-1] 包含有效的字节数据。

构造函数详细信息

BufferedOutputStream

public BufferedOutputStream(OutputStream out)

创建一个新的缓冲输出流以将数据写入指定的基础输出流。

参数：

参数名称	参数描述
out	底层输出流。

BufferedOutputStream

public BufferedOutputStream(OutputStream out, int size)

创建一个新的缓冲输出流，以将数据写入具有指定缓冲区大小的指定基础输出流。

参数：

参数名称	参数描述
out	底层输出流。
size	缓冲区大小。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果 size <= 0.

方法详情

write

public void write(int b) throws IOException

将指定字节写入此缓冲输出流。

覆盖：

写在类 FilterOutputStream

参数：

参数名称	参数描述
b	要写入的字节。

Throws:

Throw名称	Throw描述
IOException	如果发生 I/O 错误。

write

public void write(byte[] b, int off, int len) throws IOException

从偏移量 off 开始的指定字节数组中写入 len 个字节到此缓冲输出流。

通常，此方法将给定数组中的字节存储到此流的缓冲区中，并根据需要将缓冲区刷新到底层输出流。 但是，如果请求的长度至少与此流的缓冲区一样大，则此方法将刷新缓冲区并将字节直接写入底层输出流。 因此冗余的 BufferedOutputStreams 不会不必要地复制数据。

覆盖：

写在类 FilterOutputStream

参数：

参数名称	参数描述
b	数据。
off	数据中的起始偏移量。
len	要写入的字节数。

Throws:

Throw名称	Throw描述
IOException	如果发生 I/O 错误。

flush

public void flush() throws IOException

刷新此缓冲输出流。 这会强制将任何缓冲的输出字节写出到底层输出流。

指定者：

在接口 Flushable 中刷新

覆盖：

类 FilterOutputStream 中的刷新

Throws:

Throw名称	Throw描述
IOException	如果发生 I/O 错误。