Struct RuntimeError 

pub struct RuntimeError { /* private fields */ }

Stable, catalog-backed operational runtime failure.

The facade exposes descriptor identity, a matchable RuntimeErrorKind, closed operation/component labels, a bounded context and an optional typed source. It intentionally does not expose implementation variants.

Implementations

impl RuntimeError

pub fn descriptor(&self) -> &'static ErrorDescriptor

Returns the catalog descriptor.

pub fn code(&self) -> ErrorCode

Returns the stable catalog code.

pub fn condition(&self) -> CanonicalCondition

Returns the descriptor-owned canonical condition.

pub fn recovery_hint(&self) -> RecoveryHint

Returns the descriptor-owned recovery hint.

pub const fn kind(&self) -> RuntimeErrorKind

Returns why the operation failed.

pub const fn operation(&self) -> RuntimeOperation

Returns the closed operation label.

pub fn component(&self) -> &str

Returns the closed runtime component label.

pub fn context(&self) -> &ErrorContext

Returns bounded descriptor context.

pub fn location(&self) -> &'static Location<'static>

Returns the first-promotion caller location.

pub fn backtrace(&self) -> Option<&Backtrace>

Returns the catalog-controlled captured backtrace, when enabled.

pub fn public_view(&self) -> Result<PublicErrorView<'_>, ViewContextViolation>

Creates a safe public projection when the context matches the descriptor.

Errors

Returns an error only if an internal descriptor/context invariant has been violated.

pub fn diagnostic_view( &self, ) -> Result<DiagnosticView<'_>, ViewContextViolation>

Creates a controlled diagnostic projection when the context matches the descriptor.

Errors

Returns an error only if an internal descriptor/context invariant has been violated.

pub fn configuration(operation: RuntimeOperation) -> Self

Creates an external configuration failure.

pub fn configuration_failure( operation: RuntimeOperation, source: impl Error + Send + Sync + 'static, ) -> Self

Creates a configuration-loading failure while retaining its typed source.

pub fn build(operation: RuntimeOperation, source: Error) -> Self

Creates a runtime-build failure while retaining the build source.

pub fn io(operation: RuntimeOperation, source: Error) -> Self

Creates an I/O failure while retaining the I/O source.

pub fn context_unavailable(operation: RuntimeOperation) -> Self

Creates a runtime-context-unavailable failure.

pub fn closed(operation: RuntimeOperation) -> Self

Creates a failure for an owner, operation or worker that no longer admits work.

It shares the runtime.context.unavailable descriptor with Self::context_unavailable; Self::kind reports RuntimeErrorKind::Closed.

pub fn capacity(operation: RuntimeOperation) -> Self

Creates an operational capacity-exhausted failure.

pub fn timed_out(operation: RuntimeOperation) -> Self

Creates an operation timeout failure.

pub fn unsupported(operation: RuntimeOperation) -> Self

Creates an unsupported-operation failure.

pub fn join(operation: RuntimeOperation, source: JoinError) -> Self

Creates a task join failure while retaining the join source.

pub fn internal( operation: RuntimeOperation, source: impl Error + Send + Sync + 'static, ) -> Self

Creates an internal runtime failure while retaining a typed source.

pub fn internal_failure(operation: RuntimeOperation) -> Self

Creates a source-free internal runtime failure.

Trait Implementations

impl Clone for RuntimeError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

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.

impl From<Error> for RuntimeError

fn from(source: Error) -> Self

Converts to this type from the input type.