java类描述符,java.io 类 FileDescriptor - Java 中文参考手册

java.lang.Object

java.io.FileDescriptor

public final class FileDescriptorextends Object

文件描述符类的实例用作与基础机器有关的某种结构的不透明句柄，该结构表示开放文件、开放套接字或者字节的另一个源或接收者。文件描述符的主要实际用途是创建一个包含该结构的 FileInputStream 或 FileOutputStream。

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

从以下版本开始：

JDK1.0

另请参见：FileInputStream,

FileOutputStream

字段摘要

staticFileDescriptor

err

标准错误流的句柄。

staticFileDescriptor

in

标准输入流的句柄。

staticFileDescriptor

out

标准输出流的句柄。

构造方法摘要

FileDescriptor()

构造一个(无效的)FileDescriptor 对象。

方法摘要

void

sync()

强制所有系统缓冲区与基础设备同步。

boolean

valid()

测试此文件描述符对象是否有效。

从类 java.lang.Object 继承的方法

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

字段详细信息

in

public static final FileDescriptor in

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

另请参见：System.in

out

public static final FileDescriptor out

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

另请参见：System.out

err

public static final FileDescriptor err

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

另请参见：System.err

构造方法详细信息

FileDescriptor

public FileDescriptor()

构造一个(无效的)FileDescriptor 对象。

方法详细信息

valid

public boolean valid()

测试此文件描述符对象是否有效。

返回：如果文件描述符对象表示一个有效的、开放的文件、套接字或其他活动 I/O 连接，则返回 true；否则返回 false。

sync

public void sync()

throws SyncFailedException

强制所有系统缓冲区与基础设备同步。该方法在此 FileDescriptor 的所有修改数据和属性都写入相关设备后返回。特别是，如果此 FileDescriptor 引用物理存储介质，比如文件系统中的文件，则一直要等到将与此 FileDesecriptor 有关的缓冲区的所有内存中修改副本写入物理介质中，sync 方法才会返回。

sync 方法由要求物理存储(比例文件)处于某种已知状态下的代码使用。例如，提供简单事务处理设施的类可以使用 sync 来确保某个文件所有由给定事务造成的更改都记录在存储介质上。

sync 只影响此 FileDescriptor 的缓冲区下游。如果正通过应用程序(例如，通过一个 BufferedOutputStream 对象)实现内存缓冲，那么必须在数据受 sync 影响之前将这些缓冲区刷新，并转到 FileDescriptor 中(例如，通过调用 OutputStream.flush)。

抛出：SyncFailedException – 无法刷新缓冲区时抛出，或者在因为系统无法保证所有缓冲区都与物理介质同步时抛出。从以下版本开始：

JDK1.1