Class FileCacheSeekableStream

java.lang.Object

java.io.InputStream

com.twelvemonkeys.io.SeekableInputStream

com.twelvemonkeys.io.AbstractCachedSeekableStream

com.twelvemonkeys.io.FileCacheSeekableStream

All Implemented Interfaces:

Seekable, Closeable, AutoCloseable

public final class FileCacheSeekableStream
extends AbstractCachedSeekableStream

A SeekableInputStream implementation that caches data in a temporary File.

Temporary files are created as specified in File.createTempFile(String, String, java.io.File).

Version:

$Id: //depot/branches/personal/haraldk/twelvemonkeys/release-2/twelvemonkeys-core/src/main/java/com/twelvemonkeys/io/FileCacheSeekableStream.java#5 $

See Also:

• MemoryCacheSeekableStream
• FileSeekableStream
• File.createTempFile(String, String)
• RandomAccessFile

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final class	FileCacheSeekableStream.FileCache

Nested classes/interfaces inherited from class AbstractCachedSeekableStream

AbstractCachedSeekableStream.StreamCache

Field Summary

Fields

Modifier and Type	Field	Description
private byte[]	buffer

Fields inherited from class AbstractCachedSeekableStream

stream, streamPosition

Fields inherited from class SeekableInputStream

closed, flushedPosition, markedPositions, position

Constructor Summary

Constructors

Constructor	Description
FileCacheSeekableStream(InputStream pStream)	Creates a FileCacheSeekableStream reading from the given InputStream.
FileCacheSeekableStream(InputStream pStream, File pFile)
FileCacheSeekableStream(InputStream pStream, String pTempBaseName)	Creates a FileCacheSeekableStream reading from the given InputStream.
FileCacheSeekableStream(InputStream pStream, String pTempBaseName, File pTempDir)	Creates a FileCacheSeekableStream reading from the given InputStream.

Method Summary

Modifier and Type	Method	Description
protected void	closeImpl()
(package private) static File	createTempFile(String pTempBaseName, File pTempDir)
final boolean	isCachedFile()	Returns true if this Seekable stream caches data itself in order to allow seeking backwards, and the cache is kept in a temporary file.
final boolean	isCachedMemory()	Returns true if this Seekable stream caches data itself in order to allow seeking backwards, and the cache is kept in main memory.
int	read()
int	read(byte[] pBytes, int pOffset, int pLength)
private int	readAhead(byte[] pBytes, int pOffset, int pLength)

Methods inherited from class AbstractCachedSeekableStream

available, flushBeforeImpl, getCache, isCached, seekImpl, syncPosition

Methods inherited from class SeekableInputStream

checkOpen, close, finalize, flush, flushBefore, getFlushedPosition, getStreamPosition, mark, mark, markSupported, read, reset, seek, skip

Methods inherited from class InputStream

nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo

Methods inherited from class Object

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

Field Details

buffer

private byte[] buffer

Constructor Details

FileCacheSeekableStream

public FileCacheSeekableStream(InputStream pStream)
                        throws IOException

Creates a FileCacheSeekableStream reading from the given InputStream. Data will be cached in a temporary file.

Parameters:

pStream - the InputStream to read from

Throws:

IOException - if the temporary file cannot be created, or cannot be opened for random access.

FileCacheSeekableStream

public FileCacheSeekableStream(InputStream pStream,
 String pTempBaseName)
                        throws IOException

Creates a FileCacheSeekableStream reading from the given InputStream. Data will be cached in a temporary file, with the given base name.

Parameters:

pStream - the InputStream to read from

pTempBaseName - optional base name for the temporary file

Throws:

IOException - if the temporary file cannot be created, or cannot be opened for random access.

FileCacheSeekableStream

public FileCacheSeekableStream(InputStream pStream,
 String pTempBaseName,
 File pTempDir)
                        throws IOException

Creates a FileCacheSeekableStream reading from the given InputStream. Data will be cached in a temporary file, with the given base name, in the given directory

Parameters:

pStream - the InputStream to read from

pTempBaseName - optional base name for the temporary file

pTempDir - optional temp directory

Throws:

IOException - if the temporary file cannot be created, or cannot be opened for random access.

FileCacheSeekableStream

FileCacheSeekableStream(InputStream pStream,
 File pFile)
                 throws FileNotFoundException

Throws:

FileNotFoundException

Method Details

createTempFile

static File createTempFile(String pTempBaseName,
 File pTempDir)
                    throws IOException

Throws:

IOException

isCachedMemory

public final boolean isCachedMemory()

Description copied from interface: Seekable

Returns true if this Seekable stream caches data itself in order to allow seeking backwards, and the cache is kept in main memory. Applications may consult this in order to decide how frequently, or whether, to flush in order to conserve cache resources.

Specified by:

isCachedMemory in interface Seekable

Specified by:

isCachedMemory in class AbstractCachedSeekableStream

Returns:

true if this Seekable caches data in main memory.

See Also:

• Seekable.isCached()
• Seekable.isCachedFile()

isCachedFile

public final boolean isCachedFile()

Description copied from interface: Seekable

Returns true if this Seekable stream caches data itself in order to allow seeking backwards, and the cache is kept in a temporary file. Applications may consult this in order to decide how frequently, or whether, to flush in order to conserve cache resources.

Specified by:

isCachedFile in interface Seekable

Specified by:

isCachedFile in class AbstractCachedSeekableStream

Returns:

true if this Seekable caches data in a temporary file.

See Also:

• Seekable.isCached()
• Seekable.isCachedMemory()

closeImpl

protected void closeImpl()
                  throws IOException

Overrides:

closeImpl in class AbstractCachedSeekableStream

Throws:

IOException

read

public int read()
         throws IOException

Overrides:

read in class AbstractCachedSeekableStream

Throws:

IOException

read

public int read(byte[] pBytes,
 int pOffset,
 int pLength)
         throws IOException

Overrides:

read in class AbstractCachedSeekableStream

Throws:

IOException

readAhead

private int readAhead(byte[] pBytes,
 int pOffset,
 int pLength)
               throws IOException

Throws:

IOException