org.apache.derby.iapi.services.io
Interface CloneableStream

All Known Implementing Classes:

FormatIdInputStream, OverflowInputStream

public interface CloneableStream

This is a simple interface that is used by streams that can clone themselves.

The purpose is for the implementation of BLOB/CLOB (and potentially other types whose value is represented by a stream), for which their size makes it impossible or very expensive to materialize the value.

Method Summary

java.io.InputStream

cloneStream() Clone the stream.

Method Detail

cloneStream

java.io.InputStream cloneStream()

Clone the stream.

To be used when a "deep" clone of a stream is required rather than multiple references to the same stream.

The resulting clone should support reads, resets, closes which do not affect the original stream source of the clone.

Returns:

The cloned stream.