Enum RetryHint 

pub enum RetryHint {
    Retryable,
    RetryAfterRouteRefresh,
    NonRetryable,
}

Describes whether an error instance is safe and useful to retry.

This is intentionally separate from StatusCode: status code describes the error category exposed to users, while retry hint describes retry policy for this specific error instance.

Variants

Retryable

The operation may succeed if retried later.

RetryAfterRouteRefresh

The operation may succeed after refreshing routing and partition information. The request may need rebuilding when its partition assignment changes. This hint does not imply that a failed operation had no side effects.

NonRetryable

Retrying the same operation is not expected to help.

This is the default for errors that do not explicitly opt in to retry.

Implementations

impl RetryHint

pub fn is_retryable(self) -> bool

Returns whether another attempt may succeed, possibly after refreshing routes.

pub fn as_str(self) -> &'static str

Returns the retry hint encoded in gRPC error metadata.

pub fn serialize_as_str<S>( hint: &Self, serializer: S, ) -> Result<S::Ok, S::Error>

where S: Serializer,

pub fn deserialize_from_str<'de, D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Trait Implementations

impl Clone for RetryHint

fn clone(&self) -> RetryHint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RetryHint

impl Debug for RetryHint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RetryHint

impl FromStr for RetryHint

type Err = ()

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for RetryHint

fn eq(&self, other: &RetryHint) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RetryHint