配置参考
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 指路(见观测·种子·迁移·冻结模型 的同源纪律)。
想深入