com.qcloud.cos.transfer

Class DownloadImpl

java.lang.Object

com.qcloud.cos.transfer.AbstractTransfer

com.qcloud.cos.transfer.DownloadImpl

All Implemented Interfaces:

Download, Transfer

public class DownloadImpl
extends AbstractTransfer
implements Download

Nested Class Summary

Nested classes/interfaces inherited from interface com.qcloud.cos.transfer.Transfer

Transfer.TransferState

Field Summary

Fields inherited from class com.qcloud.cos.transfer.AbstractTransfer

listenerChain, monitor, state, stateChangeListeners

Constructor Summary

Constructors

Constructor and Description
DownloadImpl(String description, TransferProgress transferProgress, ProgressListenerChain progressListenerChain, COSObject cosObject, TransferStateChangeListener listener, GetObjectRequest getObjectRequest, File file)

Method Summary

Modifier and Type	Method and Description
void	abort() Cancels this download.
void	abortWithoutNotifyingStateChangeListener() Cancels this download, but skip notifying the state change listeners.
String	getBucketName() The name of the bucket where the object is being downloaded from.
COSObject	getCosObject()
String	getKey() The key under which this object was stored in Qcloud COS.
ObjectMetadata	getObjectMetadata() Returns the ObjectMetadata for the object being downloaded.
PersistableDownload	pause() Pause the current download operation and returns the information that can be used to resume the download at a later time.
void	setCosObject(COSObject cosObject)
void	setState(Transfer.TransferState state) This method is also responsible for firing COMPLETED signal to the listeners.

Methods inherited from class com.qcloud.cos.transfer.AbstractTransfer

addProgressListener, addStateChangeListener, fireProgressEvent, getDescription, getMonitor, getProgress, getState, isDone, notifyStateChangeListeners, removeProgressListener, removeStateChangeListener, rethrowExecutionException, setMonitor, unwrapExecutionException, waitForCompletion, waitForException

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.qcloud.cos.transfer.Transfer

addProgressListener, getDescription, getProgress, getState, isDone, removeProgressListener, waitForCompletion, waitForException

Constructor Detail

DownloadImpl

public DownloadImpl(String description,
                    TransferProgress transferProgress,
                    ProgressListenerChain progressListenerChain,
                    COSObject cosObject,
                    TransferStateChangeListener listener,
                    GetObjectRequest getObjectRequest,
                    File file)

Method Detail

getObjectMetadata

public ObjectMetadata getObjectMetadata()

Returns the ObjectMetadata for the object being downloaded.

Specified by:

getObjectMetadata in interface Download

Returns:

The ObjectMetadata for the object being downloaded.

getBucketName

public String getBucketName()

The name of the bucket where the object is being downloaded from.

Specified by:

getBucketName in interface Download

Returns:

The name of the bucket where the object is being downloaded from.

getKey

public String getKey()

The key under which this object was stored in Qcloud COS.

Specified by:

getKey in interface Download

Returns:

The key under which this object was stored in Qcloud COS.

abort

public void abort()
           throws IOException

Cancels this download.

Specified by:

abort in interface Download

Throws:

IOException

abortWithoutNotifyingStateChangeListener

public void abortWithoutNotifyingStateChangeListener()
                                              throws IOException

Cancels this download, but skip notifying the state change listeners.

Throws:

IOException

getCosObject

public COSObject getCosObject()

setCosObject

public void setCosObject(COSObject cosObject)

setState

public void setState(Transfer.TransferState state)

This method is also responsible for firing COMPLETED signal to the listeners.

Overrides:

setState in class AbstractTransfer

pause

public PersistableDownload pause()
                          throws PauseException

Description copied from interface: Download

Pause the current download operation and returns the information that can be used to resume the download at a later time. Resuming a download would not perform ETag check as range get is performed for downloading the object's remaining contents. Resuming a download for an object encrypted using CryptoMode#StrictAuthenticatedEncryption would result in CosClientException as authenticity cannot be guaranteed for a range get operation.

Specified by:

pause in interface Download

Throws:

PauseException - If any errors were encountered while trying to pause the download.