com.sinacloud.scs.services.scs.transfer

接口 Transfer

所有已知子接口:

Download, MultipleFileDownload, MultipleFileUpload, Upload

所有已知实现类:

AbstractTransfer, DownloadImpl, MultipleFileDownloadImpl, MultipleFileTransfer, MultipleFileUploadImpl, UploadImpl

public interface Transfer

Represents an asynchronous upload to or download from Amazon S3. Use this class to check a tranfer's progress, add listeners for progress events, check the state of a transfer, or wait for the transfer to complete.

See TransferManager for more information about creating transfers.

另请参阅:

TransferManager.upload(String, String, java.io.File), TransferManager#upload(com.sina.scs.model.PutObjectRequest)

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	Transfer.TransferState Enumeration of the possible transfer states.

方法概要

方法

限定符和类型	方法和说明
void	addProgressListener(ProgressListener listener) Adds the specified progress listener to the list of listeners receiving updates about this transfer's progress.
void	addProgressListener(ProgressListener listener) 已过时。 Replaced by addProgressListener(ProgressListener)
String	getDescription() Returns a human-readable description of this transfer.
TransferProgress	getProgress() Returns progress information about this transfer.
Transfer.TransferState	getState() Returns the current state of this transfer.
boolean	isDone() Returns whether or not the transfer is finished (i.e. completed successfully, failed, or was canceled).
void	removeProgressListener(ProgressListener listener) Removes the specified progress listener from the list of progress listeners receiving updates about this transfer's progress.
void	removeProgressListener(ProgressListener listener) 已过时。 Replaced by removeProgressListener(ProgressListener)
void	waitForCompletion() Waits for this transfer to complete.
SCSClientException	waitForException() Waits for this transfer to finish and returns any error that occurred, or returns null if no errors occurred.

方法详细资料

isDone

boolean isDone()

Returns whether or not the transfer is finished (i.e. completed successfully, failed, or was canceled).

返回:

Returns true if this transfer is finished (i.e. completed successfully, failed, or was canceled). Returns false if otherwise.

waitForCompletion

void waitForCompletion()
                       throws SCSClientException,
                              SCSServiceException,
                              InterruptedException

Waits for this transfer to complete. This is a blocking call; the current thread is suspended until this transfer completes.

抛出:

SCSClientException - If any errors were encountered in the client while making the request or handling the response.

SCSServiceException - If any errors occurred in Amazon S3 while processing the request.

InterruptedException - If this thread is interrupted while waiting for the transfer to complete.

waitForException

SCSClientException waitForException()
                                    throws InterruptedException

Waits for this transfer to finish and returns any error that occurred, or returns null if no errors occurred. This is a blocking call; the current thread will be suspended until this transfer either fails or completes successfully.

返回:

Any error that occurred while processing this transfer. Otherwise returns null if no errors occurred.

抛出:

InterruptedException - If this thread is interrupted while waiting for the transfer to complete.

getDescription

String getDescription()

Returns a human-readable description of this transfer.

返回:

A human-readable description of this transfer.

getState

Transfer.TransferState getState()

Returns the current state of this transfer.

返回:

The current state of this transfer.

addProgressListener

void addProgressListener(ProgressListener listener)

Adds the specified progress listener to the list of listeners receiving updates about this transfer's progress.

参数:

listener - The progress listener to add.

removeProgressListener

void removeProgressListener(ProgressListener listener)

Removes the specified progress listener from the list of progress listeners receiving updates about this transfer's progress.

参数:

listener - The progress listener to remove.

getProgress

TransferProgress getProgress()

Returns progress information about this transfer.

返回:

The progress information about this transfer.

addProgressListener

@Deprecated
void addProgressListener(ProgressListener listener)

已过时。 Replaced by addProgressListener(ProgressListener)

removeProgressListener

@Deprecated
void removeProgressListener(ProgressListener listener)

已过时。 Replaced by removeProgressListener(ProgressListener)