Класс QAbstractOAuth2
Класс QAbstractOAuth2 является базой всех реализаций методов аутентификации OAuth 2. Подробнее...
| Заголовок: | #include <QAbstractOAuth2> |
| CMake: | find_package(Qt6 COMPONENTS NetworkAuth REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::NetworkAuth) |
| qmake: | QT += networkauth |
| С момента: | Qt 5.8 |
| Наследует: | QAbstractOAuth |
| Наследуется от: |
Свойства
|
Общедоступные функции
| QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr) | |
| QAbstractOAuth2(QObject *parent = nullptr) | |
| virtual | ~QAbstractOAuth2() |
| QString | clientIdentifierSharedKey() const |
| virtual QUrl | createAuthenticatedUrl(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) |
| QDateTime | expirationAt() const |
| virtual QNetworkReply * | post(const QUrl &url, const QByteArray &data) |
| virtual QNetworkReply * | post(const QUrl &url, QHttpMultiPart *multiPart) |
| virtual QNetworkReply * | put(const QUrl &url, const QByteArray &data) |
| virtual QNetworkReply * | put(const QUrl &url, QHttpMultiPart *multiPart) |
| QString | refreshToken() const |
| QString | responseType() const |
| QString | scope() const |
| void | setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey) |
| void | setRefreshToken(const QString &refreshToken) |
| void | setScope(const QString &scope) |
| void | setState(const QString &state) |
| void | setUserAgent(const QString &userAgent) |
| QString | state() const |
| QString | userAgent() const |
Реализованные публичные функции
| virtual QNetworkReply * | deleteResource(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
| virtual QNetworkReply * | get(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
| virtual QNetworkReply * | head(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
| virtual QNetworkReply * | post(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
| virtual void | prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray()) override |
| virtual QNetworkReply * | put(const QUrl &url, const QVariantMap ¶meters = QVariantMap()) override |
Сигналы
| void | authorizationCallbackReceived(const QVariantMap &data) |
| void | clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey) |
| void | error(const QString &error, const QString &errorDescription, const QUrl &uri) |
| void | expirationAtChanged(const QDateTime &expiration) |
| void | refreshTokenChanged(const QString &refreshToken) |
| void | scopeChanged(const QString &scope) |
| void | stateChanged(const QString &state) |
| void | userAgentChanged(const QString &userAgent) |
Подробное описание
Класс определяет базовый интерфейс классов аутентификации OAuth 2. Наследуя этот класс, вы можете создавать собственные методы аутентификации, используя стандарт OAuth 2 для различных веб-сервисов.
Описание работы OAuth 2 можно найти здесь: The OAuth 2.0 Authorization Framework
Документация свойств
clientIdentifierSharedKey : QString
Это свойство содержит общий ключ клиента, используемый в качестве пароля, если сервер требует аутентификации для запроса токена.
Функции доступа:
| QString | clientIdentifierSharedKey() const |
| void | setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey) |
Сигнал уведомления:
| void | clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey) |
[read-only] expiration : const QDateTime
Это свойство содержит время истечения срока действия текущего токена доступа.
Функции доступа:
| QDateTime | expirationAt() const |
Сигнал уведомления:
| void | expirationAtChanged(const QDateTime &expiration) |
scope : QString
Это свойство содержит желаемый scope, определяющий разрешения, запрашиваемые клиентом.
Функции доступа:
| QString | scope() const |
| void | setScope(const QString &scope) |
Сигнал уведомления:
| void | scopeChanged(const QString &scope) |
state : QString
Это свойство содержит строку, отправленную на сервер во время аутентификации. Значение state используется для идентификации и проверки запроса при получении обратного вызова.
Функции доступа:
| QString | state() const |
| void | setState(const QString &state) |
Сигнал уведомления:
| void | stateChanged(const QString &state) |
userAgent : QString
Это свойство содержит заголовок User-Agent, используемый для создания сетевых запросов.
Значение по умолчанию — "QtOAuth/1.0 (+https://www.qt.io)".
Функции доступа:
| QString | userAgent() const |
| void | setUserAgent(const QString &userAgent) |
Сигнал уведомления:
| void | userAgentChanged(const QString &userAgent) |
Документация функций-членов
QAbstractOAuth2::QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr)
Создаёт объект QAbstractOAuth2, используя parent в качестве родительского объекта и устанавливает manager в качестве менеджера сетевого доступа.
QAbstractOAuth2::QAbstractOAuth2(QObject *parent = nullptr)
Создаёт объект QAbstractOAuth2, используя parent в качестве родительского объекта.
[signal] void QAbstractOAuth2::authorizationCallbackReceived(const QVariantMap &data)
Сигнал, испускаемый, когда сервер ответа получает обратный вызов авторизации от сервера: data содержит значения, полученные от сервера.
[signal] void QAbstractOAuth2::error(const QString &error, const QString &errorDescription, const QUrl &uri)
Сигнал, испускаемый, когда сервер отвечает на запрос с ошибкой: error — имя ошибки; errorDescription описывает ошибку, а uri — необязательный URI, содержащий дополнительную информацию об ошибке.
[virtual] QAbstractOAuth2::~QAbstractOAuth2()
Уничтожает экземпляр QAbstractOAuth2.
[virtual invokable] QUrl QAbstractOAuth2::createAuthenticatedUrl(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Возвращаемый URL основан на url, объединяя его с заданными parameters и токеном доступа.
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[override virtual invokable] QNetworkReply *QAbstractOAuth2::deleteResource(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Реализация QAbstractOAuth::deleteResource(const QUrl &url, const QVariantMap ¶meters).
Отправляет аутентифицированный запрос DELETE и возвращает новый QNetworkReply. url и parameters используются для создания запроса.
См. также: Hypertext Transfer Protocol -- HTTP/1.1: DELETE
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[override virtual invokable] QNetworkReply *QAbstractOAuth2::get(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Реализация QAbstractOAuth::get(const QUrl &url, const QVariantMap ¶meters).
Отправляет аутентифицированный запрос GET и возвращает новый QNetworkReply. url и parameters используются для создания запроса.
См. также: Hypertext Transfer Protocol -- HTTP/1.1: GET
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[override virtual invokable] QNetworkReply *QAbstractOAuth2::head(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Реализация QAbstractOAuth::head(const QUrl &url, const QVariantMap ¶meters).
Отправляет аутентифицированный запрос HEAD и возвращает новый QNetworkReply. url и parameters используются для создания запроса.
См. также: Hypertext Transfer Protocol -- HTTP/1.1: HEAD
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[override virtual invokable] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Реализация QAbstractOAuth::post(const QUrl &url, const QVariantMap ¶meters).
Отправляет аутентифицированный запрос POST и возвращает новый QNetworkReply. url и parameters используются для создания запроса.
См. также: Hypertext Transfer Protocol -- HTTP/1.1: POST
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[virtual invokable, since 5.10] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QByteArray &data)
Это перегруженная функция.
Отправляет аутентифицированный запрос POST и возвращает новый QNetworkReply. url и data используются для создания запроса.
{Hypertext Transfer Protocol -- HTTP/1.1: POST}
Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.
Функция была добавлена в Qt 5.10.
См. также post() и https://tools.ietf.org/html/rfc2616#section-9.6.
[virtual invokable, since 5.10] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, QHttpMultiPart *multiPart)
Это перегруженный метод.
Отправляет аутентифицированный запрос POST и возвращает новый QNetworkReply. Для создания запроса используются url и multiPart.
{Протокол передачи гипертекста — HTTP/1.1: POST}
Примечание: Этот метод можно вызвать через метаобъектную систему и из QML. См. Q_INVOKABLE.
Этот метод был добавлен в Qt 5.10.
См. также post(), QHttpMultiPart и https://tools.ietf.org/html/rfc2616#section-9.6.
[override virtual] void QAbstractOAuth2::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray())
Переопределяет: QAbstractOAuth::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body).
[override virtual invokable] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QVariantMap ¶meters = QVariantMap())
Переопределяет: QAbstractOAuth::put(const QUrl &url, const QVariantMap ¶meters).
Отправляет аутентифицированный запрос PUT и возвращает новый QNetworkReply. Для создания запроса используются url и parameters.
См. также: Протокол передачи гипертекста — HTTP/1.1: PUT
Примечание: Этот метод можно вызвать через метаобъектную систему и из QML. См. Q_INVOKABLE.
[virtual invokable, since 5.10] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QByteArray &data)
Это перегруженный метод.
Отправляет аутентифицированный запрос PUT и возвращает новый QNetworkReply. Для создания запроса используются url и data.
{Протокол передачи гипертекста — HTTP/1.1: PUT}
Примечание: Этот метод можно вызвать через метаобъектную систему и из QML. См. Q_INVOKABLE.
Этот метод был добавлен в Qt 5.10.
См. также put() и https://tools.ietf.org/html/rfc2616#section-9.6.
[virtual invokable, since 5.10] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, QHttpMultiPart *multiPart)
Это перегруженный метод.
Отправляет аутентифицированный запрос PUT и возвращает новый QNetworkReply. Для создания запроса используются url и multiPart.
{Протокол передачи гипертекста — HTTP/1.1: PUT}
Примечание: Этот метод можно вызвать через метаобъектную систему и из QML. См. Q_INVOKABLE.
Этот метод был добавлен в Qt 5.10.
См. также put(), QHttpMultiPart и https://tools.ietf.org/html/rfc2616#section-9.6.
QString QAbstractOAuth2::refreshToken() const
Получает текущий токен обновления.
Токены обновления обычно имеют более длительный срок действия, чем токены доступа, поэтому их следует сохранять для последующего использования.
Возвращает текущий токен обновления или пустую строку, если доступный токен обновления отсутствует.
Примечание: Метод-получатель для свойства refreshToken.
См. также setRefreshToken().
QString QAbstractOAuth2::responseType() const
Возвращает используемый response_type.
void QAbstractOAuth2::setRefreshToken(const QString &refreshToken)
Устанавливает новый токен обновления refreshToken для использования.
Пользовательский токен обновления может использоваться для обновления токена доступа с помощью этого метода, а затем токен доступа может быть обновлён с помощью QOAuth2AuthorizationCodeFlow::refreshAccessToken().
Примечание: Метод-установщик для свойства refreshToken.
См. также refreshToken().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qabstractoauth2.html