com.alicloud.openservices.tablestore.model

类 DefaultRetryStrategy

java.lang.Object

com.alicloud.openservices.tablestore.model.DefaultRetryStrategy

所有已实现的接口:

RetryStrategy

public class DefaultRetryStrategy
extends Object
implements RetryStrategy

TableStore SDK支持自定义重试逻辑RetryStrategy, 重试逻辑用于判断在发生异常时是否需要重试, 并给出本次重试的时间间隔. DefaultRetryStrategy为TableStore SDK默认的重试逻辑.

构造器概要

构造器

构造器和说明
DefaultRetryStrategy()
DefaultRetryStrategy(long timeout, TimeUnit unit)

方法概要

限定符和类型	方法和说明
RetryStrategy	clone() 返回一个同类型且尚未重试的RetryStrategy对象。
int	getRetries() 返回当前重试的次数
long	nextPause(String action, Exception ex) 得到发起第retries次重试前延迟的时间。
boolean	shouldRetry(String action, Exception ex) SDK提供的默认重试策略，规则为： 1.

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

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

构造器详细资料

DefaultRetryStrategy

public DefaultRetryStrategy()

DefaultRetryStrategy

public DefaultRetryStrategy(long timeout,
                            TimeUnit unit)

方法详细资料

clone

public RetryStrategy clone()

从接口复制的说明: RetryStrategy

返回一个同类型且尚未重试的RetryStrategy对象。

指定者:

clone 在接口中 RetryStrategy

覆盖:

clone 在类中 Object

返回:

同类型且尚未重试的RetryStrategy对象。

getRetries

public int getRetries()

从接口复制的说明: RetryStrategy

返回当前重试的次数

指定者:

getRetries 在接口中 RetryStrategy

返回:

当前重试的次数

shouldRetry

public boolean shouldRetry(String action,
                           Exception ex)

SDK提供的默认重试策略，规则为： 1. 若异常为TableStoreException，且错误码为OTSRowOperationConflict, OTSNotEnoughCapacityUnit, OTSTableNotReady, OTSPartitionUnavailable或OTSServerBusy，则可以重试。 2. 若异常为OTSQuotaExhausted且异常消息为"Too frequent table operations."，则可以重试。 3. 若异常为ClientException（网络类异常），且操作是幂等的，则可以重试。 4. 若异常为OTSTimeout, OTSInternalServerError, OTSServerUnavailable, OTSTunnelServerUnavailable或http状态码为500， 502或503，且操作为幂等的，则可以重试。 5. 若操作为Batch操作，只有所有失败的行可重试时，批量操作才可以重试 默认的重试策略会把所有读相关的操作认为是幂等的，而所有写相关的操作会被认为是非幂等的，若用户对写有重试的需求，需要定制重试策略。

参数:

action - 操作名，比如"ListTable"、"GetRow"、"PutRow"等

ex - 上次访问失败的错误信息、为ClientException或OTSException

返回:

nextPause

public long nextPause(String action,
                      Exception ex)

从接口复制的说明: RetryStrategy

得到发起第retries次重试前延迟的时间。SDK会在这一段时间之后发起第retries次重试。 若返回值小于等于0, 表示不重试.

指定者:

nextPause 在接口中 RetryStrategy

参数:

action - 操作名，比如"ListTable"、"GetRow"、"PutRow"等

ex - 上次访问失败的错误信息、为ClientException或TableStoreException

返回:

发起第retries次重试前延迟的时间（单位毫秒）。小于等于0表示不可重试。