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