javax.imageio.stream
クラス MemoryCacheImageInputStream

java.lang.Object
  javax.imageio.stream.ImageInputStreamImpl
      javax.imageio.stream.MemoryCacheImageInputStream

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

DataInput, ImageInputStream

public class MemoryCacheImageInputStream
extends ImageInputStreamImpl

通常の InputStream から入力を取得する ImageInputStream の実装です。メモリーバッファーには、少なくとも破棄位置と現在の読み込み位置との間のデータがキャッシュされます。

一般的に、通常の InputStream から読み込む場合は、FileCacheImageInputStream を使用することをお勧めします。このクラスは、書き込み可能な一時ファイルを作成できない場合のために用意されています。

フィールドの概要

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

bitOffset, byteOrder, flushedPos, streamPos

コンストラクタの概要

MemoryCacheImageInputStream(InputStream stream)
指定された InputStream から読み込む MemoryCacheImageInputStream を構築します。

メソッドの概要

void	close() この MemoryCacheImageInputStream を閉じてキャッシュを解放します。
protected void	finalize() ガベージコレクションの前にこのオブジェクトをファイナライズします。
void	flushBefore(long pos) 指示された位置より前の初期のストリーム部分を破棄します。
boolean	isCached() 後方へのシークを可能にするために、この ImageInputStream がデータをキャッシュするため、true が返されます。
boolean	isCachedFile() この ImageInputStream はファイルキャッシュを維持しないため、false が返されます。
boolean	isCachedMemory() この ImageInputStream はメインメモリーキャッシュを維持するため、true が返されます。
int	read() ストリームから 1 バイトを読み込み、それを 0 から 255 までの int として返します。
int	read(byte[] b, int off, int len) ストリームから len バイトまで読み込み、b にインデックス off から格納します。

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

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

コンストラクタの詳細

MemoryCacheImageInputStream

public MemoryCacheImageInputStream(InputStream stream)

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

パラメータ:

stream - 読み込み元の InputStream

例外:

IllegalArgumentException - stream が null の場合

メソッドの詳細

read

public int read()
         throws IOException

クラス ImageInputStreamImpl の記述:

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

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

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

定義:

インタフェース ImageInputStream 内の read

定義:

クラス ImageInputStreamImpl 内の read

戻り値:

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

例外:

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

flushBefore

public void flushBefore(long pos)
                 throws IOException

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

指示された位置より前の初期のストリーム部分を破棄します。ストリームのフラッシュされた部分内のオフセットにシークしようとすると、IndexOutOfBoundsException がスローされます。

flushBefore を呼び出すと、このインタフェースを実装するクラスが、ストリームからデータを格納するのに使用するメモリーやディスクスペースなどのリソースを解放できます。

定義:

インタフェース ImageInputStream 内の flushBefore

オーバーライド:

クラス ImageInputStreamImpl 内の flushBefore

パラメータ:

pos - フラッシュされるストリーム接頭辞の 長さを示す long

例外:

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

isCached

public boolean isCached()

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

定義:

インタフェース ImageInputStream 内の isCached

オーバーライド:

クラス ImageInputStreamImpl 内の isCached

戻り値:

true のとき + 1

関連項目:

isCachedMemory(), isCachedFile()

isCachedFile

public boolean isCachedFile()

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

定義:

インタフェース ImageInputStream 内の isCachedFile

オーバーライド:

クラス ImageInputStreamImpl 内の isCachedFile

戻り値:

false

関連項目:

isCached(), isCachedMemory()

isCachedMemory

public boolean isCachedMemory()

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

定義:

インタフェース ImageInputStream 内の isCachedMemory

オーバーライド:

クラス ImageInputStreamImpl 内の isCachedMemory

戻り値:

true のとき + 1

関連項目:

isCached(), isCachedFile()

close

public void close()
           throws IOException

この MemoryCacheImageInputStream を閉じてキャッシュを解放します。ソース InputStream は閉じられません。

定義:

インタフェース ImageInputStream 内の close

オーバーライド:

クラス ImageInputStreamImpl 内の close

例外:

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

finalize

protected void finalize()
                 throws Throwable

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

オーバーライド:

クラス ImageInputStreamImpl 内の finalize

例外:

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