Struct DataError 

#[non_exhaustive]
pub struct DataError {
    pub kind: DataErrorKind,
    pub message: String,
}

Classified datasource failure — callers can finally distinguish “retry somewhere else” from “this will never work”, which retry policies, circuit breakers, and replica failover need.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

kind: DataErrorKind

message: String

Implementations

impl DataError

pub fn new(kind: DataErrorKind, message: impl Into<String>) -> Self

pub fn config(m: impl Into<String>) -> Self

pub fn connection(m: impl Into<String>) -> Self

pub fn query(m: impl Into<String>) -> Self

pub fn timeout(m: impl Into<String>) -> Self

pub fn conflict(m: impl Into<String>) -> Self

pub fn other(m: impl Into<String>) -> Self

pub fn is_retryable(&self) -> bool

true when a retry (or replica failover) can plausibly succeed.

Trait Implementations

impl Debug for DataError

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

Formats the value using the given formatter.

impl Display for DataError

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

Formats the value using the given formatter.

impl Error for DataError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.