QOpcUaGenericStructHandler 类

QOpcUaGenericStructHandler handler(opcuaClient);
handler.initialize();

QObject::connect(&handler, &QOpcUaGenericStructHandler::initializedChanged, [opcuaClient, &handler](bool initialized) {
    if (!initialized)
        return;

    auto node = opcuaClient->node("ns=4;i=3003"); // A custom struct test node in the open62541-testserver
    node->readValueAttribute();

    QObject::connect(node, &QOpcUaNode::attributeRead, [node, &handler](QOpcUa::NodeAttributes attr) {
        if (!attr.testFlag(QOpcUa::NodeAttribute::Value) || node->valueAttributeError() != QOpcUa::UaStatusCode::Good)
            return;

        auto extObj = node->valueAttribute().value<QOpcUaExtensionObject>();
        qDebug() << "Got object of type" << handler.typeNameForBinaryEncodingId(extObj.encodingTypeId());

        const auto result = handler.decode(extObj);

        if (!result)
            return;

        qDebug() << *result;
    });
});

QOpcUaGenericStructHandler handler(opcuaClient);
handler.initialize();

QObject::connect(&handler, &QOpcUaGenericStructHandler::initializedChanged, [opcuaClient, &handler](bool initialized) {
    if (!initialized)
        return;

    QOpcUaGenericStructValue value = handler.createGenericStructValueForTypeId("ns=4;i=3006");
    value.fieldsRef()["MandatoryMember"] = 23.0;
    value.fieldsRef()["OptionalMember"] = 42.0;

    const auto ext = handler.encode(value);

    if (!ext)
        return;

    // Use the extension object to write a node's value attribute, in a method parameter, etc...
});

成员函数文档

[显式] QOpcUaGenericStructHandler::QOpcUaGenericStructHandler(QOpcUaClient *client, QObject *parent = nullptr)

为client构造一个通用结构处理器。

bool QOpcUaGenericStructHandler::addCustomEnumDefinition(const QOpcUaEnumDefinition &definition, const QString &typeId, const QString &name, QOpcUa::IsAbstract isAbstract = QOpcUa::IsAbstract::NotAbstract)

将自定义枚举定义definition添加到已知类型中。这可以用来支持服务器不暴露结构定义的自定义结构。参数definition、typeId和name对于适当的解码和编码是必需的。如果isAbstract被设置，则此类型无法编码和解码。

如果枚举定义已成功添加，则返回true。

bool QOpcUaGenericStructHandler::addCustomStructureDefinition(const QOpcUaStructureDefinition &definition, const QString &typeId, const QString &name, QOpcUa::IsAbstract isAbstract = QOpcUa::IsAbstract::NotAbstract)

将自定义结构定义 definition 添加到已知类型中。这可以用于支持服务器没有暴露结构定义的自定义结构。参数definition、typeId 和 name 对于适当的解码和编码是必需的。如果 isAbstract 被设置，则类型不能被编码和解码。

如果结构定义成功添加，则返回 true。

QOpcUaGenericStructValue QOpcUaGenericStructHandler::createGenericStructValueForTypeId(const QString &typeId)

返回一个通用结构值，该值预先填充了结构定义、与 typeId 对应的类型 ID 和类型名称。对于所有必填字段，将插入一个无效的占位符 QVariant。

QOpcUaGenericStructHandler::DataTypeKind QOpcUaGenericStructHandler::dataTypeKindForTypeId(const QString &id) const

返回类型节点 ID id 的数据类型种类。

std::optional<QOpcUaGenericStructValue> QOpcUaGenericStructHandler::decode(const QOpcUaExtensionObject &extensionObject) const

将 extensionObject 解码为 QOpcUaGenericStructValue。如果解码失败，返回 std::nullopt。

std::optional<QOpcUaExtensionObject> QOpcUaGenericStructHandler::encode(const QOpcUaGenericStructValue &value)

返回 value 编码为 QOpcUaExtensionObject，或者在无法编码值时返回 std::nullopt。

QOpcUaEnumDefinition QOpcUaGenericStructHandler::enumDefinitionForTypeId(const QString &id) const

返回类型节点 ID id 的 QOpcUaEnumDefinition。如果节点 ID 未知或不属于枚举类型，则返回默认构造的值。

bool QOpcUaGenericStructHandler::initialize()

开始数据类型层次遍历。成功或失败将通过 initializedChanged 信号报告。

如果无法启动操作，则返回 false。

[自 6.7] bool QOpcUaGenericStructHandler::initialized() const

如果通用结构处理程序已初始化，则返回 true。

此函数从 Qt 6.7 开始引入。

[信号] void QOpcUaGenericStructHandler::initializedChanged(bool initialized)

当初始化过程完成时，将发出此信号。initialized 表示初始化是否成功。

bool QOpcUaGenericStructHandler::isAbstractTypeId(const QString &id) const

如果由 id 描述的数据类型是抽象的，则返回 true。

QOpcUaStructureDefinition QOpcUaGenericStructHandler::structureDefinitionForBinaryEncodingId(const QString &id) const

返回二进制编码节点标识符 id 对应的 QOpcUaStructureDefinition。如果节点标识符未知或不属于结构类型，则返回默认构造的值。

QOpcUaStructureDefinition QOpcUaGenericStructHandler::structureDefinitionForTypeId(const QString &id) const

返回类型节点标识符 id 对应的 QOpcUaStructureDefinition。如果节点标识符未知或不属于结构类型，则返回默认构造的值。

QString QOpcUaGenericStructHandler::typeIdForBinaryEncodingId(const QString &id) const

返回与二进制编码标识符 id 相关的类型节点标识符。

QString QOpcUaGenericStructHandler::typeNameForBinaryEncodingId(const QString &id) const

返回属于二进制编码节点标识符 id 的类型名称。如果节点标识符未知或不属于结构类型，则返回空字符串。

QString QOpcUaGenericStructHandler::typeNameForTypeId(const QString &id) const

返回由类型节点标识符 id 识别的数据类型节点的类型名称。如果节点标识符未知，则返回空字符串。