javax.imageio.stream

クラス FileCacheImageInputStream

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.FileCacheImageInputStream

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

Closeable, DataInput, AutoCloseable, ImageInputStream

public class FileCacheImageInputStream
extends ImageInputStreamImpl

通常の InputStream から入力を取得する ImageInputStream の実装です。ファイルは、以前に読み込んだデータのキャッシュとして使用されます。

フィールドのサマリー

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

bitOffset, byteOrder, flushedPos, streamPos

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

コンストラクタ

コンストラクタと説明
FileCacheImageInputStream(InputStream stream, File cacheDir) 指定された InputStream から読み込む FileCacheImageInputStream を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	close() この FileCacheImageInputStream を閉じます。キャッシュファイルは閉じられ、削除されます。
protected void	finalize() ガベージコレクションの前にこのオブジェクトをファイナライズします。
boolean	isCached() 後方へのシークを可能にするために、この ImageInputStream がデータをキャッシュするため、true が返されます。
boolean	isCachedFile() この ImageInputStream はファイルキャッシュを維持するため、true が返されます。
boolean	isCachedMemory() この ImageInputStream はメインメモリーキャッシュを維持しないため、false が返されます。
int	read() ストリームから 1 バイトを読み込み、それを 0 から 255 までの int として返します。
int	read(byte[] b, int off, int len) ストリームから最大 len バイトを読み込み、b にインデックス off から格納します。

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

checkClosed, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, length, 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, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

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

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

コンストラクタの詳細

FileCacheImageInputStream

public FileCacheImageInputStream(InputStream stream,
                         File cacheDir)
                          throws IOException

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

一時ファイルがキャッシュとして使用されます。cacheDir が null ではなく、ディレクトリである場合、ファイルがそこに作成されます。null の場合、システム固有のデフォルト一時ファイルディレクトリが使用されます。詳細は File.createTempFile のドキュメントを参照してください。

パラメータ:

stream - 読み込み元の InputStream。

cacheDir - キャッシュファイルが作成される場所を示す File。システムディレクトリを使用する場合は null。

例外:

IllegalArgumentException - stream が null の場合。

IllegalArgumentException - cacheDir が null 以外であるが、ディレクトリではない場合。

IOException - キャッシュファイルを作成できない場合。

メソッドの詳細

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 - 入出力エラーが発生した場合。

isCached

public boolean isCached()

後方へのシークを可能にするために、この ImageInputStream がデータをキャッシュするため、true が返されます。

定義:

isCached、インタフェース: ImageInputStream

オーバーライド:

isCached、クラス: ImageInputStreamImpl

戻り値:

true.

関連項目:

isCachedMemory(), isCachedFile()

isCachedFile

public boolean isCachedFile()

この ImageInputStream はファイルキャッシュを維持するため、true が返されます。

定義:

isCachedFile、インタフェース: ImageInputStream

オーバーライド:

isCachedFile、クラス: ImageInputStreamImpl

戻り値:

true.

関連項目:

isCached(), isCachedMemory()

isCachedMemory

public boolean isCachedMemory()

この ImageInputStream はメインメモリーキャッシュを維持しないため、false が返されます。

定義:

isCachedMemory、インタフェース: ImageInputStream

オーバーライド:

isCachedMemory、クラス: ImageInputStreamImpl

戻り値:

false.

関連項目:

isCached(), isCachedFile()

close

public void close()
           throws IOException

この FileCacheImageInputStream を閉じます。キャッシュファイルは閉じられ、削除されます。ソース InputStream は閉じられません。

定義:

close、インタフェース: Closeable

定義:

close、インタフェース: AutoCloseable

定義:

close、インタフェース: ImageInputStream

オーバーライド:

close、クラス: ImageInputStreamImpl

例外:

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

finalize

protected void finalize()
                 throws Throwable

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

オーバーライド:

finalize、クラス: ImageInputStreamImpl

例外:

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