java.io

クラス FileDescriptor

java.lang.Object

java.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()

ファイル記述子オブジェクトが有効かどうかを判定します。

戻り値:

ファイル記述子オブジェクトが有効な開いたファイル、ソケット、またはその他のアクティブな入出力接続を表す場合は true、そうでない場合は false。

sync

public void sync()
          throws SyncFailedException

強制的にすべてのシステムバッファーとベースとなるデバイスとの同期を取ります。このメソッドは、この FileDescriptor の修正されたデータと属性が該当のデバイスにすべて書き込まれてから復帰します。特に、FileDescriptor がファイルシステムのファイルのような物理記憶メディアを参照する場合、sync はこの FileDescriptor に関連するバッファーのメモリー内部での変更事項がすべて物理メディアに書き込まれるまでは復帰しません。 sync は、物理記憶 (たとえばファイル) の状態を完全に把握する必要のあるコードの中で使用されるものです。たとえば、伝票操作機能を提供するクラスでは、ある取り引きの結果生じたファイルの変更を確実に記憶メディア側に保存させるために使用します。 sync が影響を与えるのは、この FileDescriptor のバッファーのダウンストリームのみです。BufferedOutputStream オブジェクトなどによってアプリケーションがメモリー内部でのバッファリングを行なっている場合、たとえば OutputStream.flush を呼び出すことによって、これらのバッファーを FileDescriptor へフラッシュし、データが sync の影響を受けないようにしなければいけません。

例外:

SyncFailedException - バッファーがフラッシュできない場合、またはすべてのバッファーと物理メディアとの同期をシステムが保証できない場合。

導入されたバージョン:

JDK1.1