- 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()
非推奨。finalize
メソッドは推奨されていません。 クリーンアップを実行するためにfinalize
をオーバーライドするサブクラスは、代替クリーンアップ・メカニズムを使用し、オーバーライドするfinalize
メソッドを削除するように変更する必要があります。finalize
メソッドをオーバーライドする場合、実装では、super.finalize()
がObject.finalize()
の説明に従って呼び出されることを明示的に確認する必要があります。 移行オプションの詳細については、Object.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
-
-
-
-
コンストラクタの詳細
-
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
、インタフェース:AutoCloseable
- 定義:
close
、インタフェース:Closeable
- 定義:
close
、インタフェース:ImageInputStream
- オーバーライド:
close
、クラス:ImageInputStreamImpl
- 例外:
IOException
- 入出力エラーが発生した場合。
-
finalize
@Deprecated(since="9") protected void finalize() throws Throwable
非推奨。finalize
メソッドは推奨されていません。 クリーンアップを実行するためにfinalize
をオーバーライドするサブクラスは、代替クリーンアップ・メカニズムを使用し、オーバーライドするfinalize
メソッドを削除するように変更する必要があります。finalize
メソッドをオーバーライドする場合、実装では、super.finalize()
がObject.finalize()
の説明に従って呼び出されることを明示的に確認する必要があります。 移行オプションの詳細については、Object.finalize()
の仕様を参照してください。ガベージ・コレクションの前にこのオブジェクトをファイナライズします。close
メソッドを呼び出して、開いている入力ソースをすべて閉じます。 このメソッドを、アプリケーション・コードから呼び出してはいけません。- オーバーライド:
finalize
、クラス:ImageInputStreamImpl
- 例外:
Throwable
- スーパー・クラスのファイナライズ時にエラーが発生した場合。- 関連項目:
WeakReference
,PhantomReference
-
-