com.qcloud.cos.transfer

类 UploadImpl

java.lang.Object

com.qcloud.cos.transfer.AbstractTransfer

com.qcloud.cos.transfer.UploadImpl

所有已实现的接口:

Transfer, Upload

public class UploadImpl
extends AbstractTransfer
implements Upload

嵌套类概要

从接口继承的嵌套类/接口 com.qcloud.cos.transfer.Transfer

Transfer.TransferState

字段概要

从类继承的字段 com.qcloud.cos.transfer.AbstractTransfer

listenerChain, monitor, state, stateChangeListeners

构造器概要

构造器

构造器和说明
UploadImpl(String description, TransferProgress transferProgressInternalState, ProgressListenerChain progressListenerChain, TransferStateChangeListener listener)

方法概要

限定符和类型	方法和说明
void	abort() Abort the current upload operation.
PersistableUpload	getResumeableMultipartUploadId() if isResumeableMultipartUploadAfterFailed is true, we can call getResumeableMultipartUploadId to get upload info. then can resume to upload again..
boolean	isResumeableMultipartUploadAfterFailed() if multipart upload failed, whether we can upload again. if true, you can call getResumeableMultipartUploadId to get upload info. then can resume to upload again..
PersistableUpload	pause() Pause the current upload operation and returns the information that can be used to resume the upload.
PauseResult<PersistableUpload>	tryPause(boolean forceCancelTransfers) Tries to pause the current upload operation and returns the information that can be used to resume the upload.
UploadResult	waitForUploadResult() Waits for this upload to complete and returns the result of this upload.

从类继承的方法 com.qcloud.cos.transfer.AbstractTransfer

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

从类继承的方法 java.lang.Object

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

从接口继承的方法 com.qcloud.cos.transfer.Transfer

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

构造器详细资料

UploadImpl

public UploadImpl(String description,
                  TransferProgress transferProgressInternalState,
                  ProgressListenerChain progressListenerChain,
                  TransferStateChangeListener listener)

方法详细资料

waitForUploadResult

public UploadResult waitForUploadResult()
                                 throws CosClientException,
                                        CosServiceException,
                                        InterruptedException

Waits for this upload to complete and returns the result of this upload. This is a blocking call. Be prepared to handle errors when calling this method. Any errors that occurred during the asynchronous transfer will be re-thrown through this method.

指定者:

waitForUploadResult 在接口中 Upload

返回:

The result of this transfer.

抛出:

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

CosServiceException - If any errors occurred in Qcloud COS while processing the request.

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

pause

public PersistableUpload pause()
                        throws PauseException

从接口复制的说明: Upload

Pause the current upload operation and returns the information that can be used to resume the upload. Upload cannot be paused in the following cases.

• The data source is an input stream.
• Client side encryption is used.
• Server Side Encryption with customer provided key is used.
• Size of the file being uploaded is less than the TransferManagerConfiguration.getMultipartUploadThreshold().

In such cases, aborts the uploads and a PauseFailure exception is thrown

指定者:

pause 在接口中 Upload

返回:

An opaque token that holds some private state and can be used to resume a paused download operation.

抛出:

PauseException - If failed to pause the operation.

tryPause

public PauseResult<PersistableUpload> tryPause(boolean forceCancelTransfers)

从接口复制的说明: Upload

Tries to pause the current upload operation and returns the information that can be used to resume the upload. Upload cannot be paused in the following cases.

• The data source is an input stream.
• Client side encryption is used.
• Server Side Encryption with customer provided key is used.
• Size of the file being uploaded is less than the TransferManagerConfiguration.getMultipartUploadThreshold().

In such cases, aborts the uploads if forceCancelTransfers is set else No action is taken.

指定者:

tryPause 在接口中 Upload

参数:

forceCancelTransfers - a boolean to forcefully abort the existing uploads if pause cannot be done.

返回:

a result of pause operation.

abort

public void abort()

从接口复制的说明: Upload

Abort the current upload operation.

指定者:

abort 在接口中 Upload

isResumeableMultipartUploadAfterFailed

public boolean isResumeableMultipartUploadAfterFailed()

从接口复制的说明: Upload

if multipart upload failed, whether we can upload again. if true, you can call getResumeableMultipartUploadId to get upload info. then can resume to upload again..

指定者:

isResumeableMultipartUploadAfterFailed 在接口中 Upload

getResumeableMultipartUploadId

public PersistableUpload getResumeableMultipartUploadId()

从接口复制的说明: Upload

if isResumeableMultipartUploadAfterFailed is true, we can call getResumeableMultipartUploadId to get upload info. then can resume to upload again..

指定者:

getResumeableMultipartUploadId 在接口中 Upload

返回:

the PersistableUpload info if you can upload again, otherwise return null;