|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object
|
+--java.io.InputStream
|
+--java.io.FileInputStream
ファイルシステムのファイルから入力バイトを取得します。どのファイルが有効かはホスト環境に依存します。
FileInputStream は、生のバイト (イメージデータなど) のストリームを読み込むときに使用します。文字のストリームを読み込むときは、FileReader を使用してください。
File,
FileDescriptor,
FileOutputStream| コンストラクタの概要 | |
FileInputStream(File file)
ファイルシステムの実際のファイル ( File オブジェクト file により指定) に接続することにより、FileInputStream を作成します。 |
|
FileInputStream(FileDescriptor fdObj)
ファイルシステムの実際のファイルへの既存の接続を表すファイル記述子 fdObj を使用して、FileInputStream を作成します。
|
|
FileInputStream(String name)
ファイルシステムの実際のファイル (パス名 name により指定) に接続することにより、FileInputStream を作成します。 |
|
| メソッドの概要 | |
int |
available()
ブロックせずにファイル入力ストリームから読み込むことができるバイト数を返します。 |
void |
close()
ファイル入力ストリームを閉じ、このストリームに関連するシステムリソースを解放します。 |
protected void |
finalize()
ファイル入力ストリームへの参照が存在しなくなったときに、このストリームの close メソッドが確実に呼び出されるようにします。 |
FileChannel |
getChannel()
このファイル入力ストリームに関連付けられた、一意の FileChannel オブジェクトを返します。
|
FileDescriptor |
getFD()
この FileInputStream に使用されているファイルシステムの実際のファイルへの接続を表す FileDescriptor オブジェクトを返します。 |
int |
read()
入力ストリームから 1 バイトを読み込みます。 |
int |
read(byte[] b)
入力ストリームから最大 b.length バイトをバイト配列に読み込みます。 |
int |
read(byte[] b,
int off,
int len)
入力ストリームからバイト配列へ最大 len バイトのデータを読み込みます。 |
long |
skip(long n)
入力ストリームからのデータを n バイトだけスキップして破棄します。 |
| クラス java.io.InputStream から継承したメソッド |
mark, markSupported, reset |
| クラス java.lang.Object から継承したメソッド |
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| コンストラクタの詳細 |
public FileInputStream(String name)
throws FileNotFoundException
name により指定) に接続することにより、FileInputStream を作成します。このファイルの接続を表すために、新しい FileDescriptor オブジェクトが生成されます。
まず、セキュリティマネージャが存在する場合、checkRead メソッドが name 引数を引数として呼び出されます。
指定されたファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合は、FileNotFoundException がスローされます。
name - システム依存のファイル名
FileNotFoundException - ファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合
SecurityException - セキュリティマネージャが存在し、checkRead メソッドがファイルへの読み込みアクセスを拒否する場合SecurityManager.checkRead(java.lang.String)
public FileInputStream(File file)
throws FileNotFoundException
File オブジェクト file により指定) に接続することにより、FileInputStream を作成します。このファイルの接続を表すために、新しい FileDescriptor オブジェクトが生成されます。
まず、セキュリティマネージャが存在する場合、checkRead メソッドが、file 引数によって表されるパスを引数として呼び出されます。
指定されたファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合は、FileNotFoundException がスローされます。
file - 読み込みのために開かれるファイル
FileNotFoundException - ファイルが存在しないか、普通のファイルではなくディレクトリであるか、またはなんらかの理由で開くことができない場合
SecurityException - セキュリティマネージャが存在し、checkRead メソッドがファイルへの読み込みアクセスを拒否する場合File.getPath(),
SecurityManager.checkRead(java.lang.String)public FileInputStream(FileDescriptor fdObj)
fdObj を使用して、FileInputStream を作成します。
セキュリティマネージャが存在する場合、checkRead メソッドがファイル記述子 fdObj を引数として呼び出されます。これは、ファイル記述子を読み込めるかどうかを確認するためです。ファイル記述子への読み込みアクセスが拒否された場合、SecurityException がスローされます。
fdObj が null の場合は、NullPointerException がスローされます。
fdObj - 読み込みのために開かれるファイル記述子
SecurityException - セキュリティマネージャが存在し、checkRead メソッドがファイル記述子への読み込みアクセスを拒否する場合SecurityManager.checkRead(java.io.FileDescriptor)| メソッドの詳細 |
public int read()
throws IOException
InputStream 内の read-1
IOException - 入出力エラーが発生した場合
public int read(byte[] b)
throws IOException
b.length バイトをバイト配列に読み込みます。このメソッドはなんらかの入力が可能になるまでブロックします。
InputStream 内の readb - データの読み込み先のバッファ
-1
IOException - 入出力エラーが発生した場合InputStream.read(byte[], int, int)
public int read(byte[] b,
int off,
int len)
throws IOException
len バイトのデータを読み込みます。このメソッドは、入力が可能になるまでブロックします。
InputStream 内の readb - データの読み込み先のバッファoff - データの開始オフセットlen - 読み込まれる最大バイト数
-1
IOException - 入出力エラーが発生した場合InputStream.read()
public long skip(long n)
throws IOException
n バイトだけスキップして破棄します。さまざまな理由から、skip メソッドは、指定されたよりも少ないバイト数 (0 の場合もある) しかスキップしないことがあります。実際にスキップしたバイト数を返します。
InputStream 内の skipn - スキップするバイト数
IOException - 入出力エラーが発生した場合
public int available()
throws IOException
InputStream 内の availableIOException - 入出力エラーが発生した場合
public void close()
throws IOException
このストリームにチャネルが関連付けられている場合は、そのチャネルも閉じます。
InputStream 内の closeIOException - 入出力エラーが発生した場合
public final FileDescriptor getFD()
throws IOException
FileInputStream に使用されているファイルシステムの実際のファイルへの接続を表す FileDescriptor オブジェクトを返します。
IOException - 入出力エラーが発生した場合FileDescriptorpublic FileChannel getChannel()
FileChannel オブジェクトを返します。
返されたチャネルの の初期値は、それまでにファイルから読み込まれたバイト数に設定されます。このストリームからバイトを読み込むたびに、チャネルの位置が増分されます。チャネルの位置を明示的に変更した場合またはバイトの読み込みによって変更された場合は、このストリームのファイル位置も変更されます。
position
protected void finalize()
throws IOException
close メソッドが確実に呼び出されるようにします。
Object 内の finalizeIOException - 入出力エラーが発生した場合close()
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.