Namespaces — ua.namespaces

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

前置阅读

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

NamespaceCollection 公共成员

OpcUaSession.namespaces 是 NamespaceCollection, 在 connect 时自动从服务端 NamespaceArray (i=2255) 加载. 实现 Iterable<String>, 可直接 for-each.

类别	属性	类型	访问	说明
属性	size()	int	R	命名空间数量
	get(int index)	String	R	按索引取该 Index 对应的 URI

方法

方法	返回	说明
indexOf(String uri)	int (找不到 -1)	反查 URI → Index
reload()	Enums.StatusCode	主动重读服务端 NamespaceArray (Server 动态变更时)
iterator()	Iterator<String>	for-each 遍历全部 URI

---

常见用法

反查 Index 拼 NodeId

ua.connect();
int idx = ua.namespaces.indexOf("urn:my-company:plc1");
if (idx < 0) {
    throw new IllegalStateException("Server does not have my namespace");
}

String nodeId = "ns=" + idx + ";s=Temperature";
try (OpcUaDataValue dv = ua.read(nodeId)) {
    // ...
}

用 NodeCollection.makeString / makeNumeric

NodeCollection 提供便捷构造, 内部走 indexOf:

OpcUaNode n1 = ua.nodes.makeString("urn:my-company:plc1", "Temperature");
OpcUaNode n2 = ua.nodes.makeNumeric("urn:my-company:plc1", 1234);
try (OpcUaDataValue dv = n1.getValue()) {
    // ...
}

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

int i = 0;
for (String uri : ua.namespaces) {
    System.out.println("  [" + i + "] " + uri);
    i++;
}

输出示例:

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

动态命名空间变更

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

ua.namespaces.reload();
int idx = ua.namespaces.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 节点访问