当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
java.io
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
FileDescriptor (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
java.io
类 FileDescriptor
java.lang.Objectjava.io.FileDescriptor
public final class FileDescriptor
- extends Object
文件描述符类的实例用作与基础机器有关的某种结构的不透明句柄，该结构表示开放文件、开放套接字或者字节的另一个源或接收者。文件描述符的主要实际用途是创建一个包含该结构的 FileInputStream 或 FileOutputStream。
应用程序不应创建自己的文件描述符。
- 从以下版本开始：
- 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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。