Module java.base

软件包 java.io

Class OutputStream

java.lang.Object

java.io.OutputStream

All Implemented Interfaces:

Closeable ， Flushable ， AutoCloseable

已知直接子类：

ByteArrayOutputStream ， FileOutputStream ， FilterOutputStream ， ObjectOutputStream ， OutputStream ， PipedOutputStream

public abstract class OutputStream
extends Object
implements Closeable, Flushable

这个抽象类是表示字节输出流的所有类的超类。 输出流接收输出字节并将其发送到某个接收器。

需要定义OutputStream子类的应用程序必须至少提供一个写入一个字节输出的方法。

从以下版本开始：

1.0

另请参见：

BufferedOutputStream ， ByteArrayOutputStream ， DataOutputStream ， FilterOutputStream ， InputStream ， write(int)

构造方法摘要

构造方法

Constructor	描述
OutputStream()

方法摘要

Modifier and Type	方法	描述
void	close()	关闭此输出流并释放与此流相关联的任何系统资源。
void	flush()	刷新此输出流并强制任何缓冲的输出字节被写出。
void	write(byte[] b)	将 b.length字节从指定的字节数组写入此输出流。
void	write(byte[] b, int off, int len)	从指定的字节数组写入 len字节，从偏移量 off开始输出到此输出流。
abstract void	write(int b)	将指定的字节写入此输出流。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

OutputStream

public OutputStream()

方法详细信息

write

public abstract void write(int b)
                    throws IOException

将指定的字节写入此输出流。 write的一般合同是将一个字节写入输出流。 要写入的字节是参数b的八个低位。 忽略了b的24个高位。

OutputStream子类必须为此方法提供一个实现。

参数

b - byte 。

异常

IOException - 如果发生I / O错误。 特别地，如果输出流已经关闭， IOException可能抛出IOException 。

write

public void write(byte[] b)
           throws IOException

将b.length字节从指定的字节数组写入此输出流。 write(b)的一般合同是它应该具有与电话write(b, 0, b.length)完全相同的效果。

参数

b - 数据。

异常

IOException - 如果发生I / O错误。

另请参见：

write(byte[], int, int)

write

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

从位于偏移off的指定字节数组写入len字节到此输出流。 write(b, off, len)的一般合同是阵列b中的一些字节按b写入输出流; 元素b[off]是写入的第一个字节， b[off+len-1]是此操作写入的最后一个字节。

该write的方法OutputStream调用写出在每个字节中的一个参数的写入方法。 鼓励子类覆盖此方法并提供更有效的实现。

如果b为null ，则抛出NullPointerException 。

如果off为负数，或len为负数，或off+len大于数组b的长度，则抛出IndexOutOfBoundsException 。

参数

b - 数据。

off - 数据中的起始偏移量。

len - 要写入的字节数。

异常

IOException - 如果发生I / O错误。 特别是，如果输出流关闭，则抛出IOException 。

flush

public void flush()
           throws IOException

刷新此输出流并强制任何缓冲的输出字节被写出。 flush的一般合同是指出，如果以前写入的字节已经通过实现输出流缓冲，则应立即将这些字节写入到其预定目的地。

如果此流的预期目标是由底层操作系统（例如文件）提供的抽象，那么刷新流仅保证先前写入流的字节传递到操作系统进行写入; 它并不保证它们实际上被写入物理设备，如磁盘驱动器。

flush方法OutputStream也没做。

Specified by:

flush在接口 Flushable

异常

IOException - 如果发生I / O错误。

close

public void close()
           throws IOException

关闭此输出流并释放与此流相关联的任何系统资源。 close的总合同是关闭输出流。 封闭流不能执行输出操作，无法重新打开。

该close的方法OutputStream什么都不做。

Specified by:

close在接口 AutoCloseable

Specified by:

close在接口 Closeable

异常

IOException - 如果发生I / O错误。