鸿蒙OS FileOutputStream

FileOutputStream

java.lang.Object

|—java.io.OutputStream

|—|—java.io.FileOutputStream

public class FileOutputStream
extends OutputStream

文件输出流是用于将数据写入 File 或 FileDescriptor 的输出流。 文件是否可用或是否可以创建取决于底层平台。 特别是某些平台，一次只允许一个 FileOutputStream（或其他文件写入对象）打开一个文件进行写入。 在这种情况下，如果所涉及的文件已经打开，则此类中的构造函数将失败。

FileOutputStream 用于写入原始字节流，例如图像数据。 要写入字符流，请考虑使用 FileWriter。

Since:

JDK1.0

构造函数摘要

方法总结

构造函数详细信息

FileOutputStream

public FileOutputStream(String name) throws FileNotFoundException

创建文件输出流以写入具有指定名称的文件。 创建一个新的 FileDescriptor 对象来表示此文件连接。

首先，如果有一个安全管理器，它的 checkWrite 方法会以名称作为参数被调用。

如果文件存在但是是目录而不是常规文件，不存在但无法创建，或者由于任何其他原因无法打开，则抛出 FileNotFoundException。

参数：

Throws:

FileOutputStream

public FileOutputStream(String name, boolean append) throws FileNotFoundException

创建文件输出流以写入具有指定名称的文件。 如果第二个参数为 true，那么字节将被写入文件的末尾而不是开头。 创建一个新的 FileDescriptor 对象来表示此文件连接。

首先，如果有一个安全管理器，它的 checkWrite 方法会以名称作为参数被调用。

如果文件存在但是是目录而不是常规文件，不存在但无法创建，或者由于任何其他原因无法打开，则抛出 FileNotFoundException。

参数：

Throws:

Since:

JDK1.1

FileOutputStream

public FileOutputStream(File file) throws FileNotFoundException

创建一个文件输出流以写入由指定 File 对象表示的文件。 创建一个新的 FileDescriptor 对象来表示此文件连接。

首先，如果有安全管理器，则调用它的 checkWrite 方法，并将文件参数表示的路径作为其参数。

如果文件存在但是是目录而不是常规文件，不存在但无法创建，或者由于任何其他原因无法打开，则抛出 FileNotFoundException。

参数：

Throws:

FileOutputStream

public FileOutputStream(File file, boolean append) throws FileNotFoundException

创建一个文件输出流以写入由指定 File 对象表示的文件。 如果第二个参数为 true，那么字节将被写入文件的末尾而不是开头。 创建一个新的 FileDescriptor 对象来表示此文件连接。

首先，如果有安全管理器，则调用它的 checkWrite 方法，并将文件参数表示的路径作为其参数。

如果文件存在但是是目录而不是常规文件，不存在但无法创建，或者由于任何其他原因无法打开，则抛出 FileNotFoundException。

参数：

Throws:

Since:

1.4

FileOutputStream

public FileOutputStream(FileDescriptor fdObj)

创建一个文件输出流以写入指定的文件描述符，它表示与文件系统中实际文件的现有连接。

首先，如果有一个安全管理器，它的 checkWrite 方法被调用，文件描述符 fdObj 参数作为它的参数。

如果 fdObj 为 null，则抛出 NullPointerException。

如果 fdObj 无效，此构造函数不会引发异常。 但是，如果在结果流上调用方法以尝试对流进行 I/O，则会引发 IOException。

参数：

Throws:

方法详情

write

public void write(int b) throws IOException

将指定字节写入此文件输出流。 实现OutputStream的write方法。

指定者：

写在类 OutputStream

参数：

Throws:

write

public void write(byte[] b) throws IOException

将指定字节数组中的 b.length 个字节写入此文件输出流。

覆盖：

写在类 OutputStream

参数：

Throws:

write

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

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

覆盖：

写在类 OutputStream

参数：

Throws:

close

public void close() throws IOException

关闭此文件输出流并释放与此流关联的所有系统资源。 此文件输出流可能不再用于写入字节。

如果此流具有关联的通道，则该通道也将关闭。

指定者：

在接口 AutoCloseable 中关闭

指定者：

在接口Closeable中关闭

覆盖：

在类 OutputStream 中关闭

Throws:

getFD

public final FileDescriptor getFD() throws IOException

返回与此流关联的文件描述符。

返回:

FileDescriptor 对象，表示此 FileOutputStream 对象正在使用的文件系统中的文件的连接。

Throws:

getChannel

public FileChannel getChannel()

返回与此文件输出流关联的唯一 FileChannel 对象。

返回通道的初始位置将等于到目前为止写入文件的字节数，除非此流处于附加模式，在这种情况下它将等于文件的大小。 将字节写入此流将相应地增加通道的位置。 显式或通过写入更改通道的位置将更改此流的文件位置。

返回:

与此文件输出流关联的文件通道

Since:

1.4

finalize

protected void finalize() throws IOException

清理与文件的连接，并确保在不再引用此流时调用此文件输出流的 close 方法。

覆盖：

在类 Object 中完成

Throws: