com.amazonaws.event

Class ProgressReportingInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.amazonaws.internal.SdkFilterInputStream

com.amazonaws.event.ProgressReportingInputStream

All Implemented Interfaces:

com.amazonaws.internal.MetricAware, Closeable, AutoCloseable

public class ProgressReportingInputStream
extends com.amazonaws.internal.SdkFilterInputStream

Simple InputStream wrapper that occasionally notifies a progress listener about the number of bytes transferred.

This class could be used for both Amazon S3 and Amazon Glacier clients. The legacy Amazon Amazon S3 com.amazonaws.services.s3.internal.ProgressReportingInputStream has been deprecated in favor of this new class.

Constructor Summary

Constructors

Constructor and Description
ProgressReportingInputStream(InputStream in, ProgressListenerCallbackExecutor listenerCallbackExecutor) Creates a new progress reporting input stream that simply wraps the specified input stream and uses the specified listener callback executor to asynchronously notify the listener about the number of bytes transferred.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
boolean	getFireCompletedEvent() Returns whether this input stream should fire an event with code ProgressEvent.COMPLETED_EVENT_CODE when this stream runs out of data.
int	read()
int	read(byte[] b, int off, int len)
void	reset()
void	setFireCompletedEvent(boolean fireCompletedEvent) Sets whether this input stream should fire an event with code ProgressEvent.COMPLETED_EVENT_CODE when this stream runs out of data.

Methods inherited from class com.amazonaws.internal.SdkFilterInputStream

isMetricActivated

Methods inherited from class java.io.FilterInputStream

available, mark, markSupported, read, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

ProgressReportingInputStream

public ProgressReportingInputStream(InputStream in,
                            ProgressListenerCallbackExecutor listenerCallbackExecutor)

Creates a new progress reporting input stream that simply wraps the specified input stream and uses the specified listener callback executor to asynchronously notify the listener about the number of bytes transferred.

Parameters:

in - The input stream to wrap.

listenerCallbackExecutor - The listener callback executor that wraps the listener to notify about progress.

Method Detail

setFireCompletedEvent

public void setFireCompletedEvent(boolean fireCompletedEvent)

Sets whether this input stream should fire an event with code ProgressEvent.COMPLETED_EVENT_CODE when this stream runs out of data. By default, completed events are not fired by this stream.

Parameters:

fireCompletedEvent - Whether this input stream should fire an event to indicate that the stream has been fully read.

getFireCompletedEvent

public boolean getFireCompletedEvent()

Returns whether this input stream should fire an event with code ProgressEvent.COMPLETED_EVENT_CODE when this stream runs out of data. By default, completed events are not fired by this stream.

Returns:

Whether this input stream should fire an event to indicate that the stream has been fully read.

read

public int read()
         throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

reset

public void reset()
           throws IOException

Overrides:

reset in class FilterInputStream

Throws:

IOException

read

public int read(byte[] b,
       int off,
       int len)
         throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FilterInputStream

Throws:

IOException