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:编译期档位(LoomDiProfileMSBuild 属性交集)——不匹配完全不发射(不是运行期 if)。[SingleImplementation]/[DecoratorFor]:单实现声明 / 装饰器包装。Deferred<T>:受控破环件(首次访问解析并缓存,零反射)。
装配图(LoomServiceCatalog)
var graph = LoomServiceCatalog.Validate(); // 跨程序集段落汇聚
// captive(单例依赖瞬时)/ 未登记依赖 / 依赖环 / 键控唯一性 —— 编译期或启动期自检
与 MEDI 的 ValidateOnBuild/ValidateScopes 叠加不冲突(同一意图的更早一道闸)。
诊断
KLSG080-094:标注误用(抽象类/无公共构造/服务类型缺省失败/开放泛型未闭合/Condition 非法/键控唯一性等);配置键 loom_di.* 须落 .globalconfig 节内(无节键静默失效)。
诚实边界
- 物化在编译期(与手写注册不可区分);不支持运行期环境探测——换环境需重新编译。
- 诊断只对本编译单元的实现发射(跨程序集边用元数据,避免消费端重复报)。