标注族总览(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]。跨面同名即硬冲突(不靠命名空间消歧)——新增标注前先查
家族诊断注册表。