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 オブジェクトによって) メモリ内部でのバッファリングを行なっている場合、これらのバッファを FileDescriptor へ (たとえば、OutputStream.flush を呼び出して) フラッシュさせて、データが sync の影響を受けないようにしなければなりません。

例外:

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

導入されたバージョン:

JDK1.1