Enum RdiError 

#[non_exhaustive]
pub enum RdiError {
    ServiceNotFound {
        ty: &'static str,
        context: Option<String>,
    },
    KeyedServiceNotFound {
        key: String,
        ty: &'static str,
        context: Option<String>,
    },
    CircularDependency(String),
    SingletonDependsOnScoped {
        singleton: String,
        scoped: String,
    },
    FactoryPanic {
        service: String,
        payload: String,
    },
    OwnedNotSupported(&'static str),
    AsyncServiceRequiresBuildAsync {
        service: String,
    },
    AsyncServiceRequiresGetAsync {
        service: String,
    },
    SyncSingletonDependsOnAsyncService {
        singleton: String,
        async_service: String,
    },
    ScopedFromRootProvider {
        service: String,
    },
    ProviderDisposed,
    ScopeDisposed,
}

Errors returned by the container.

The enum is #[non_exhaustive]: future releases may add variants without a semver-major break. Match with a wildcard arm (_ => …) when handling errors.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ServiceNotFound

Fields

ty: &'static str

context: Option<String>

KeyedServiceNotFound

Fields

key: String

ty: &'static str

context: Option<String>

CircularDependency(String)

SingletonDependsOnScoped

Fields

singleton: String

scoped: String

FactoryPanic

Fields

service: String

payload: String

OwnedNotSupported(&'static str)

AsyncServiceRequiresBuildAsync

Fields

service: String

AsyncServiceRequiresGetAsync

Fields

service: String

SyncSingletonDependsOnAsyncService

同步 singleton 依赖 async singleton（build 期检测）。

同步构造函数无法 await，因此该依赖方向在架构上不成立：请把依赖方也改为 async singleton，或在方法内用 ScopeFactory / get_async 延迟解析。

Fields

singleton: String

async_service: String

ScopedFromRootProvider

严格 scope 校验下从 root provider 解析 Scoped 服务。

等价于 MEDI ValidateScopes 的 InvalidOperationException("Cannot resolve scoped service from root provider.")。

Fields

service: String

ProviderDisposed

provider 已被显式 dispose 或已销毁。

ScopeDisposed

scope 已被显式 dispose 或 Drop 释放。

Implementations

impl RdiError

pub fn not_found(ty: &'static str, context: impl Into<Option<String>>) -> Self

Build a ServiceNotFound with an optional consumer context.

pub fn keyed_not_found( ty: &'static str, key: impl Into<String>, context: impl Into<Option<String>>, ) -> Self

Build a KeyedServiceNotFound with optional context.

pub fn scoped_from_root(service: &'static str) -> Self

Build a ScopedFromRootProvider for service.

pub fn is_circular(&self) -> bool

Whether this error (or a wrapping FactoryPanic) represents a dependency cycle.

When a user factory unwrap()s a nested CircularDependency, the top-level build error is a FactoryPanic whose payload contains the CircularDependency rendering. This helper is a heuristic: it also matches a FactoryPanic whose (user-provided) payload happens to contain that text. Prefer matching the typed variants directly when available.

pub fn from_panic_payload(service: &str, payload: Box<dyn Any + Send>) -> Self

Convert a panic::catch_unwind payload into RdiError.

Prefers a panicked RdiError (from inject constructors via panic_any), then string payloads, otherwise wraps as FactoryPanic.

Trait Implementations

impl Clone for RdiError

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 RdiError

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

Formats the value using the given formatter.

impl Display for RdiError

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

Formats the value using the given formatter.

impl Error for RdiError

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.