Struct Scope 

pub struct Scope { /* private fields */ }

A scoped service provider — created via ServiceProvider::scope.

内部持有一个 scope 范围的 ServiceProvider（由 ServiceProvider::new_scope 派生）， 共享 root 的 store/singleton_cache/named，独立 root_scoped_cache。

所有解析方法委托给内嵌的 scope_provider，确保：

• Scoped 服务在 scope 内缓存复用（命中 scope_provider.root_scoped_cache）。
• Transient 依赖通过 scope_provider 解析，正确绑定到当前 scope（MEDI 语义）。
• #[inject(provider)] 字段拿到的是 scope 范围的 provider，经该字段解析 Scoped 服务命中 scope 缓存——不泄漏到 root。

资源释放

当 Scope 被 drop 时，其内部的 scope_provider 被释放，scoped 缓存中的 Arc<T> 实例随之释放。若服务需要确定性资源释放（如关闭数据库连接）， 可在工厂内通过 ServiceProvider::register_disposable 注册清理闭包， 并调用 Scope::dispose 在 scope 结束前执行显式清理。

Implementations

impl Scope

pub fn scope_provider(&self) -> &Arc<ServiceProvider>

Returns the scope-local ServiceProvider backing this scope.

Exposed for advanced use cases (e.g. passing the scope provider to ServiceProviderWrapper). Most callers should use Self::get / Self::get_owned directly.

pub fn dispose(&self)

Explicitly dispose all scoped services registered via ServiceProvider::register_disposable.

Services that need deterministic cleanup (e.g., database connections, file handles) should register a cleanup closure in their factory:

.scoped(|r| {
    let conn = Arc::new(DbConnection::connect());
    let conn_clone = Arc::clone(&conn);
    r.provider_arc().unwrap().register_disposable(Box::new(move || {
        conn_clone.close();
    }));
    conn
})

Called automatically on Drop as a safety net. If Drop runs while a concurrent resolution is in progress (factory holding the disposable lock), disposal is skipped — some cleanups may be delayed or dropped. For deterministic cleanup, call this explicitly before the scope goes out of scope.

pub fn get<T: ?Sized + Send + Sync + 'static>(&self) -> Result<Arc<T>, RdiError>

pub fn get_optional<T: ?Sized + Send + Sync + 'static>(&self) -> Option<Arc<T>>

pub fn get_keyed<T: ?Sized + Send + Sync + 'static>( &self, key: &str, ) -> Result<Arc<T>, RdiError>

pub async fn get_async<T: ?Sized + Send + Sync + 'static>( &self, ) -> Result<Arc<T>, RdiError>

Resolve an async service (transient or scoped) within this scope.

pub async fn get_keyed_async<T: ?Sized + Send + Sync + 'static>( &self, key: &str, ) -> Result<Arc<T>, RdiError>

Resolve an async keyed service within this scope.

pub fn get_owned<T: Send + Sync + 'static>(&self) -> Result<T, RdiError>

Resolve owned T within this scope (bypass cache, fresh each call). Returns Err if not registered or the service is Singleton.

pub fn try_get_owned<T: Send + Sync + 'static>(&self) -> Option<T>

Resolve owned T, returning None if not registered or Singleton.

pub fn get_keyed_owned<T: Send + Sync + 'static>( &self, key: &str, ) -> Result<T, RdiError>

Resolve owned keyed T. Returns Err if not found or Singleton.

pub fn try_get_keyed_owned<T: Send + Sync + 'static>( &self, key: &str, ) -> Option<T>

Resolve owned keyed T, returning None if not found or Singleton.

pub fn get_all<T: ?Sized + Send + Sync + 'static>(&self) -> Vec<Arc<T>>

pub fn get_named_any(&self, name: &str) -> Option<Arc<dyn Any + Send + Sync>>

pub fn rdi_register_named( &self, name: &str, service: Arc<dyn Any + Send + Sync>, )

Register a named service (for IProvider trait).

pub fn rdi_remove_named(&self, name: &str)

Remove a named service (for IProvider trait).

Trait Implementations

impl Drop for Scope

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl IProvider for Scope

fn get_named_any(&self, name: &str) -> Option<Arc<dyn Any + Send + Sync>>

fn rdi_register_named(&self, name: &str, service: Arc<dyn Any + Send + Sync>)

fn rdi_remove_named(&self, name: &str)

impl IServiceResolver for Scope

fn get_any(&self, key: &str) -> Option<Arc<dyn Any + Send + Sync>>

fn get_keyed_any( &self, key: &str, variant: &str, ) -> Option<Arc<dyn Any + Send + Sync>>

fn get_by_type_id(&self, tid: TypeId) -> Option<Arc<dyn Any + Send + Sync>>

TypeId 直查（默认 None，ServiceProvider 等覆盖为 O(1) 直查）。

fn get_keyed_by_type_id( &self, tid: TypeId, key: &str, ) -> Option<Arc<dyn Any + Send + Sync>>

TypeId 直查 keyed 版本（默认 None）。

fn get_all_any(&self, key: &str) -> Vec<Arc<dyn Any + Send + Sync>>

Type-erased polymorphic resolution: return all registered instances (default + keyed) of the given type.

fn get_owned_any(&self, key: &str) -> Option<Arc<dyn Any + Send + Sync>>

Type-erased owned resolution: bypass cache, call factory fresh, return Arc<dyn Any + Send + Sync> (concrete Arc<Arc<T>>).

fn get_keyed_owned_any( &self, key: &str, variant: &str, ) -> Option<Arc<dyn Any + Send + Sync>>

fn provider_arc(&self) -> Option<Arc<ServiceProvider>>

Return an Arc<ServiceProvider> for on-demand service resolution.

fn get<T: ?Sized + Sync + Send + 'static>(&self) -> Result<Arc<T>, RdiError>

where Self: Sized,

Resolve a service by type (concrete or dyn Trait). Returns Err(RdiError::ServiceNotFound) if not registered.

fn try_get<T: ?Sized + Sync + Send + 'static>(&self) -> Option<Arc<T>>

where Self: Sized,

Resolve a service by type, returning None if not registered.

fn get_keyed<T: ?Sized + Sync + Send + 'static>( &self, variant: &str, ) -> Result<Arc<T>, RdiError>

where Self: Sized,

Resolve a keyed service by type and key. Returns Err if not found.

fn try_get_keyed<T: ?Sized + Sync + Send + 'static>( &self, variant: &str, ) -> Option<Arc<T>>

where Self: Sized,

Resolve a keyed service by type and key, returning None if not found.

fn get_all<T: ?Sized + Sync + Send + 'static>(&self) -> Vec<Arc<T>>

where Self: Sized,

Resolve all registered instances of T (default + keyed).

fn get_owned<T: Send + Sync + 'static>(&self) -> Result<T, RdiError>

where Self: Sized,

Resolve owned T (bypass cache, fresh each call). Returns Err if not registered or the service is Singleton.

fn try_get_owned<T: Send + Sync + 'static>(&self) -> Option<T>

where Self: Sized,

Resolve owned T, returning None if not registered or Singleton.

fn get_keyed_owned<T: Send + Sync + 'static>( &self, variant: &str, ) -> Result<T, RdiError>

where Self: Sized,

Resolve owned keyed T. Returns Err if not found or Singleton.

fn try_get_keyed_owned<T: Send + Sync + 'static>( &self, variant: &str, ) -> Option<T>

where Self: Sized,

Resolve owned keyed T, returning None if not found or Singleton.