com.amazonaws.services.s3.internal

Class RepeatableInputStream

java.lang.Object

java.io.InputStream

com.amazonaws.services.s3.internal.RepeatableInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class RepeatableInputStream
extends InputStream

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 RepeatableFileInputStream 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.

Constructor Summary

Constructors

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

Method Summary

Methods

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

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)

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

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()

Overrides:

markSupported in class InputStream

See Also:

InputStream.markSupported()

mark

public void mark(int readlimit)

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

Overrides:

available in class InputStream

Throws:

IOException

See Also:

InputStream.available()

close

public void close()
           throws IOException

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

Overrides:

read in class InputStream

Throws:

IOException

See Also:

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

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException

See Also:

InputStream.read()

getWrappedInputStream

public InputStream getWrappedInputStream()