跳到主要内容

RegisterNodes / UnregisterNodes

RegisterNodes 服务把客户端常用的 NodeId 注册到服务端, 服务端返回临时高效 NodeId (生命周期 = Session). 后续 Read / Write / MonitoredItem 用这个临时 ID 比原始 NodeId 快得多 (服务端跳过完整 NodeId 解析).

适用判断
  • 单次脚本 → 不需要
  • 长期运行高频访问相同节点 → 强烈推荐
  • 大规模 SCADA 1000+ Tag 持续监控 → 必须

签名​

std::vector<std::string> RegisterNodes(std::vector<std::string> const& node_ids);
Status                   UnregisterNodes(std::vector<std::string> const& registered_node_ids);

用法​

// 1. 应用启动时注册
std::vector<std::string> orig = {
    "ns=2;s=Plant.Line1.Sensor.Temperature",
    "ns=2;s=Plant.Line1.Sensor.Pressure",
    "ns=2;s=Plant.Line1.Sensor.FlowRate",
};
auto temp = s.RegisterNodes(orig);
// temp 现在是服务端给的临时 ID, 类似 "i=99001", "i=99002", "i=99003"

// 2. 后续高频访问用临时 ID (快得多)
for (int i = 0; i < 10000; ++i) {
    auto dv = s.Read(temp[0]);
    // 比 Read("ns=2;s=Plant.Line1.Sensor.Temperature") 快
}

// 3. 应用退出前释放
s.UnregisterNodes(temp);

何时用​

场景必要性
单次脚本, 100 个节点低 (省的开销可忽略)
长期运行, 高频访问相同节点高 (省时显著)
大规模 SCADA, 1000+ Tag 持续监控必须

性能数据​

服务端 NodeId 解析的耗时取决于实现:

  • 数字 NodeId (i=2258) 通常 O(1) 哈希查找 — RegisterNodes 收益小
  • 字符串 NodeId 长路径 (ns=2;s=Plant.Line1.Sensor.Temperature) — 服务端可能 O(n) 字符串解析, RegisterNodes 收益大 (典型 30-50% 加速)

注意​

  • 注册的临时 ID 只在当前 Session 有效, Disconnect 后失效
  • Session 重连后 (TransferSubscriptions) 临时 ID 通常仍有效, 但保险起见重新 Register
  • 不释放的临时 ID 会随 Session 关闭自动 GC, 但显式 Unregister 是好习惯

下一步​