tech.ydb.table

Interface SessionRetryHandler

public interface SessionRetryHandler

Session retry helper interface to support the application-level monitoring of session operation retries.

Author:

mzinal

Field Summary

Fields

Modifier and Type	Field and Description
static SessionRetryHandler	DEFAULT
static org.slf4j.Logger	LOGGER

Method Summary

Modifier and Type	Method and Description
default String	errorMsg(Throwable t) Obtain the error message text from an exception
default void	onCancel(SessionRetryContext context, int retryNumber, long millis) Called on async operation cancellation.
default void	onError(SessionRetryContext context, StatusCode code, int retryNumber, long millis) Called on non-retryable error.
default void	onError(SessionRetryContext context, Throwable issue, int retryNumber, long millis) Called on non-retryable error as Java exception.
default void	onLimit(SessionRetryContext context, StatusCode code, int retryLimit, long millis) Called on retryable error when the limit is reached.
default void	onRetry(SessionRetryContext context, StatusCode code, int retryNumber, long next, long millis) Called on retryable status code.
default void	onRetry(SessionRetryContext context, Throwable issue, int retryNumber, long next, long millis) Called on retryable exception.
default void	onSuccess(SessionRetryContext context, int retryNumber, long millis) Called on operation success.

Field Detail

LOGGER

static final org.slf4j.Logger LOGGER

DEFAULT

static final SessionRetryHandler DEFAULT

Method Detail

onSuccess

default void onSuccess(SessionRetryContext context,
                       int retryNumber,
                       long millis)

Called on operation success.

Parameters:

context - Session retry object

retryNumber - Current number of retries

millis - Elapsed time

onCancel

default void onCancel(SessionRetryContext context,
                      int retryNumber,
                      long millis)

Called on async operation cancellation.

Parameters:

context - Session retry object

retryNumber - Current number of retries

millis - Elapsed time

onRetry

default void onRetry(SessionRetryContext context,
                     StatusCode code,
                     int retryNumber,
                     long next,
                     long millis)

Called on retryable status code.

Parameters:

context - Session retry object

code - Status code

retryNumber - Current number of retries

next - Delay before the operation will be retried.

millis - Elapsed time

onRetry

default void onRetry(SessionRetryContext context,
                     Throwable issue,
                     int retryNumber,
                     long next,
                     long millis)

Called on retryable exception.

Parameters:

context - Session retry object

issue - Retryable exception

retryNumber - Current number of retries

next - Delay before the operation will be retried.

millis - Elapsed time

onLimit

default void onLimit(SessionRetryContext context,
                     StatusCode code,
                     int retryLimit,
                     long millis)

Called on retryable error when the limit is reached.

Parameters:

context - Session retry object

code - Status code

retryLimit - Maximum number of retries

millis - Elapsed time

onError

default void onError(SessionRetryContext context,
                     StatusCode code,
                     int retryNumber,
                     long millis)

Called on non-retryable error.

Parameters:

context - Session retry object

code - Status code

retryNumber - Current number of retries

millis - Elapsed time

onError

default void onError(SessionRetryContext context,
                     Throwable issue,
                     int retryNumber,
                     long millis)

Called on non-retryable error as Java exception.

Parameters:

context - Session retry object

issue - Exception thrown

retryNumber - Current number of retries

millis - Elapsed time

errorMsg

default String errorMsg(Throwable t)

Obtain the error message text from an exception

Parameters:

t - Exception

Returns:

Error message