javax.imageio.stream
クラス FileImageInputStream

java.lang.Object
  |
  +--javax.imageio.stream.ImageInputStreamImpl
        |
        +--javax.imageio.stream.FileImageInputStream

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

DataInput, 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() ストリームを閉じます。
long	length() 基本となるファイルの長さ、またはそれが不明な場合は -1 を返します。
int	read() ストリームから 1 バイトを読み込み、それを 0 から 255 までの整数として返します。
int	read(byte[] b, int off, int len) ストリームから len バイトまで読み込み、b にインデックス off から格納します。
void	seek(long pos) 現在のストリーム位置を目的の位置に設定します。

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

checkClosed, finalize, 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

インタフェース ImageInputStream の記述:

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

ストリーム内のビットオフセットは読み込みを行う前に 0 にリセットされます。

定義:

インタフェース ImageInputStream 内の read

定義:

クラス ImageInputStreamImpl 内の read

戻り値:

ストリームからのバイト値 (int)、または -1 (EOF を示す)

例外:

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

read

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

クラス ImageInputStreamImpl の記述:

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

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

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

定義:

インタフェース ImageInputStream 内の read

定義:

クラス ImageInputStreamImpl 内の read

パラメータ:

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

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

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

戻り値:

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

例外:

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

length

public long length()

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

定義:

インタフェース ImageInputStream 内の length

オーバーライド:

クラス ImageInputStreamImpl 内の length

戻り値:

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

seek

public void seek(long pos)
          throws IOException

インタフェース ImageInputStream の記述:

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

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

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

定義:

インタフェース ImageInputStream 内の seek

オーバーライド:

クラス ImageInputStreamImpl 内の seek

パラメータ:

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

例外:

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

close

public void close()
           throws IOException

インタフェース ImageInputStream の記述:

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

定義:

インタフェース ImageInputStream 内の close

オーバーライド:

クラス ImageInputStreamImpl 内の close

例外:

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