org.apache.camel

Interface StreamCache

All Known Implementing Classes:

ByteArrayInputStreamCache, FileInputStreamCache, InputStreamCache, ReaderCache, SourceCache, StreamSourceCache

public interface StreamCache

Tagging interface to indicate that a type is capable of caching the underlying data stream.

This is a useful feature for avoiding message re-readability issues. This interface is mainly used by the StreamCachingStrategy for determining if/how to wrap a stream-based message.

The Camel routing engine uses the CamelInternalProcessor.StreamCachingAdvice to apply the stream cache during routing.

Version:

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_SPOOL_THRESHOLD

Method Summary

Methods

Modifier and Type	Method and Description
boolean	inMemory() Whether this StreamCache is in memory only or spooled to persistent storage such as files.
long	length() Gets the length of the cached stream.
void	reset() Resets the StreamCache for a new stream consumption.
void	writeTo(OutputStream os) Writes the stream to the given output

Field Detail

DEFAULT_SPOOL_THRESHOLD

static final long DEFAULT_SPOOL_THRESHOLD

See Also:

Constant Field Values

Method Detail

reset

void reset()

Resets the StreamCache for a new stream consumption.

writeTo

void writeTo(OutputStream os)
             throws IOException

Writes the stream to the given output

Parameters:

os - the destination to write to

Throws:

IOException - is thrown if write fails

inMemory

boolean inMemory()

Whether this StreamCache is in memory only or spooled to persistent storage such as files.

length

long length()

Gets the length of the cached stream.

The implementation may return 0 in cases where the length cannot be computed, or if the implementation does not support this.

Returns:

number of bytes in the cache.