Skip to content

feat: 增加公共参考计时器值与便捷工厂 - #48

Open
CSJ608 wants to merge 2 commits into
mainfrom
feat-reference-timer-values
Open

CSJ608 wants to merge 2 commits into
mainfrom
feat-reference-timer-values

Conversation

@CSJ608

@CSJ608 CSJ608 commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

变更内容

参考 Secs4Net 的易用性做法,为公共 HsmsConnectionOptions 增加工程参考计时器值与便捷工厂,并补充应用配置绑定示例文档:

API(feat 提交)

  • ReferenceT3(45 s)/ ReferenceT5(10 s)/ ReferenceT6(5 s)/ ReferenceT7(10 s)/ ReferenceT8(5 s)静态值;
  • CreateWithReferenceTimers(...) 工厂一次性填入五个参考值,观测开关参数与显式构造函数一致。

文档(docs 提交)

  • HSMS-CONNECTION.md 新增"应用配置绑定示例":宿主应用从 appsettings.json 读取 Hsms 节,可空计时键省略时回退工程参考值,TimeSpan 标准文本格式直接绑定;构造函数继续承担全部边界校验,非法输入在启动期失败。示例明确库不依赖配置框架、改配置需重建连接。

边界声明(与仓库纪律对齐):参考值与 MIT 许可的 Secs4Net 3.1.0 实现及通行 HSMS-SS 部署实践交叉参照(SecsGemOptions 内置 T3=45000/T5=10000/T6=5000/T7=10000/T8=5000 毫秒),未经授权 SEMI E37/E37.1 副本核对,不构成标准默认值声明。XML 文档、CHANGELOG、STREAMFRAME-ADAPTER 与绑定示例均按此口径标注。显式构造路径的必填语义不变;ROADMAP 中"使用授权 E37/E37.1 核对 T5/T8 默认值"一项保持未勾选。

验证

  • dotnet build SecsFrame.slnx -c Release:0 警告 0 错误。
  • dotnet test SecsFrame.slnx -c Release --no-build:核心测试 net48 / net8.0 / net10.0 各 293 项通过(含新增 4 项:参考值黄金断言、工厂填充、观测参数透传、工厂输入校验);Secs4Net 互操作 net8.0 / net10.0 各 2 项通过。docs 提交后完整复跑一遍,结果相同。
  • 首次全量运行中 5 个真实 TCP 测试因本机并行资源竞争超时失败,隔离复跑 2 秒通过,重跑全量三个目标框架全部通过。

Marci added 2 commits October 16, 2026 10:16
HsmsConnectionOptions 新增 ReferenceT3–ReferenceT8 工程参考值与
CreateWithReferenceTimers 工厂;参考值与 MIT 许可的 Secs4Net 实现
及通行 HSMS-SS 部署实践交叉参照,未经授权 E37/E37.1 核对,不构成
标准默认值声明。显式构造路径保持必填语义不变。
HSMS-CONNECTION 增加应用配置绑定示例:宿主应用从 appsettings.json
读取 Hsms 节,可空计时键省略时回退工程参考值,构造函数继续承担
全部边界校验并让非法输入在启动期失败。示例明确库本身不依赖配置
框架,改配置需重建连接,不支持运行中调整计时器。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant