Table of Contents

标注族总览(Abstractions)

KernLab.Loom.Abstractions 是家族唯一的"运行时引用"——全部标注特性、通道/切面/装配声明 都在这里,netstandard2.0 纯定义零逻辑。生成器按 FQN 识别标注(KernLab.Loom.<Name>Attribute)。

可运行 sample:samples/Display/App(EnumDisplay)、samples/Query/App(Filterable/DSL)、samples/Ef/App(持久化)。

标注地图

面 特性 标注目标
消息线编码 [WireMessage] [WireMessageTag] [WireField] [WireMember] [WireArray] 消息类/成员
二进制布局 [BinaryLayout] [FieldOffset] [LayoutString] [LayoutTail] [LayoutArray] [LayoutUnion] [LayoutBitField] [ValidRange] [ValidEquals] [ValidHasFlags] [ValidNonDefault] 显式 struct/字段
命令行 [CommandGroup] [Command] [CommandArg] [CommandOption] [CommandBody] [CommandError] 组类/方法/参数
端点(服务端) [EndpointCommand] [EndpointQuery] [Sse] [FromLastEventId] [Aspect] 契约/端点方法/参数
依赖注入 [ContainerService] [SingleImplementation] [DecoratorFor] 实现类/接口
HTTP [HttpApi] + 七动词 [HttpGet]…[HttpOptions] + [Path]/[Query]/[Body]/[Header]/[HttpHeader] + [Multipart]/[FormUrlEncoded]/[FormField]/[FormFile] + [HttpTimeout]/[HttpRetryPolicy] 接口/方法/参数
显示名 [EnumDisplay] [DisplayDescription] 枚举/成员
查询 [Filterable] [FilterField] 实体/属性
校验 [RequiredIf] [RequiredIfNot] [ConditionalRequired] [CrossField] [LessThan]/[GreaterThan] 等条件族 端点参数
实体框架 [EfEntity] [EfColumn] [EfComment] [EfDefault] [EfComputed] [EfComplexType] [EfAuditIgnore]/[EfAuditMask] 等 实体/属性/导航

声明(非标注)类型

类型 用途
IEndpointCommand<T> / IEndpointQuery<T> 端点契约标记——路由/动词来自特性,结果类型只能由标记接口承载(特性不能泛型)
EndpointCall / EndpointVerb / IEndpointChannel 端点调用通道:底层只声明"要发生一次调用/一次流",传输/选址/线格式全归实现方
IHttpApi<TResult> [HttpApi] 记录子集契约标记(生成 IEndpointChannel 扩展方法)
IAspect / AspectContext / AspectContinuation 通用切面三件(编译期织入,切面实例解析自 DI)
Lifetime / LoomServiceNode / LoomServiceCatalog Di 装配图目录:跨程序集段落汇聚 + 零反射 Validate()
Deferred<T> 受控破环件:首次访问解析并缓存(零反射)
ILoomDbContext / ILoomUowParticipant / ITenantEntity 等 EF 运行时契约(审计/租户/工作单元)

零冲突命名纪律

标注词按"规范所有者"分配:[Command] 归 Cli(CLI 的"命令"是行业标准词),端点面用 [EndpointCommand]。跨面同名即硬冲突(不靠命名空间消歧)——新增标注前先查 家族诊断注册表。