- java.lang.Object
-
- javax.imageio.stream.ImageInputStreamImpl
-
- javax.imageio.stream.MemoryCacheImageInputStream
-
- すべての実装されたインタフェース:
Closeable
,DataInput
,AutoCloseable
,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()
非推奨。finalize
メソッドは推奨されていません。 クリーンアップを実行するためにfinalize
をオーバーライドするサブクラスは、代替クリーンアップ・メカニズムを使用し、オーバーライドするfinalize
メソッドを削除するように変更する必要があります。finalize
メソッドをオーバーライドする場合、実装では、super.finalize()
がObject.finalize()
の説明に従って呼び出されることを明示的に確認する必要があります。 移行オプションの詳細については、Object.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
-
-
-
-
コンストラクタの詳細
-
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にリセットする必要があります。
- 定義:
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
- 入出力エラーが発生した場合。
-
flushBefore
public void flushBefore(long pos) throws IOException
インタフェースからコピーされた説明:ImageInputStream
指示された位置より前のストリームの先頭部分を破棄します。 ストリームのフラッシュされた部分内のオフセットにシークしようとすると、IndexOutOfBoundsException
がスローされます。flushBefore
を呼び出すと、このインタフェースを実装するクラスが、ストリームからデータを格納するのに使用するメモリーやディスク・スペースなどのリソースを解放できます。- 定義:
flushBefore
、インタフェース:ImageInputStream
- オーバーライド:
flushBefore
、クラス:ImageInputStreamImpl
- パラメータ:
pos
- フラッシュされるストリーム接頭辞の長さを示すlong
。- 例外:
IOException
- 入出力エラーが発生した場合。
-
isCached
public boolean isCached()
後方へのシークを可能にするために、このImageInputStream
がデータをキャッシュするため、true
が返されます。- 定義:
isCached
、インタフェース:ImageInputStream
- オーバーライド:
isCached
、クラス:ImageInputStreamImpl
- 戻り値:
true
。- 関連項目:
isCachedMemory()
,isCachedFile()
-
isCachedFile
public boolean isCachedFile()
このImageInputStream
はファイル・キャッシュを維持しないため、false
が返されます。- 定義:
isCachedFile
、インタフェース:ImageInputStream
- オーバーライド:
isCachedFile
、クラス:ImageInputStreamImpl
- 戻り値:
false
。- 関連項目:
isCached()
,isCachedMemory()
-
isCachedMemory
public boolean isCachedMemory()
このImageInputStream
はメイン・メモリー・キャッシュを維持するため、true
が返されます。- 定義:
isCachedMemory
、インタフェース:ImageInputStream
- オーバーライド:
isCachedMemory
、クラス:ImageInputStreamImpl
- 戻り値:
true
。- 関連項目:
isCached()
,isCachedFile()
-
close
public void close() throws IOException
このMemoryCacheImageInputStream
を閉じてキャッシュを解放します。 ソースInputStream
は閉じられません。- 定義:
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
-
-