JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。