com.ibm.cloud.objectstorage.event

Class ProgressListenerChain

java.lang.Object

com.ibm.cloud.objectstorage.event.ProgressListenerChain

All Implemented Interfaces:

DeliveryMode, ProgressListener

Direct Known Subclasses:

S3ProgressListenerChain

public class ProgressListenerChain
extends Object
implements ProgressListener, DeliveryMode

An implementation of ProgressListener interface that delegates progressChanged callback to multiple listeners. It also takes an optional ProgressEventFilter to filter incoming events before passing them to the listeners.

This class could be used for both Amazon S3 and Amazon Glacier clients. The legacy Amazon S3 progress listener chain com.ibm.cloud.objectstorage.services.s3.transfer.internal.ProgressListenerChain has been deprecated in favor of this new class.

Nested Class Summary

Nested classes/interfaces inherited from interface com.ibm.cloud.objectstorage.event.ProgressListener

ProgressListener.ExceptionReporter, ProgressListener.NoOpProgressListener

Nested classes/interfaces inherited from interface com.ibm.cloud.objectstorage.event.DeliveryMode

DeliveryMode.Check

Field Summary

Fields inherited from interface com.ibm.cloud.objectstorage.event.ProgressListener

NOOP

Constructor Summary

Constructors

Constructor and Description
ProgressListenerChain(ProgressEventFilter progressEventFilter, ProgressListener... listeners) Create a listener chain with a ProgressEventFilter.
ProgressListenerChain(ProgressListener... listeners) Create a listener chain that directly passes all the progress events to the specified listeners.

Method Summary

Modifier and Type	Method and Description
void	addProgressListener(ProgressListener listener)
protected List<ProgressListener>	getListeners() Returns the listeners associated with this listener chain.
boolean	isSyncCallSafe() Returns true if it is safe to make a synchronous callback to the implementing listener without the risk of incurring undue latency; false otherwise.
void	progressChanged(ProgressEvent progressEvent) Called when progress has changed, such as additional bytes transferred, transfer failed, etc.
void	removeProgressListener(ProgressListener listener)

Methods inherited from class java.lang.Object

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

Constructor Detail

ProgressListenerChain

public ProgressListenerChain(ProgressListener... listeners)

Create a listener chain that directly passes all the progress events to the specified listeners.

ProgressListenerChain

public ProgressListenerChain(ProgressEventFilter progressEventFilter,
                             ProgressListener... listeners)

Create a listener chain with a ProgressEventFilter.

Method Detail

addProgressListener

public void addProgressListener(ProgressListener listener)

removeProgressListener

public void removeProgressListener(ProgressListener listener)

getListeners

protected List<ProgressListener> getListeners()

Returns the listeners associated with this listener chain.

progressChanged

public void progressChanged(ProgressEvent progressEvent)

Description copied from interface: ProgressListener

Called when progress has changed, such as additional bytes transferred, transfer failed, etc. The execution of the callback of this listener is managed by SDKProgressPublisher. Implementation of this interface should never block.

If the implementation follows the best practice and doesn't block, it should then extends from SyncProgressListener.

Note any exception thrown by the listener will get ignored. Should there be need to capture any such exception, you may consider wrapping the listener with ProgressListener.ExceptionReporter.wrap(ProgressListener).

Specified by:

progressChanged in interface ProgressListener

Parameters:

progressEvent - The event describing the progress change.

See Also:

SDKProgressPublisher, ProgressListener.ExceptionReporter

isSyncCallSafe

public boolean isSyncCallSafe()

Description copied from interface: DeliveryMode

Returns true if it is safe to make a synchronous callback to the implementing listener without the risk of incurring undue latency; false otherwise.

Specified by:

isSyncCallSafe in interface DeliveryMode