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 时,会触发此信号。
© 2026 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.