QAbstractOAuthReplyHandler Class

处理对 OAuth 身份验证请求的回复。更多

头文件: #include <QAbstractOAuthReplyHandler>
CMake: find_package(Qt6 REQUIRED COMPONENTS NetworkAuth)
target_link_libraries(mytarget PRIVATE Qt6::NetworkAuth)
qmake: QT += networkauth
继承: QObject

公共函数

QAbstractOAuthReplyHandler(QObject *parent = nullptr)
virtual ~QAbstractOAuthReplyHandler()
virtual QString callback() const = 0

公共插槽

virtual void networkReplyFinished(QNetworkReply *reply) = 0

信号

void callbackDataReceived(const QByteArray &data)
void callbackReceived(const QVariantMap &values)
void replyDataReceived(const QByteArray &data)
(since 6.6) void tokenRequestErrorOccurred(QAbstractOAuth::Error error, const QString &errorString)
void tokensReceived(const QVariantMap &tokens)

详细说明

QAbstractOAuthReplyHandler 类处理对所有 OAuth 身份验证请求的回复。该类设计为基类,其子类通过callback() 和networkReplyFinished() 方法实现自定义行为。

成员函数文档

[explicit] QAbstractOAuthReplyHandler::QAbstractOAuthReplyHandler(QObject *parent = nullptr)

构造一个回复处理程序,作为parent 的子处理程序。

[virtual noexcept] QAbstractOAuthReplyHandler::~QAbstractOAuthReplyHandler()

销毁回复处理程序。

[pure virtual] QString QAbstractOAuthReplyHandler::callback() const

返回一个绝对 URI,当资源所有者授权步骤完成后,服务器将把资源所有者重定向到该 URI。如果客户端无法接收回调或已通过其他方式建立了回调 URI,则必须将参数值设置为 "oob"(全小写),以表示带外配置。

派生类应实现该函数,以提供预期的回调类型。

[signal] void QAbstractOAuthReplyHandler::callbackDataReceived(const QByteArray &data)

收到回调请求时发出该信号:data 包含解析前的信息。

[signal] void QAbstractOAuthReplyHandler::callbackReceived(const QVariantMap &values)

该信号在收到服务器的回复时发出,其中values 包含令牌凭据和服务器可能返回的任何其他信息。该信号发出后,授权过程即告完成。

[pure virtual slot] void QAbstractOAuthReplyHandler::networkReplyFinished(QNetworkReply *reply)

服务器确定请求是否有效后,将调用此函数。重新实现该函数可获取从服务器接收到的包裹在reply 中的数据。reply 将使用deleteLater() 自动删除,因此不得将其存储在该函数的范围之外。

[signal] void QAbstractOAuthReplyHandler::replyDataReceived(const QByteArray &data)

该信号在 HTTP 请求结束且数据可用时发出。data 包含解析前的响应。

[signal, since 6.6] void QAbstractOAuthReplyHandler::tokenRequestErrorOccurred(QAbstractOAuth::Error error, const QString &errorString)

该信号在令牌请求或刷新error 时发出。errorString 可提供有关错误的更多详细信息。

此函数在 Qt 6.6 中引入。

另请参阅 QAbstractOAuth::requestFailed()。

[signal] void QAbstractOAuthReplyHandler::tokensReceived(const QVariantMap &tokens)

从服务器接收到新的tokens 时会发出该信号。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.