- java.lang.Object
-
- javax.imageio.stream.ImageInputStreamImpl
-
- javax.imageio.stream.MemoryCacheImageInputStream
-
- All Implemented Interfaces:
Closeable,DataInput,AutoCloseable,ImageInputStream
public class MemoryCacheImageInputStream extends ImageInputStreamImpl
An implementation ofImageInputStreamthat gets its input from a regularInputStream. A memory buffer is used to cache at least the data between the discard position and the current read position.In general, it is preferable to use a
FileCacheImageInputStreamwhen reading from a regularInputStream. This class is provided for cases where it is not possible to create a writable temporary file.
-
-
Field Summary
-
Fields declared in class javax.imageio.stream.ImageInputStreamImpl
bitOffset, byteOrder, flushedPos, streamPos
-
-
Constructor Summary
Constructors Constructor Description MemoryCacheImageInputStream(InputStream stream)Constructs aMemoryCacheImageInputStreamthat will read from a givenInputStream.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidclose()Closes thisMemoryCacheImageInputStream, freeing the cache.protected voidfinalize()Deprecated.Thefinalizemethod has been deprecated.booleanisCached()Returnstruesince thisImageInputStreamcaches data in order to allow seeking backwards.booleanisCachedFile()Returnsfalsesince thisImageInputStreamdoes not maintain a file cache.booleanisCachedMemory()Returnstruesince thisImageInputStreammaintains a main memory cache.-
Methods declared in class javax.imageio.stream.ImageInputStreamImpl
checkClosed, length, mark, read, read, read, reset, skipBytes, skipBytes
-
Methods declared in class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods declared in interface javax.imageio.stream.ImageInputStream
flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, seek, setBitOffset, setByteOrder
-
-
-
-
Constructor Detail
-
MemoryCacheImageInputStream
public MemoryCacheImageInputStream(InputStream stream)
Constructs aMemoryCacheImageInputStreamthat will read from a givenInputStream.- Parameters:
stream- anInputStreamto read from.- Throws:
IllegalArgumentException- ifstreamisnull.
-
-
Method Detail
-
isCached
public boolean isCached()
Returnstruesince thisImageInputStreamcaches data in order to allow seeking backwards.- Specified by:
isCachedin interfaceImageInputStream- Overrides:
isCachedin classImageInputStreamImpl- Returns:
true.- See Also:
isCachedMemory(),isCachedFile()
-
isCachedFile
public boolean isCachedFile()
Returnsfalsesince thisImageInputStreamdoes not maintain a file cache.- Specified by:
isCachedFilein interfaceImageInputStream- Overrides:
isCachedFilein classImageInputStreamImpl- Returns:
false.- See Also:
isCached(),isCachedMemory()
-
isCachedMemory
public boolean isCachedMemory()
Returnstruesince thisImageInputStreammaintains a main memory cache.- Specified by:
isCachedMemoryin interfaceImageInputStream- Overrides:
isCachedMemoryin classImageInputStreamImpl- Returns:
true.- See Also:
isCached(),isCachedFile()
-
close
public void close() throws IOExceptionCloses thisMemoryCacheImageInputStream, freeing the cache. The sourceInputStreamis not closed.- Throws:
IOException- if an I/O error occurs.
-
finalize
@Deprecated(since="9") protected void finalize() throws Throwable
Deprecated.Thefinalizemethod has been deprecated. Subclasses that overridefinalizein order to perform cleanup should be modified to use alternative cleanup mechanisms and to remove the overridingfinalizemethod. When overriding thefinalizemethod, its implementation must explicitly ensure thatsuper.finalize()is invoked as described inObject.finalize(). See the specification forObject.finalize()for further information about migration options.Finalizes this object prior to garbage collection. Theclosemethod is called to close any open input source. This method should not be called from application code.- Overrides:
finalizein classImageInputStreamImpl- Throws:
Throwable- if an error occurs during superclass finalization.
-
-