java.io
類別 FileDescriptor

java.lang.Object
  java.io.FileDescriptor

public final class FileDescriptor
extends Object

檔案描述符類別的實例用作與基礎機器有關的某種結構的不透明句柄，該結構表示開放檔案、開放Socket或者位元組的另一個源或接收者。檔案描述符的主要實際用途是創建一個套件含該結構的 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()

測試此檔案描述符物件是否有效。

返回：

如果檔案描述符物件表示一個有效的、開放的檔案、Socket或其他活動 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