Crate dris_rt

Crate dris_rt 

Source
Expand description

§dris-rt

dris-rt 是 dris 依赖注入（DI）代码生成器的运行时支持库，配合 dris-macros 与 dris-build 使用。

§快速开始

[dependencies]
dris-rt = "0.1.1"

[build-dependencies]
dris-build = "0.1.1"

在 build.rs 中生成容器代码：

ⓘ
fn main() {
    dris_build::generate().unwrap();
}

声明组件与构造函数，并引入生成文件：

ⓘ
use dris_rt::{component, constructor};

#[component(singleton)]
pub struct AppConfig {
    pub port: u16,
}

impl AppConfig {
    #[constructor]
    pub fn new() -> Self {
        Self { port: 8080 }
    }
}

include!(concat!(env!("OUT_DIR"), "/dris_gen.rs"));

fn main() {
    let container = dris_gen::Container::build();
    let cfg = container.app_config(); // root getter
    println!("port={}", cfg.port);
}

§注入类型（四种基本形态）

支持：

  • T：按值注入（通常用于 Prototype）。
  • &T：借用注入（零开销；仅支持 Singleton）。
  • Rc<T>：单线程共享所有权。
  • Arc<T>：跨线程共享所有权。

§单例持有方式的推断

生成器会按“实际被注入的类型”推断单例在 Container 内部的持有方式：

  • 只用到 &T → Container 内存 T（读路径零开销）。
  • 某处需要 Rc<T> → Container 内存 Rc<T>。
  • 某处需要 Arc<T> → Container 内存 Arc<T>。
  • 同一类型同时要求 Rc<T> 与 Arc<T> → 直接报错（无法保证同一实例同时以两种指针形式存在）。

§作用域（Prototype / Singleton）

  • Prototype：每次获取都会构建新实例。
  • Singleton：容器构建时只构建一次并复用。

常用方式：

  • #[component(singleton)] 强制单例。

§约束与建议

  • dris-build 不做 cfg 条件裁剪（会解析 src/**/*.rs），因此当前版本不支持在 cfg/cfg_attr 作用域里声明组件/构造函数（包括 #[cfg_attr(..., component/constructor)]）。建议把 cfg 放在实现细节里，不要切换组件类型/构造函数本身。
  • Arc/Rc<dyn Trait> 注入：当且仅当某个 trait 只有一个实现时可直接注入；多个实现请用 dris_rt::All<Arc/Rc<dyn Trait>>（或 dris_rt::All<(dris_rt::Type, Arc/Rc<dyn Trait>)>）。

Structs§

All
Type

Attribute Macros§

component
constructor