com.ibm.cloud.objectstorage.services.s3.internal

Class RepeatableInputStream

java.lang.Object

java.io.InputStream

com.ibm.cloud.objectstorage.internal.SdkInputStream

com.ibm.cloud.objectstorage.services.s3.internal.RepeatableInputStream

All Implemented Interfaces:

MetricAware, Releasable, Closeable, AutoCloseable

Deprecated.

by SdkBufferedInputStream. A repeatable input stream wrapper for any input stream. This input stream relies on buffered data to repeat, and can therefore only be repeated when less data has been read than this buffer can hold.

Note: Always use a ResettableInputStream instead of this class if you are sourcing data from a file, as the file-based repeatable input stream can be repeated without any limitations.

@Deprecated
public class RepeatableInputStream
extends SdkInputStream

Constructor Summary

Constructors

Constructor and Description
RepeatableInputStream(InputStream inputStream, int bufferSize) Deprecated. Creates a repeatable input stream based on another input stream.

Method Summary

Modifier and Type	Method and Description
int	available() Deprecated.
void	close() Deprecated.
InputStream	getWrappedInputStream() Deprecated. Returns the underlying input stream, if any, from the subclass; or null if there is no underlying input stream.
void	mark(int readlimit) Deprecated. This method can only be used while less data has been read from the input stream than fits into the buffer.
boolean	markSupported() Deprecated.
int	read() Deprecated.
int	read(byte[] out, int outOffset, int outLength) Deprecated.
void	reset() Deprecated. Resets the input stream to the beginning by pointing the buffer offset to the beginning of the available data buffer.

Methods inherited from class com.ibm.cloud.objectstorage.internal.SdkInputStream

abort, abortIfNeeded, isMetricActivated, release

Methods inherited from class java.io.InputStream

read, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

RepeatableInputStream

public RepeatableInputStream(InputStream inputStream,
                             int bufferSize)

Deprecated.

Creates a repeatable input stream based on another input stream.

Parameters:

inputStream - The input stream to wrap. The data read from the wrapped input stream is buffered as it is read, up to the buffer limit specified.

bufferSize - The number of bytes buffered by this class.

Method Detail

reset

public void reset()
           throws IOException

Deprecated.

Resets the input stream to the beginning by pointing the buffer offset to the beginning of the available data buffer.

Overrides:

reset in class InputStream

Throws:

IOException - When the available buffer size has been exceeded, in which case the input stream data cannot be repeated.

markSupported

public boolean markSupported()

Deprecated.

Overrides:

markSupported in class InputStream

See Also:

InputStream.markSupported()

mark

public void mark(int readlimit)

Deprecated.

This method can only be used while less data has been read from the input stream than fits into the buffer. The readLimit parameter is ignored entirely.

Overrides:

mark in class InputStream

available

public int available()
              throws IOException

Deprecated.

Overrides:

available in class InputStream

Throws:

IOException

See Also:

InputStream.available()

close

public void close()
           throws IOException

Deprecated.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class InputStream

Throws:

IOException

See Also:

InputStream.close()

read

public int read(byte[] out,
                int outOffset,
                int outLength)
         throws IOException

Deprecated.

Overrides:

read in class InputStream

Throws:

IOException

See Also:

InputStream.read(byte[], int, int)

read

public int read()
         throws IOException

Deprecated.

Specified by:

read in class InputStream

Throws:

IOException

See Also:

InputStream.read()

getWrappedInputStream

public InputStream getWrappedInputStream()

Deprecated.

Description copied from class: SdkInputStream

Returns the underlying input stream, if any, from the subclass; or null if there is no underlying input stream.

Specified by:

getWrappedInputStream in class SdkInputStream