Namespaces — s.NamespacesRef()

OPC UA 节点 NodeId 由 NamespaceIndex + Identifier 组成, 但 NamespaceIndex 不稳定 — Server 重启可能改变. 生产代码必须用 NamespaceUri 反查 Index, 不能硬编码 ns=2.

前置阅读

• 标准 ns=0 节点常量请参考 WellKnownNodes.
• 节点 Browse / 路径解析请参考 Nodes.

Namespaces 公共成员

Session::NamespacesRef() 返回 Namespaces&, 在 Connect() 时自动从服务端 NamespaceArray (i=2255) 加载.

类别	属性	类型	访问	说明
属性	Count()	int	R	命名空间数量
	operator[](int i)	std::string	R	索引访问, 返回该 Index 对应的 URI
方法	IndexOf(uri)	int	R	反查 URI → Index, 找不到返回 -1
	Reload()	Status	R	主动重读服务端 NamespaceArray (Server 动态变更时)

---

常见用法

反查 Index 拼 NodeId

s.Connect();
int idx = s.NamespacesRef().IndexOf("urn:my-company:plc1");
if (idx < 0) {
    throw std::runtime_error("Server does not have my namespace");
}

std::string node_id = "ns=" + std::to_string(idx) + ";s=Temperature";
auto dv = s.Read(node_id);

列出全部命名空间 (调试)

auto& nss = s.NamespacesRef();
for (int i = 0; i < nss.Count(); ++i) {
    std::cout << "  [" << i << "] " << nss[i] << "\n";
}

输出示例:

[0] http://opcfoundation.org/UA/
[1] urn:server-host
[2] urn:my-company:plc1
[3] http://my-company.com/UA/

动态命名空间变更

某些 Server 启动后才注册命名空间 (插件式), Connect 拿到的 NamespaceArray 不全. 此时调 Reload() 重读:

s.NamespacesRef().Reload();
int idx = s.NamespacesRef().IndexOf("urn:plugin:loaded-after-startup");

---

标准命名空间 (ns=0)

OPC Foundation 规定 Index 0 永远是 http://opcfoundation.org/UA/, 所有标准节点都在 ns=0:

节点	NodeId	说明
Root	i=84	根
Objects	i=85	业务数据根
Types	i=86	类型定义根
Server	i=2253	Server 自身对象
ServerStatus	i=2256	Server 状态结构
ServerStatus.CurrentTime	i=2258	服务端当前时间
NamespaceArray	i=2255	命名空间数组
ServerArray	i=2254	服务端数组

详见 WellKnownNodes.

下一步

• WellKnownNodes 标准节点常量
• Nodes 节点访问