Table of Contents

Di——依赖注入

KernLab.Loom.Di:[ContainerService] 标注物化为 MEDI 注册代码(与手写注册不可区分), 叠加编译期装配检查与零反射装配图。容器是 MEDI 的——Di 只做物化与校验,不引入自有容器。

可运行 sample:samples/Di/App(生命周期/键控/开放泛型/装配图)。

从零跑通

[ContainerService(Lifetime.Singleton)]        // 服务类型缺省 = 唯一实现的接口
public sealed class ClockCache : IClockCache { }

// 程序集扫描到即物化——注册进 MEDI:
builder.Services.AddLoomDi();
var graph = LoomServiceCatalog.Validate();    // 零反射装配图:captive/缺登记/依赖环 编译期自检

标注一次 → 编译期生成与手写无异的 MEDI 注册代码。

声明服务

[ContainerService(Lifetime.Scoped)]
public sealed class Repo : IRepo { }

[ContainerService(Lifetime.Scoped, ServiceType = typeof(IRepo))]
public sealed class SqlRepo : IRepo, IAuditable { }          // 多接口时显式服务类型

[ContainerService(Lifetime.Transient, Default = true)]
public sealed class FallbackPolicy : IPolicy { }             // 多实现:恰一个 Default(KLSG082/083)

[ContainerService(Lifetime.Singleton, Key = "cached")]
public sealed class CachedPolicy : IPolicy { }               // 键控服务(net8 AddKeyed*)

[ContainerService(Lifetime.Singleton, Condition = "Development;Staging")]
public sealed class DevOnlyService : ISvc { }                // 档位条件:与 LoomDiProfile 交集才发射

规则:

  • 生命周期缺省 Singleton;服务类型缺省 = 唯一实现的接口(多接口须显式 ServiceType,避免意外暴露)。
  • Default:多实现中的"单解析默认者"(N 实现须恰一个 Default,否则 KLSG082/083)。
  • Condition:编译期档位(LoomDiProfile MSBuild 属性交集)——不匹配完全不发射(不是运行期 if)。
  • [SingleImplementation] / [DecoratorFor]:单实现声明 / 装饰器包装。
  • Deferred<T>:受控破环件(首次访问解析并缓存,零反射)。

装配图(LoomServiceCatalog)

var graph = LoomServiceCatalog.Validate();     // 跨程序集段落汇聚
// captive(单例依赖瞬时)/ 未登记依赖 / 依赖环 / 键控唯一性 —— 编译期或启动期自检

与 MEDI 的 ValidateOnBuild/ValidateScopes 叠加不冲突(同一意图的更早一道闸)。

诊断

KLSG080-094:标注误用(抽象类/无公共构造/服务类型缺省失败/开放泛型未闭合/Condition 非法/键控唯一性等);配置键 loom_di.* 须落 .globalconfig 节内(无节键静默失效)。

诚实边界

  • 物化在编译期(与手写注册不可区分);不支持运行期环境探测——换环境需重新编译。
  • 诊断只对本编译单元的实现发射(跨程序集边用元数据,避免消费端重复报)。