Struct StructError 

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

Structured runtime error carrier with explicit bridge APIs for the standard error ecosystem.

use orion_error::{StructError, UvsReason};

let err = StructError::from(UvsReason::system_error());
let _ = std::error::Error::source(&err);

use orion_error::{StructError, UvsReason};

let err = StructError::from(UvsReason::system_error());
let bridged = err.as_std();
let _ = std::error::Error::source(&bridged);

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 attach_source<S>(self, source: S) -> Self

where S: IntoSourcePayload,

Attach any source that can be converted into the dual-channel source payload model.

Ordinary StdError values attach as SourcePayloadKind::Std, while StructError<_> attaches as SourcePayloadKind::Struct.

pub fn with_std_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_source<S>(self, source: S) -> Self

where S: IntoSourcePayload,

Recommended helper that auto-routes either a standard source error or an existing StructError<_> through the dual-channel source model.

Use with_std_source(...) / with_struct_source(...) instead when the call site should make the source kind explicit.

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 source_payload(&self) -> Option<SourcePayloadRef<'_>>

pub fn source_payload_kind(&self) -> Option<SourcePayloadKind>

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

pub fn context_metadata(&self) -> ErrorMetadata

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

pub fn into_std(self) -> OwnedStdStructError<T>

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

pub fn into_boxed_std(self) -> Box<dyn StdError + Send + Sync + 'static>

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

pub fn into_dyn_std(self) -> OwnedDynStdStructError

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

pub fn as_std(&self) -> StdStructRef<'_, T>

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

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<C: Into<OperationContext>>(self, context: C) -> 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 action_main(&self) -> Option<String>

pub fn locator_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) -> DiagnosticReport

pub fn into_report(self) -> DiagnosticReport

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

impl<T> StructError<T>

where T: DomainReason + ErrorIdentityProvider,

pub fn exposure_view(&self) -> ExposureView

pub fn into_exposure_view(self) -> ExposureView

pub fn exposure_snapshot( &self, exposure_policy: &impl ExposurePolicy, ) -> ErrorProtocolSnapshot

pub fn into_exposure_snapshot( self, exposure_policy: &impl ExposurePolicy, ) -> ErrorProtocolSnapshot

pub fn http_response( &self, exposure_policy: &impl ExposurePolicy, ) -> ErrorHttpResponse

pub fn cli_response( &self, exposure_policy: &impl ExposurePolicy, ) -> ErrorCliResponse

pub fn log_response( &self, exposure_policy: &impl ExposurePolicy, ) -> ErrorLogResponse

pub fn rpc_response( &self, exposure_policy: &impl ExposurePolicy, ) -> ErrorRpcResponse

pub fn render_user_debug(&self, exposure_policy: &impl ExposurePolicy) -> String

pub fn render_user_debug_redacted( &self, exposure_policy: &impl ExposurePolicy, redact_policy: &impl RedactPolicy, ) -> String

pub fn render_debug_summary( &self, exposure_policy: &impl ExposurePolicy, ) -> String

impl<T: DomainReason> StructError<T>

pub fn snapshot(&self) -> ErrorSnapshot

pub fn into_snapshot(self) -> ErrorSnapshot

impl<T> StructError<T>

where T: DomainReason + ErrorIdentityProvider,

pub fn identity_snapshot(&self) -> ErrorIdentity

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: DomainReason + ErrorCode> ErrorCode for StructError<T>

fn error_code(&self) -> i32

impl<T> ErrorIdentityProvider for StructError<T>

where T: DomainReason + ErrorIdentityProvider,

fn stable_code(&self) -> &'static str

fn error_category(&self) -> ErrorCategory

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

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

👎Deprecated since 0.7.0:

use doing(…) for action contexts; use at(…) for locator/resource contexts

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

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

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

where Self: Sized,

👎Deprecated since 0.7.0:

use with_context(…) for full context frames; use doing(…) / at(…) for semantic context helpers

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

where Self: Sized,

👎Deprecated since 0.7.0:

use with_context(…) for full context frames; use at(…) / doing(…) for semantic context helpers

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

where Self: Sized,

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

where Self: Sized,

impl<'a, R> From<&'a StructError<R>> for StdStructRef<'a, R>

where R: DomainReason,

fn from(value: &'a StructError<R>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<&StructError<T>> for DiagnosticReport

fn from(value: &StructError<T>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<&StructError<T>> for ErrorSnapshot

fn from(value: &StructError<T>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<&StructError<T>> for StableErrorSnapshot

fn from(value: &StructError<T>) -> Self

Converts to this type from the input type.

impl<R> From<StructError<R>> for OwnedDynStdStructError

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

fn from(value: StructError<R>) -> Self

Converts to this type from the input type.

impl<R> From<StructError<R>> for OwnedStdStructError<R>

where R: DomainReason,

fn from(value: StructError<R>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<StructError<T>> for DiagnosticReport

fn from(value: StructError<T>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<StructError<T>> for ErrorSnapshot

fn from(value: StructError<T>) -> Self

Converts to this type from the input type.

impl<T: DomainReason> From<StructError<T>> for StableErrorSnapshot

fn from(value: StructError<T>) -> Self

Converts to this type from the input type.

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

where T: DomainReason,

fn from(value: T) -> Self

Converts to this type from the input type.

impl<R> IntoSourcePayload for StructError<R>

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

fn into_source_payload(self) -> SourcePayload

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<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>

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

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

fn wrap_as(self, reason: R2, detail: impl Into<String>) -> StructError<R2>