- 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()
-
-
-
方法详细信息
-
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错误。
-
-