java.io
クラス FileDescriptor
java.lang.Object
|
+--java.io.FileDescriptor
- public final class FileDescriptor
- extends Object
ファイル記述子クラスのインスタンスは、開いたファイル、開いたソケット、またはバイトの別のソース (シンク) を表す、基となるマシン固有の構造への不透明なハンドルとして機能します。ファイル記述子の主な用途は、それを格納する FileInputStream
または FileOutputStream
を作成することです。
アプリケーションは独自のファイル記述子を作成してはなりません。
- 導入されたバージョン:
- JDK1.0
- 関連項目:
FileInputStream
,
FileOutputStream
,
java.net.SocketInputStream
,
java.net.SocketOutputStream
メソッドの概要 |
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()
- ファイル記述子オブジェクトが有効かどうかを判定します。
- 戻り値:
- ファイル記述子オブジェクトが有効な開いたファイル、ソケット、またはその他のアクティブな入出力接続を表す場合は
true
、そうでない場合は false
sync
public void sync()
throws SyncFailedException
- 強制的にすべてのバッファに基礎デバイスとの同期を取らせます。このメソッドは、FileDescriptor の修正されたデータと属性値が該当するデバイスに書き込まれてから終了します。 特に、FileDescriptor がファイルシステムのファイルのような物理記憶メディアに関するものであるときには、sysnc はこの FileDesecriptor に関連するバッファのメモリ内部での変更事項がすべて物理メディアに書き込まれるまでは復帰しません。
sync は、物理記憶(たとえばファイル)の状態を完全に把握する必要のあるコードの中で使用されるものです。たとえば、伝票操作機能を提供するクラスでは、ある取り引きの結果生じたファイルの変更を確実に記憶メディア側に保存させるために使用します。
sync が影響を与えるのは FileDescriptor のバッファのダウンストリームのみです。 アプリケーションが(たとえば、BufferedOutputStream によって)メモリ内部でのバッファリングを行なっている場合、これらのバッファを FileDescriptor へ(たとえば、OutputStream.flush を呼び出して)フラッシュさせて、データが sync の影響を受けないようにしなければなりません。
- 例外:
- SyncFailedException - バッファがフラッシュできない場合、またはすべてのバッファと物理メディアとの同期をシステムが保証できない場合
- 導入されたバージョン:
- JDK1.1
バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.