跳到主要内容

Browse

s.Browse(node_id, filter = NodeClass::Unspecified) — 列出指定节点的直接子节点 (一层).

前置阅读 / 配套

签名​

std::vector<Reference> Browse(
    std::string const& node_id,
    NodeClass filter = NodeClass::Unspecified);

std::vector<std::vector<Reference>> BrowseMany(
    std::vector<std::string> const& node_ids,
    NodeClass filter = NodeClass::Unspecified);

Reference 结构​

struct Reference {
    std::string node_id;
    std::string browse_name;
    std::string display_name;
    NodeClass   node_class;
};
字段类型说明
node_idstd::string子节点 NodeId
browse_namestd::string浏览名 (含 NamespaceIndex 前缀, 如 2:Temperature)
display_namestd::string显示名
node_classNodeClass子节点类别

例子​

// 列出 Boiler1 下所有子节点
auto children = s.Browse("ns=2;s=Boiler1");
for (auto const& c : children) {
    std::cout << "  " << static_cast<int>(c.node_class)
              << " " << c.browse_name << " -> " << c.node_id << "\n";
}

// 只看 Variable 类型
auto vars = s.Browse("ns=2;s=Boiler1", NodeClass::Variable);

// 只看 Method
auto methods = s.Browse("ns=2;s=Calculator", NodeClass::Method);

批量浏览 (BrowseMany)​

如果同时要浏览多个节点 (例如 GUI 初次展开树), 用 BrowseMany 一次 RPC:

std::vector<std::string> roots = { "i=85" /* Objects */, "i=86" /* Types */ };
auto results = s.BrowseMany(roots);
for (size_t i = 0; i < roots.size(); ++i) {
    std::cout << roots[i] << ":\n";
    for (auto const& c : results[i]) {
        std::cout << "  " << c.browse_name << "\n";
    }
}

如果某个节点浏览失败 (NodeId 错), 对应槽位返回空 std::vector<Reference>, 不抛异常.

NodeClass filter​

enum class NodeClass : int32_t {
    Unspecified   = 0,
    Object        = 1,
    Variable      = 2,
    Method        = 4,
    ObjectType    = 8,
    VariableType  = 16,
    ReferenceType = 32,
    DataType      = 64,
    View          = 128
};
值包含
Unspecified全部
Object仅 Object
Variable仅 Variable
Method仅 Method

按位或当前 SDK 暂不直接支持, 需要分多次 Browse.

异常​

Exception(..., BadNodeIdUnknown) / Exception(..., BadCommunicationError) 等. transport 失败抛, 单个子节点失败不抛.

大节点的分页 (ContinuationPoint)​

如果一个节点有 1000+ 个子节点, 单次 Browse 服务端可能截断. 此时 Browse 只返回第一页.

要看全部, 用 BrowseWithPaging + BrowseNext:

auto page = s.BrowseWithPaging("ns=2;s=BigFolder");
std::vector<Reference> all_refs = page.references;
while (!page.continuation_point.empty()) {
    page = s.BrowseNext(page.continuation_point);
    all_refs.insert(all_refs.end(), page.references.begin(), page.references.end());
}

性能​

  • 单次 Browse: ~5-15 ms (网络往返 + 服务端遍历)
  • BrowseMany 批量: 总耗时 ~ 单次 (省 N-1 次往返)
  • 1000+ 子节点会分页, 加 BrowseNext 处理

下一步​