Table of Contents

配置参考

LoomEfOptions 全键表——缺省值全部内置,不配即用配了才变;逐上下文独立实例。 上位:总览。

顶层键

键 类型 默认值 说明
ProjectStrictness EfProjectStrictness Warning 无特性投影调用点的成员校验级别
Outbox / Inbox bool false outbox/inbox 表入模型 + 存储自动注册(一宿主原则)
CompiledModel bool false 冻结模型接线(未 optimize 即开启 = fail-fast)
TablePrefix string? null 全局表名前缀(实体 [EfTable]/[EfTablePrefix] 优先)
DefaultStringLength int 256 字符串属性缺省长度(防 nvarchar(max);显式 MaxLength 跳过)
UseUtc bool true DateTime 属性 UTC 值转换(DateTimeOffset 不动)
EnumStorage LoomEnumStorage Int 枚举存储档(模板建议 String——重构插值免疫)
ShadowIndexMode LoomShadowIndexMode Default 影子列缺省索引档
AutoSeed bool false 种子托管服务(多实例竞态——显式 SeedAsync 为主)
EscapeHatches(...) 白名单 全禁 原生逃逸口逐口显式开启

Audit(审计与操作日志)

键 类型 默认值 说明
Audit.TrailSink ILoomAuditTrailSink? null 审计外发落点(AddAuditTrailSink 注册)
Audit.OutboxDefault bool true 未显式注册 sink 且 Outbox 宿主时缺省进 Outbox
Audit.DispatchFailure 派发策略 Drop sink 异常承接策略(增强面故障隔离)
Audit.AmbientPolicy LoomAuditAmbientPolicy Suppress 环境事务下的收集政策(少记不记假账)

QueryGuard(双闸执法)

键 类型 默认值 说明
QueryGuard.IgnoreQueryFiltersPolicy Off/Warn/Throw Throw 过滤器旁路运行时政策(编译期 KLSG211 恒警)

策略值参与 EF 内部服务提供者哈希——不同护栏/逃逸舱策略的容器不共享查询编译缓存(#241)。

Naming(命名策略)

键 类型 默认值 说明
Naming.Strategy LoomNamingStrategy None None/SnakeCase/UpperSnakeCase;程序集 [assembly: EfNaming] 为单一声明源,此处上下文级覆盖
Naming.CustomTransform Func<string,string>? null 自定义转换缝(设置即覆盖 Strategy)

规则与不可变纪律见命名策略。

Validation(保存校验)

键 类型 默认值 说明
Validation.Enabled bool true 缺省安全——存量脏数据保存被拒是正确行为;Off = 零开销跳过

Watch(监听消费)

键 类型 默认值 说明
Watch.RetryAttempts int 0 退避重试次数(0 = at-most-once 现状)
Watch.RetryBackoff TimeSpan 1s 重试退避基数
Watch.Timeout TimeSpan 30s 处理器执行超时放弃(超时走失败缝,原任务后台自灭)
Watch.FailureHandler ILoomWatchFailureHandler? null 失败缝 SPI(缺省 = 计数器+日志)
Watch.Queue.Enabled bool false 有界内存队列(false = 直跑兼容)
Watch.Queue.Capacity int 10_000 队列容量
Watch.Queue.FullMode LoomWatchFullMode DropNewest 满时丢弃族(Wait 排除——绝不阻塞保存)
Watch.Queue.ConsumerConcurrency int 1 消费并发(1 保序;调大 = 吞吐换乱序)
Watch.OutboxRelay bool false 可靠形态——事件同事务物化 outbox(须 Outbox 宿主,否则 fail-fast)

ReadSplit(主从读写分离)

键 类型 默认值 说明
ReadSplit.Enabled bool false 路由开关(缺省全关零介入)
ReadSplit.ReadOnly bool false 只读档——该上下文任何写入 Throw(DualContext 强隔离形态)
ReadSplit.Provider LoomReadProviderKind Fixed Fixed/RoundRobin/Weighted/Failover(或 SPI 子类)
ReadSplit.ReadConnectionStrings IReadOnlyList [] 从库连串集
ReadSplit.Weights IReadOnlyList? null Weighted 档权重(缺省均等)
ReadSplit.EnableFailover bool true 故障转移横切(冷却窗 + 全失效回主库)
ReadSplit.FailoverCooldown TimeSpan 30s 失败串冷却窗
ReadSplit.StickyEnabled bool true 写后读粘性窗开关
ReadSplit.StickyWindow TimeSpan 10s 粘性窗长

SecondLevelCache(二级缓存)

键 类型 默认值 说明
SecondLevelCache.Enabled bool true 注册缺省内存适配(false = 不注册缺省实现;查询助手在无自定义实现时 fail-fast)
SecondLevelCache.MaxEntries int 10_000 内存缓存条目上限(超限先清过期项、再按键龄淘汰)
SecondLevelCache.DefaultTimeToLive TimeSpan 5m 缺省 TTL(LoomCachedToListAsync 未显式传时)

缺省适配为进程内缓存;宿主可用 DI 注册自定义 ILoomSecondLevelCache 整体替换(分布式实现须承载跨实例失效)。语义与一致性边界见查询与投影。

观测阈值

键 类型 默认值 说明
SlowCommandThreshold / OnSlowCommand TimeSpan / 回调 1s / null 慢命令
LongTransactionThreshold / OnLongTransaction TimeSpan / 回调 10s / null 长事务
IdleTransactionThreshold TimeSpan 30s open-but-idle 判定
IdleSweepInterval TimeSpan 5s 空闲扫秒间隔(惰性启动)
SlowConnectionOpenThreshold / OnSlowConnection TimeSpan / 回调 2s / null 慢连接 Open(池耗尽/争用信号)

模型型选项与指纹

以下键进入冻结模型指纹(模型型选项 = 构建期常量性质):DefaultStringLength / UseUtc / EnumStorage / ShadowIndexMode / TablePrefix / Naming / ProjectStrictness 等——optimize 时点与运行时漂移 = fail-fast 指路(见观测·种子·迁移·冻结模型 的同源纪律)。

想深入