Struct StructError 

pub struct StructError<T: DomainReason> { /* private fields */ }

Structured error type containing detailed error information including error source, contextual data, and debugging information.

Implementations

impl<T: DomainReason> StructError<T>

pub fn imp(&self) -> &StructErrorImpl<T>

impl<T: DomainReason> StructError<T>

pub fn new( reason: T, detail: Option<String>, position: Option<String>, context: Vec<OperationContext>, ) -> Self

impl<T: DomainReason> StructError<T>

pub fn with_source<E>(self, source: E) -> Self

where E: StdError + Send + Sync + 'static,

Attach a non-structured source error.

For StructError<_> sources, use with_struct_source(...) so metadata and structured source frames are preserved.

pub fn with_struct_source<R>(self, source: StructError<R>) -> Self

where R: DomainReason + ErrorCode + Debug + Display + Send + Sync + 'static,

pub fn source_ref(&self) -> Option<&(dyn StdError + 'static)>

pub fn root_cause(&self) -> Option<&(dyn StdError + 'static)>

pub fn source_frames(&self) -> &[SourceFrame]

pub fn root_cause_frame(&self) -> Option<&SourceFrame>

pub fn context_metadata(&self) -> ErrorMetadata

pub fn source_chain(&self) -> Vec<String>

pub fn display_chain(&self) -> String

where T: ErrorCode + Debug + Display + 'static,

pub fn render(&self, mode: RenderMode) -> String

pub fn render_redacted( &self, mode: RenderMode, policy: &impl RedactPolicy, ) -> String

impl<T: DomainReason> StructError<T>

pub fn builder(reason: T) -> StructErrorBuilder<T>

pub fn with_position(self, position: impl Into<String>) -> Self

使用示例 self.with_position(location!());

pub fn with_context(self, context: CallContext) -> Self

pub fn contexts(&self) -> &[OperationContext]

pub fn with_detail(self, detail: impl Into<String>) -> Self

pub fn err<V>(self) -> Result<V, Self>

pub fn target_main(&self) -> Option<String>

pub fn target(&self) -> Option<String>

Compatibility alias for target_main().

Prefer target_main() in new code when pairing it with target_path().

pub fn path_segments(&self) -> Vec<String>

pub fn target_path(&self) -> Option<String>

impl<T: DomainReason> StructError<T>

pub fn report(&self) -> ErrorReport

pub fn report_redacted(&self, policy: &impl RedactPolicy) -> ErrorReport

Trait Implementations

impl<T: Clone + DomainReason> Clone for StructError<T>

fn clone(&self) -> StructError<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R1, R2> ConvStructError<R2> for StructError<R1>

where R1: DomainReason, R2: DomainReason + From<R1>,

fn conv(self) -> StructError<R2>

impl<T: Debug + DomainReason> Debug for StructError<T>

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

Formats the value using the given formatter.

impl<T: DomainReason> Deref for StructError<T>

type Target = StructErrorImpl<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: Display + DomainReason + ErrorCode> Display for StructError<T>

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

Formats the value using the given formatter.

impl<T> Error for StructError<T>

where T: DomainReason + ErrorCode + Debug + Display + 'static,

fn source(&self) -> Option<&(dyn StdError + '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.

impl<T: DomainReason + ErrorCode> ErrorCode for StructError<T>

fn error_code(&self) -> i32

impl<T: DomainReason> ErrorWith for StructError<T>

fn want<S: Into<String>>(self, desc: S) -> Self

fn position<S: Into<String>>(self, pos: S) -> Self

fn with<C: Into<OperationContext>>(self, ctx: C) -> Self

impl<T> From<T> for StructError<T>

where T: DomainReason,

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: DomainReason> PartialEq for StructError<T>

fn eq(&self, other: &Self) -> 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<T: DomainReason> StructErrorTrait<T> for StructError<T>

fn get_reason(&self) -> &T

fn get_detail(&self) -> Option<&String>

fn get_target(&self) -> Option<String>

impl<R1, R2> WrapStructError<R2> for StructError<R1>

where R1: DomainReason + ErrorCode + Display + Debug + Send + Sync + 'static, R2: DomainReason,

fn wrap(self, reason: R2) -> StructError<R2>