com.qcloud.cos.event

类 SDKProgressPublisher

java.lang.Object

com.qcloud.cos.event.SDKProgressPublisher

直接已知子类:

COSProgressPublisher

public class SDKProgressPublisher
extends Object

This class is responsible for executing the callback method of ProgressListener; listener callbacks are executed sequentially in a separate single thread.

字段概要

字段

限定符和类型	字段和说明
protected static boolean	ASYNC
protected static boolean	SYNC

构造器概要

构造器

构造器和说明
SDKProgressPublisher()

方法概要

方法

限定符和类型	方法和说明
protected static ExecutorService	getExecutorService() Returns the executor service used for performing the callbacks.
static Future<?>	publishProgress(ProgressListener listener, ProgressEventType type) Used to deliver a progress event to the given listener.
static Future<?>	publishRequestBytesTransferred(ProgressListener listener, long bytes) Convenient method to publish a request byte transfer event to the given listener.
static Future<?>	publishRequestContentLength(ProgressListener listener, long bytes) Convenient method to publish a request content length event to the given listener.
static Future<?>	publishRequestReset(ProgressListener listener, long bytesReset) Convenient method to publish a request reset event to the given listener.
static Future<?>	publishResponseBytesDiscarded(ProgressListener listener, long bytesDiscarded) Convenient method to publish a response bytes discard event to the given listener.
static Future<?>	publishResponseBytesTransferred(ProgressListener listener, long bytes) Convenient method to publish a response byte transfer event to the given listener.
static Future<?>	publishResponseContentLength(ProgressListener listener, long bytes) Convenient method to publish a response content length event to the given listener.
static Future<?>	publishResponseReset(ProgressListener listener, long bytesReset) Convenient method to publish a response reset event to the given listener.
protected static Future<?>	setLatestFutureTask(Future<?> f)
static void	shutdown(boolean now) Can be used to shutdown the (legacy) executor.
static void	waitTillCompletion() 已过时。

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

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

字段详细资料

SYNC

protected static final boolean SYNC

另请参阅:

常量字段值

ASYNC

protected static final boolean ASYNC

另请参阅:

常量字段值

构造器详细资料

SDKProgressPublisher

public SDKProgressPublisher()

方法详细资料

publishProgress

public static Future<?> publishProgress(ProgressListener listener,
                        ProgressEventType type)

Used to deliver a progress event to the given listener.

返回:

the future of a submitted task; or null if the delivery is synchronous with no future task involved. Note a listener should never block, and therefore returning null is the typical case.

publishRequestContentLength

public static Future<?> publishRequestContentLength(ProgressListener listener,
                                    long bytes)

Convenient method to publish a request content length event to the given listener.

参数:

listener - must not be null or else the publication will be skipped

bytes - must be non-negative or else the publication will be skipped

publishResponseContentLength

public static Future<?> publishResponseContentLength(ProgressListener listener,
                                     long bytes)

Convenient method to publish a response content length event to the given listener.

参数:

listener - must not be null or else the publication will be skipped

bytes - must be non-negative or else the publication will be skipped

publishRequestBytesTransferred

public static Future<?> publishRequestBytesTransferred(ProgressListener listener,
                                       long bytes)

Convenient method to publish a request byte transfer event to the given listener.

参数:

listener - must not be null or else the publication will be skipped

bytes - must be non-negative or else the publication will be skipped

publishResponseBytesTransferred

public static Future<?> publishResponseBytesTransferred(ProgressListener listener,
                                        long bytes)

Convenient method to publish a response byte transfer event to the given listener.

参数:

listener - must not be null or else the publication will be skipped

bytes - must be non-negative or else the publication will be skipped

publishRequestReset

public static Future<?> publishRequestReset(ProgressListener listener,
                            long bytesReset)

Convenient method to publish a request reset event to the given listener.

参数:

listener - must not be null or else the publication will be skipped

bytesReset - must be non-negative or else the publication will be skipped

publishResponseReset

public static Future<?> publishResponseReset(ProgressListener listener,
                             long bytesReset)

Convenient method to publish a response reset event to the given listener.

publishResponseBytesDiscarded

public static Future<?> publishResponseBytesDiscarded(ProgressListener listener,
                                      long bytesDiscarded)

Convenient method to publish a response bytes discard event to the given listener.

getExecutorService

protected static ExecutorService getExecutorService()

Returns the executor service used for performing the callbacks.

setLatestFutureTask

protected static Future<?> setLatestFutureTask(Future<?> f)

waitTillCompletion

@Deprecated
public static void waitTillCompletion()
                               throws InterruptedException,
                                      ExecutionException

已过时。

For internal testing and backward compatibility only. This method blocks until all the submitted callbacks are executed. Listeners should never block so this method should never be used.

抛出:

InterruptedException

ExecutionException

shutdown

public static void shutdown(boolean now)

Can be used to shutdown the (legacy) executor.

However, the recommended best practice is to always make use of progress listeners that are short-lived (ie do not block) and are subclasses of SyncProgressListener. That way, the progress publisher (legacy) thread will never be activated in the first place.

参数:

now - true if shutdown now; false otherwise.