JavaTM 2 Platform
Standard Ed. 5.0

java.io
类 FileDescriptor

java.lang.Object
  继承者 java.io.FileDescriptor

public final class FileDescriptor
extends Object

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

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

从以下版本开始:
JDK1.0
另请参见:
FileInputStream, FileOutputStream

字段摘要
static FileDescriptor err
          标准错误流的句柄。
static FileDescriptor in
          标准输入流的句柄。
static FileDescriptor 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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策