public final class ChainedTransferListener extends AbstractTransferListener
Constructor and Description |
---|
ChainedTransferListener(Collection<? extends TransferListener> listeners)
Creates a new multicast listener that delegates to the specified listeners.
|
ChainedTransferListener(TransferListener... listeners)
Creates a new multicast listener that delegates to the specified listeners.
|
Modifier and Type | Method and Description |
---|---|
void |
add(Collection<? extends TransferListener> listeners)
Adds the specified listeners to the end of the multicast chain.
|
void |
add(TransferListener listener)
Adds the specified listener to the end of the multicast chain.
|
protected void |
handleError(TransferEvent event,
TransferListener listener,
RuntimeException error) |
static TransferListener |
newInstance(TransferListener listener1,
TransferListener listener2)
Creates a new multicast listener that delegates to the specified listeners.
|
void |
remove(TransferListener listener)
Removes the specified listener from the multicast chain.
|
void |
transferCorrupted(TransferEvent event)
Notifies the listener that a checksum validation failed.
|
void |
transferFailed(TransferEvent event)
Notifies the listener about the unsuccessful termination of a transfer.
|
void |
transferInitiated(TransferEvent event)
Notifies the listener about the initiation of a transfer.
|
void |
transferProgressed(TransferEvent event)
Notifies the listener about some progress in the data transfer.
|
void |
transferStarted(TransferEvent event)
Notifies the listener about the start of a data transfer.
|
void |
transferSucceeded(TransferEvent event)
Notifies the listener about the successful completion of a transfer.
|
public ChainedTransferListener(TransferListener... listeners)
listeners
- The listeners to delegate to, may be null
or empty.public ChainedTransferListener(Collection<? extends TransferListener> listeners)
listeners
- The listeners to delegate to, may be null
or empty.public static TransferListener newInstance(TransferListener listener1, TransferListener listener2)
null
.listener1
- The first listener, may be null
.listener2
- The second listener, may be null
.null
if no listener was supplied.public void add(Collection<? extends TransferListener> listeners)
listeners
- The listeners to add, may be null
or empty.public void add(TransferListener listener)
listener
- The listener to add, may be null
.public void remove(TransferListener listener)
listener
- The listener to remove, may be null
.protected void handleError(TransferEvent event, TransferListener listener, RuntimeException error)
public void transferInitiated(TransferEvent event) throws TransferCancelledException
TransferListener
transferInitiated
in interface TransferListener
transferInitiated
in class AbstractTransferListener
event
- The event details, must not be null
.TransferCancelledException
- If the transfer should be aborted.public void transferStarted(TransferEvent event) throws TransferCancelledException
TransferListener
TransferResource.getContentLength()
if possible. This event may be fired multiple times for given
transfer request if said transfer needs to be repeated (e.g. in response to an authentication challenge).transferStarted
in interface TransferListener
transferStarted
in class AbstractTransferListener
event
- The event details, must not be null
.TransferCancelledException
- If the transfer should be aborted.public void transferProgressed(TransferEvent event) throws TransferCancelledException
TransferListener
transferProgressed
in interface TransferListener
transferProgressed
in class AbstractTransferListener
event
- The event details, must not be null
.TransferCancelledException
- If the transfer should be aborted.public void transferCorrupted(TransferEvent event) throws TransferCancelledException
TransferListener
TransferEvent.getException()
will be of type
ChecksumFailureException
and can be used to query further details about the expected/actual checksums.transferCorrupted
in interface TransferListener
transferCorrupted
in class AbstractTransferListener
event
- The event details, must not be null
.TransferCancelledException
- If the transfer should be aborted.public void transferSucceeded(TransferEvent event)
TransferListener
transferSucceeded
in interface TransferListener
transferSucceeded
in class AbstractTransferListener
event
- The event details, must not be null
.public void transferFailed(TransferEvent event)
TransferListener
TransferEvent.getException()
will
provide further information about the failure.transferFailed
in interface TransferListener
transferFailed
in class AbstractTransferListener
event
- The event details, must not be null
.Copyright © 2010–2019 The Apache Software Foundation. All rights reserved.