Spec-Zone.ru › Qt 6.0

Класс 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
Наследуется от:

QOAuth2AuthorizationCodeFlow

  • Список всех членов, включая наследуемые

Свойства

  • clientIdentifierSharedKey : QString
  • expiration : const QDateTime
  • scope : QString
  • state : QString
  • userAgent : QString

Открытые функции

QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr)
QAbstractOAuth2(QObject *parent = nullptr)
virtual ~QAbstractOAuth2()
QString clientIdentifierSharedKey() const
virtual QUrl createAuthenticatedUrl(const QUrl &url, const QVariantMap &parameters = 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 &parameters = QVariantMap()) override
virtual QNetworkReply * get(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
virtual QNetworkReply * head(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
virtual QNetworkReply * post(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
virtual void prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray()) override
virtual QNetworkReply * put(const QUrl &url, const QVariantMap &parameters = 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] QUrl QAbstractOAuth2::createAuthenticatedUrl(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Возвращаемый URL основан на url, объединяя его с заданными parameters и токеном доступа.

Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[override virtual] QNetworkReply *QAbstractOAuth2::deleteResource(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Реализация QAbstractOAuth::deleteResource(const QUrl &url, const QVariantMap &parameters).

Отправляет аутентифицированный запрос DELETE и возвращает новый QNetworkReply. url и parameters используются для создания запроса.

См. также: Hypertext Transfer Protocol -- HTTP/1.1: DELETE

Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[override virtual] QNetworkReply *QAbstractOAuth2::get(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Реализация QAbstractOAuth::get(const QUrl &url, const QVariantMap &parameters).

Отправляет аутентифицированный запрос GET и возвращает новый QNetworkReply. url и parameters используются для создания запроса.

См. также: Hypertext Transfer Protocol -- HTTP/1.1: GET

Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[override virtual] QNetworkReply *QAbstractOAuth2::head(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Реализация QAbstractOAuth::head(const QUrl &url, const QVariantMap &parameters).

Отправляет аутентифицированный запрос HEAD и возвращает новый QNetworkReply. url и parameters используются для создания запроса.

См. также: Hypertext Transfer Protocol -- HTTP/1.1: HEAD

Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[override virtual] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Реализация QAbstractOAuth::post(const QUrl &url, const QVariantMap &parameters).

Отправляет аутентифицированный запрос POST и возвращает новый QNetworkReply. url и parameters используются для создания запроса.

См. также: Hypertext Transfer Protocol -- HTTP/1.1: POST

Примечание: Эту функцию можно вызывать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[virtual, 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, 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] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QVariantMap &parameters = QVariantMap())

Переопределяет: QAbstractOAuth::put(const QUrl &url, const QVariantMap &parameters).

Отправляет аутентифицированный запрос PUT и возвращает новый QNetworkReply. Для создания запроса используются url и parameters.

См. также: Протокол передачи гипертекста — HTTP/1.1: PUT

Примечание: Этот метод можно вызвать через метаобъектную систему и из QML. См. Q_INVOKABLE.

[virtual, 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, 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.0/qabstractoauth2.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API