com.qcloud.cos.event

类 ProgressListener.ExceptionReporter

java.lang.Object

com.qcloud.cos.event.ProgressListener.ExceptionReporter

所有已实现的接口:

DeliveryMode, ProgressListener

封闭接口:

ProgressListener

public static class ProgressListener.ExceptionReporter
extends Object
implements ProgressListener, DeliveryMode

A utility class for capturing and reporting the first exception thrown by a given progress listener. Note once an exception is thrown by the underlying listener, all subsequent events will no longer be notified to the listener.

嵌套类概要

从接口继承的嵌套类/接口 com.qcloud.cos.event.ProgressListener

ProgressListener.ExceptionReporter

从接口继承的嵌套类/接口 com.qcloud.cos.event.DeliveryMode

DeliveryMode.Check

字段概要

从接口继承的字段 com.qcloud.cos.event.ProgressListener

NOOP

构造器概要

构造器

构造器和说明
ProgressListener.ExceptionReporter(ProgressListener listener)

方法概要

方法

限定符和类型	方法和说明
Throwable	getCause() Returns the underlying exception, if any; or null otherwise.
boolean	isSyncCallSafe() Returns true if it is safe to make a synchronous callback to the implementing listener without the risk of incurring undue latency; false otherwise.
void	progressChanged(ProgressEvent progressEvent) Delivers the progress event to the underlying listener but only if there has not been an exception previously thrown by the listener.
void	throwExceptionIfAny() Throws the underlying exception, if any, as an CosClientException; or do nothing otherwise.
static ProgressListener.ExceptionReporter	wrap(ProgressListener listener) Returns a wrapper for the given listener to capture the first exception thrown.

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

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

构造器详细资料

ProgressListener.ExceptionReporter

public ProgressListener.ExceptionReporter(ProgressListener listener)

方法详细资料

progressChanged

public void progressChanged(ProgressEvent progressEvent)

Delivers the progress event to the underlying listener but only if there has not been an exception previously thrown by the listener.

Called when progress has changed, such as additional bytes transferred, transfer failed, etc. The execution of the callback of this listener is managed by SDKProgressPublisher. Implementation of this interface should never block.

If the implementation follows the best practice and doesn't block, it should then extends from SyncProgressListener.

Note any exception thrown by the listener will get ignored. Should there be need to capture any such exception, you may consider wrapping the listener with wrap(ProgressListener).

指定者:

progressChanged 在接口中 ProgressListener

参数:

progressEvent - The event describing the progress change.

另请参阅:

SDKProgressPublisher, ProgressListener.ExceptionReporter

throwExceptionIfAny

public void throwExceptionIfAny()

Throws the underlying exception, if any, as an CosClientException; or do nothing otherwise.

getCause

public Throwable getCause()

Returns the underlying exception, if any; or null otherwise.

wrap

public static ProgressListener.ExceptionReporter wrap(ProgressListener listener)

Returns a wrapper for the given listener to capture the first exception thrown.

isSyncCallSafe

public boolean isSyncCallSafe()

从接口复制的说明: DeliveryMode

Returns true if it is safe to make a synchronous callback to the implementing listener without the risk of incurring undue latency; false otherwise.

指定者:

isSyncCallSafe 在接口中 DeliveryMode