javax.imageio.stream

クラスFileImageInputStream

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.FileImageInputStream

すべての実装されたインタフェース:

Closeable, DataInput, AutoCloseable, ImageInputStream

public class FileImageInputStream
extends ImageInputStreamImpl

FileまたはRandomAccessFileから入力を取得するImageInputStreamの実装です。ファイルの内容は、オブジェクトの有効期間中は安定していると見なされます。

フィールドのサマリー

クラス javax.imageio.stream.ImageInputStreamImplから継承されたフィールド

bitOffset, byteOrder, flushedPos, streamPos

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
FileImageInputStream(File f) 指定されたFileから読み込むFileImageInputStreamを構築します。
FileImageInputStream(RandomAccessFile raf) 指定されたRandomAccessFileから読み込むFileImageInputStreamを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	close() ストリームを閉じます。
protected void	finalize() ガベージ・コレクションの前にこのオブジェクトをファイナライズします。
long	length() 基本となるファイルの長さ、またはそれが不明な場合は-1を返します。
int	read() ストリームから1バイトを読み込み、それを0から255までのintとして返します。
int	read(byte[] b, int off, int len) ストリームから最大lenバイトを読み込み、bにインデックスoffから格納します。
void	seek(long pos) 現在のストリーム位置を目的の位置に設定します。

クラス javax.imageio.stream.ImageInputStreamImplから継承されたメソッド

checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, mark, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, setBitOffset, setByteOrder, skipBytes, skipBytes

クラス java.lang.Objectから継承されたメソッド

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

FileImageInputStream

public FileImageInputStream(File f)
                     throws FileNotFoundException,
                            IOException

指定されたFileから読み込むFileImageInputStreamを構築します。

このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。

パラメータ:

f - 読込み元のFile。

例外:

IllegalArgumentException - fがnullの場合。

SecurityException - セキュリティ・マネージャが存在し、ファイルへの読込みアクセスが許可されない場合。

FileNotFoundException - fがディレクトリであるか、ほかの何らかの理由で読込み用に開くことができない場合。

IOException - 入出力エラーが発生した場合。

FileImageInputStream

public FileImageInputStream(RandomAccessFile raf)

指定されたRandomAccessFileから読み込むFileImageInputStreamを構築します。

このオブジェクトの構築時から読込みメソッドを最後に呼び出すまでの間、ファイルの内容を変更してはいけません。

パラメータ:

raf - 読込み元のRandomAccessFile。

例外:

IllegalArgumentException - rafがnullの場合。

メソッドの詳細

read

public int read()
         throws IOException

クラスからコピーされた説明: ImageInputStreamImpl

ストリームから1バイトを読み込み、それを0から255までのintとして返します。EOFに達すると-1を返します。

サブクラスでこのメソッドを実装する必要があります。サブクラス実装で終了する前にストリーム位置を更新します。

ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。

定義:

read、インタフェース: ImageInputStream

定義:

read、クラス: ImageInputStreamImpl

戻り値:

ストリーム内の次のバイトの値。または、EOFに達した場合は-1。

例外:

IOException - ストリームが閉じられている場合。

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

クラスからコピーされた説明: ImageInputStreamImpl

ストリームから最大lenバイトを読み込み、bにインデックスoffから格納します。ストリームの終わりに達したためにバイトを読み込めない場合は、-1を返します。

ストリーム内のビット・オフセットは、読込みを行う前に0にリセットする必要があります。

サブクラスでこのメソッドを実装する必要があります。サブクラス実装で終了する前にストリーム位置を更新します。

定義:

read、インタフェース: ImageInputStream

定義:

read、クラス: ImageInputStreamImpl

パラメータ:

b - 書き込まれるバイト配列。

off - 書込み先のb内の開始位置。

len - 読み込む最大バイト数。

戻り値:

実際に読み込まれたバイト数、またはEOFを示す-1。

例外:

IOException - 入出力エラーが発生した場合。

length

public long length()

基本となるファイルの長さ、またはそれが不明な場合は-1を返します。

定義:

length、インタフェース: ImageInputStream

オーバーライド:

length、クラス: ImageInputStreamImpl

戻り値:

ファイルの長さ(long)、または-1。

seek

public void seek(long pos)
          throws IOException

インタフェースからコピーされた説明: ImageInputStream

現在のストリーム位置を目的の位置に設定します。次回の読込みはこの位置で行われます。ビット・オフセットは0に設定されます。

posがgetflushedPositionから返されるフラッシュ位置よりも小さい場合は、IndexOutOfBoundsExceptionがスローされます。

シークでファイルの終わりを通過することは正常であり、java.io.EOFExceptionは読込みの場合のみスローされます。

定義:

seek、インタフェース: ImageInputStream

オーバーライド:

seek、クラス: ImageInputStreamImpl

パラメータ:

pos - 目的のファイル・ポインタ位置を示すlong。

例外:

IOException - その他の入出力エラーが発生した場合。

close

public void close()
           throws IOException

インタフェースからコピーされた説明: ImageInputStream

ストリームを閉じます。閉じたストリームにアクセスしようとすると、IOExceptionがスローされるか不正な動作が実行される場合があります。このメソッドを呼び出すと、このインタフェースを実装するクラスが、メモリー、ディスク・スペース、またはファイル記述子などのストリームに関連するリソースを解放できます。

定義:

close、インタフェース: Closeable

定義:

close、インタフェース: AutoCloseable

定義:

close、インタフェース: ImageInputStream

オーバーライド:

close、クラス: ImageInputStreamImpl

例外:

IOException - 入出力エラーが発生した場合。

finalize

protected void finalize()
                 throws Throwable

ガベージ・コレクションの前にこのオブジェクトをファイナライズします。closeメソッドを呼び出して、開いている入力ソースをすべて閉じます。このメソッドを、アプリケーション・コードから呼び出してはいけません。

オーバーライド:

finalize、クラス: ImageInputStreamImpl

例外:

Throwable - スーパー・クラスのファイナライズ時にエラーが発生した場合。

関連項目:

WeakReference, PhantomReference