QOpcUaGdsClient Class

QOpcUaGdsClientc;// 如果需要凭证QObject连接（&c, &QOpcUaGdsClient::authenticationRequired, [&](QOpcUaAuthenticationInformationauthInfo){authInfo.setUsernameAuthentication("root", "secret"); });// 等待成功QObject连接（&c, &QOpcUaGdsClient::applicationRegistered, [&]() {    qDebug() << "Application" << c.applicationId() << "registered";
}); c.setBackend(...); c.setEndpoint(...); c.setApplicationIdentity(...); c.setPkiConfiguration(...); c.setApplicationRecord(...); c.setCertificateSigningRequestPresets(...); c.start();

成员函数文档

QOpcUaGdsClient::QOpcUaGdsClient(QObject *parent = nullptr)

构建 GDS 客户端，父对象为parent 。

[virtual noexcept] QOpcUaGdsClient::~QOpcUaGdsClient()

销毁 GDS 客户端。

QString QOpcUaGdsClient::applicationId() const

返回服务器分配的应用程序 ID。

这是从应用程序记录数据中接收应用程序 ID 的快捷方式。

另请参阅 applicationRecord()。

const QOpcUaApplicationIdentity &QOpcUaGdsClient::applicationIdentity() const

返回当前 applicationIdentity。

另请参阅 setApplicationIdentity()。

const QOpcUaApplicationRecordDataType &QOpcUaGdsClient::applicationRecord() const

返回客户端使用的应用程序记录数据。

另请参阅 setApplicationRecord()。

[signal] void QOpcUaGdsClient::applicationRegistered()

当应用程序注册成功时会发出该信号。

[signal] void QOpcUaGdsClient::authenticationRequired(QOpcUaAuthenticationInformation &authInfo)

当 GDS 客户端尝试与需要管理权限的服务器进行首次身份验证时，会发出该信号。

authInfo 必须填写有效的身份验证信息。此插槽不得跨线程使用。

const QString &QOpcUaGdsClient::backend() const

返回当前的后端设置。

如果在启动客户端后更改了后端，则将返回更改后的设置，而不是实际使用的实例。

另请参见 setBackend()。

int QOpcUaGdsClient::certificateCheckInterval() const

返回检查客户证书有效性的时间间隔（毫秒）。

另请参阅 setCertificateCheckInterval()。

[signal] void QOpcUaGdsClient::certificateGroupsReceived(QStringList certificateGroups)

当 GDS 客户端收到该应用程序的certificateGroups 新列表时，会发出该信号。

[signal] void QOpcUaGdsClient::certificateUpdateRequired()

当 GDS 客户端检测到需要更新当前使用的证书时，就会发出该信号。

这可能是由于服务器要求客户端更新证书、证书到期日已到或证书是自签名的缘故。

证书更新会自动进行。此信号仅用于通知即将进行的更新。

[signal] void QOpcUaGdsClient::certificateUpdated()

当 GDS 客户端收到存储在磁盘上的新证书时，就会发出该信号。

const QOpcUaX509DistinguishedName &QOpcUaGdsClient::distinguishedNameCertificateSigningRequestPreset() const

返回为证书签名请求预设的区分名称。

const QString &QOpcUaGdsClient::dnsCertificateSigningRequestPreset() const

返回用于证书签名请求的 DNS 预设值。

const QOpcUaEndpointDescription &QOpcUaGdsClient::endpoint() const

返回当前端点设置。

如果在启动客户端后更改了端点，它将返回更改后的设置，而不是实际使用的端点。

另请参阅 setEndpoint()。

QOpcUaGdsClient::Error QOpcUaGdsClient::error() const

返回当前的错误状态。

[signal] void QOpcUaGdsClient::errorChanged(QOpcUaGdsClient::Error error)

发生error 时发出该信号。

const QOpcUaPkiConfiguration &QOpcUaGdsClient::pkiConfiguration() const

返回当前 pkiConfiguration。

另请参见 setPkiConfiguration()。

void QOpcUaGdsClient::setApplicationIdentity(const QOpcUaApplicationIdentity &appIdentity)

设置客户端使用的应用程序标识appIdentity 。

该身份用于向 GDS 服务器注册。该函数必须在启动 GDS 客户端之前调用。之后更改此设置不会产生任何影响。

另请参阅 applicationIdentity().

void QOpcUaGdsClient::setApplicationRecord(const QOpcUaApplicationRecordDataType &appRecord)

设置客户端使用的应用程序记录数据appRecord 。

该数据用于向 GDS 服务器注册。必须在启动 GDS 客户端之前调用该函数。

大部分数据与应用程序标识中的数据相同。注册完成后，可检索分配的应用程序 ID。

另请参见 applicationRecord() 和setApplicationIdentity 。

void QOpcUaGdsClient::setBackend(const QString &backend)

将客户端用于与服务器通信的后端设置为backend 。

该函数必须在启动 GDS 客户端之前调用。之后更改此设置不会产生任何影响。

另请参阅 backend()、QOpcUaProvider::availableBackends() 和start()。

void QOpcUaGdsClient::setCertificateCheckInterval(int interval)

将检查客户端证书有效性的时间间隔（毫秒）设为interval 。

另请参阅 certificateCheckInterval()。

void QOpcUaGdsClient::setCertificateSigningRequestPresets(const QOpcUaX509DistinguishedName &dn, const QString &dns)

设置证书签名请求的预设值；区分名称dn 和 DNS 字符串dns 。

在创建证书签名请求时，需要一些应用程序标识不提供的附加信息。

必须在启动 GDS 客户端前调用该函数。

另请参阅 setApplicationIdentity().

void QOpcUaGdsClient::setEndpoint(const QOpcUaEndpointDescription &endpoint)

将客户端用于与服务器通信的端点设置为endpoint 。

该函数必须在启动 GDS 客户端之前调用。之后更改此设置不会产生任何影响。

只有通过加密端点才能与 GDS 服务器通信。使用未加密的端点将导致通信失败。

另请参阅 endpoint().

void QOpcUaGdsClient::setPkiConfiguration(const QOpcUaPkiConfiguration &pkiConfig)

设置客户端使用的 PKI 配置pkiConfig 。

所有证书、密钥和信任列表都将从指定位置使用或存储到指定位置。要使用从 GDS 接收的证书，必须在QOpcUaClient 中使用相同的配置。

必须在启动 GDS 客户端之前调用该函数。事后更改该设置不会产生任何影响。

另请参阅 pkiConfiguration() 。

void QOpcUaGdsClient::setTrustListUpdateInterval(int interval)

以毫秒为单位设置从服务器更新信任列表到interval 的时间间隔。

另请参阅 trustListUpdateInterval() 。

void QOpcUaGdsClient::start()

启动客户端进程。

设置完所有信息后，就可以启动客户端。

• setBackend
• 设置结束
• setApplicationIdentity
• setPkiConfiguration
• setApplicationRecord
• 设置证书认证请求预置

QOpcUaGdsClient::State QOpcUaGdsClient::state() const

返回当前客户端状态。

[signal] void QOpcUaGdsClient::stateChanged(QOpcUaGdsClient::State state)

当客户端的内部状态发生变化时，就会发出该信号。state 表示新状态。

int QOpcUaGdsClient::trustListUpdateInterval() const

返回从服务器更新信任列表的时间间隔（毫秒）。

另请参阅 setTrustListUpdateInterval()。

[signal] void QOpcUaGdsClient::trustListUpdated()

当 GDS 客户端从服务器接收到新的信任列表并存储到磁盘上时，就会发出该信号。

void QOpcUaGdsClient::unregisterApplication()

从服务器上取消注册应用程序。

当应用程序必须从网络中永久删除时，可以使用该函数。重启或关机时无需调用该函数。

[signal] void QOpcUaGdsClient::unregistered()

该信号在 GDS 客户端取消注册应用程序时发出。