モジュール java.base

パッケージ java.io

クラスFileDescriptor

java.lang.Object

java.io.FileDescriptor

public final class FileDescriptor extends Object

ファイル記述子クラスのインスタンスは、開いたファイル、開いたソケット、またはバイトの別のソース(シンク)を表す、ベースとなるマシン固有の構造への不透明なハンドルとして機能します。 ファイル記述子の主な実用的な使い方は、それを含むFileInputStreamまたはFileOutputStreamを作成することです。

アプリケーションは独自のファイル記述子を作成してはなりません。

導入されたバージョン:

1.0

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final FileDescriptor	err	標準エラー・ストリームへのハンドルです。
static final FileDescriptor	in	標準入力ストリームへのハンドルです。
static final 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オブジェクトを構築します。 Fdまたはハンドルは後で設定します。

メソッドの詳細

valid

public boolean valid()

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

戻り値:

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

sync

public void sync() throws SyncFailedException

強制的にすべてのシステム・バッファとベースとなるデバイスとの同期を取ります。 このメソッドは、このFileDescriptorの修正されたデータと属性が該当のデバイスにすべて書き込まれてから復帰します。 特に、このFileDescriptorがファイル・システムのファイルのような物理記憶メディアを参照する場合、syncはこのFileDescriptorに関連付けられたバッファのメモリー内部での変更事項がすべて物理メディアに書き込まれるまでは復帰しません。syncは、物理ストレージ(ファイルなど)が既知の状態にある必要があるコードによって使用されることを想定しています。たとえば、単純なトランザクション機能を提供するクラスの場合、指定されたトランザクションによって発生したファイルに対するすべての変更が記憶メディアに記録されるようにsyncを使用できます。syncが影響を与えるのは、このFileDescriptorのバッファ・ダウンストリームのみです。 BufferedOutputStreamオブジェクトなどによってアプリケーションがメモリー内部でのバッファリングを行っている場合、たとえばOutputStream.flushを呼び出すことによって、これらのバッファをFileDescriptorへフラッシュし、データがsyncの影響を受けないようにしなければいけません。

例外:

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

導入されたバージョン:

1.1