模块 java.base
包 java.io

类 FileDescriptor

java.lang.Object
java.io.FileDescriptor
public final class FileDescriptor extends Object
文件描述符类的实例用作底层机器特定结构的不透明句柄，表示打开的文件、打开的套接字或另一个字节源或字节汇。文件描述符的主要实际用途是创建一个 FileInputStream 或 FileOutputStream 来包含它。

应用程序不应创建自己的文件描述符。

自从：
1.0

  • 字段详细信息

    • in

      public static final FileDescriptor  in
      标准输入流的句柄。通常，不直接使用此文件描述符，而是通过称为 System.in 的输入流使用。
      参见：

    • out

      public static final FileDescriptor  out
      标准输出流的句柄。通常，不直接使用此文件描述符，而是通过称为 System.out 的输出流使用。
      参见：

    • err

      public static final FileDescriptor  err
      标准错误流的句柄。通常，不直接使用此文件描述符，而是通过称为 System.err 的输出流使用。
      参见：

  • 构造方法详细信息

    • FileDescriptor

      public FileDescriptor()
      构造一个（无效的）FileDescriptor 对象。 fd 或 handle 稍后设置。

  • 方法详情

    • valid

      public boolean valid()
      测试此文件描述符对象是否有效。
      返回：
      true 如果文件描述符对象表示一个有效的、打开的文件、套接字或其他活动的 I/O 连接； false否则。

    • sync

      public void sync() throws SyncFailedException
      强制所有系统缓冲区与底层设备同步。此 FileDescriptor 的所有修改数据和属性都已写入相关设备后，此方法返回。特别是，如果此 FileDescriptor 引用物理存储介质，例如文件系统中的文件，则同步将不会返回，直到与此 FileDescriptor 关联的缓冲区的所有内存中修改副本都已写入物理介质。 sync 旨在供需要物理存储（例如文件）处于已知状态的代码使用 例如，提供简单事务设施的类可能使用 sync 来确保由给定的交易记录在存储介质上。 sync 仅影响此 FileDescriptor 下游的缓冲区。如果应用程序正在执行任何内存中缓冲（例如，通过 BufferedOutputStream 对象），则必须先将这些缓冲区刷新到 FileDescriptor 中（例如，通过调用 OutputStream.flush），然后数据才会受到同步的影响。
      抛出：
      SyncFailedException - 当缓冲区无法刷新时抛出，或者因为系统不能保证所有缓冲区都已与物理媒体同步。
      自从：
      1.1