QAbstractOAuth Class

Member Function Documentation

[protected] QAbstractOAuth::QAbstractOAuth(QAbstractOAuthPrivate &, QObject *parent = nullptr)

Default constructs an instance of QAbstractOAuth.

[virtual] QAbstractOAuth::~QAbstractOAuth()

Destroys the abstract OAuth.

QUrl QAbstractOAuth::authorizationUrl() const

Returns the authorization request URL.

Note: Getter function for property authorizationUrl.

See also setAuthorizationUrl().

[signal] void QAbstractOAuth::authorizeWithBrowser(const QUrl &url)

This signal is emitted when the url generated by resourceOwnerAuthorization() is ready to be used in the web browser to allow the application to impersonate the user.

See also resourceOwnerAuthorization().

[protected] QString QAbstractOAuth::callback() const

Returns the current callback string corresponding to the current reply handler. The returned string is the string sent to the server to specify the callback URI, or the word identifying the alternative method in headless devices.

See also replyHandler() and setReplyHandler().

QString QAbstractOAuth::clientIdentifier() const

Returns the current client identifier used in the authentication process.

Note: Getter function for property clientIdentifier.

See also setClientIdentifier().

QAbstractOAuth::ContentType QAbstractOAuth::contentType() const

Returns the current Content-Type used in authenticated calls.

Note: Getter function for property contentType.

See also setContentType() and post().

[pure virtual] QNetworkReply *QAbstractOAuth::deleteResource(const QUrl &url, const QVariantMap &parameters = ...)

Sends an authenticated DELETE request and returns a new QNetworkReply. The url and parameters are used to create the request.

See also: Hypertext Transfer Protocol -- HTTP/1.1: DELETE

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

QVariantMap QAbstractOAuth::extraTokens() const

Returns the extra tokens received from the server during authentication.

Note: Getter function for property extraTokens.

See also extraTokensChanged().

[signal] void QAbstractOAuth::finished(QNetworkReply *reply)

[static protected] QByteArray QAbstractOAuth::generateRandomString(quint8 length)

Generates a random string which could be used as state or nonce. The parameter length determines the size of the generated string.

See also: The OAuth 1.0 Protocol: Nonce and Timestamp.

[pure virtual] QNetworkReply *QAbstractOAuth::get(const QUrl &url, const QVariantMap &parameters = ...)

Sends an authenticated GET request and returns a new QNetworkReply. The url and parameters are used to create the request.

See also: Hypertext Transfer Protocol -- HTTP/1.1: GET

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[pure virtual slot] void QAbstractOAuth::grant()

Override this function to implement the corresponding authentication flow in the subclasses. Client code calls this function to start the authentication workflow. This may require user interaction: for example, asking the user's authorization via a web browser. When the authentication succeeds, it should emit granted(); this gives notice that credentials are ready to be used in authenticated calls.

[signal] void QAbstractOAuth::granted()

This signal is emitted when the authorization flow finishes successfully.

[pure virtual] QNetworkReply *QAbstractOAuth::head(const QUrl &url, const QVariantMap &parameters = ...)

Sends an authenticated HEAD request and returns a new QNetworkReply. The url and parameters are used to create the request.

See also: Hypertext Transfer Protocol -- HTTP/1.1: HEAD

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

QAbstractOAuth::ModifyParametersFunction QAbstractOAuth::modifyParametersFunction() const

Returns the current parameter-modification function.

See also ModifyParametersFunction, setModifyParametersFunction(), and Stage.

QNetworkAccessManager *QAbstractOAuth::networkAccessManager() const

Returns the current network access manager used to send the requests to the server during authentication flows or to make authentication calls.

See also setNetworkAccessManager() and QNetworkAccessManager.

[pure virtual] QNetworkReply *QAbstractOAuth::post(const QUrl &url, const QVariantMap &parameters = ...)

Sends an authenticated POST request and returns a new QNetworkReply. The url and parameters are used to create the request.

See also: Hypertext Transfer Protocol -- HTTP/1.1: POST

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

[pure virtual] QNetworkReply *QAbstractOAuth::put(const QUrl &url, const QVariantMap &parameters = ...)

Sends an authenticated PUT request and returns a new QNetworkReply. The url and parameters are used to create the request.

See also: Hypertext Transfer Protocol -- HTTP/1.1: PUT

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

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

QAbstractOAuthReplyHandler *QAbstractOAuth::replyHandler() const

Returns the reply handler currently in use.

See also setReplyHandler() and QAbstractOAuthReplyHandler.

[signal] void QAbstractOAuth::requestFailed(const QAbstractOAuth::Error error)

[virtual protected] void QAbstractOAuth::resourceOwnerAuthorization(const QUrl &url, const QVariantMap &parameters)

Builds the resource owner authorization URL to be used in the web browser: url is used as the base URL and the query is created using parameters. When the URL is ready, the authorizeWithBrowser() signal will be emitted with the generated URL.

See also authorizeWithBrowser().

void QAbstractOAuth::setAuthorizationUrl(const QUrl &url)

Sets the authorization request URL to url. This address will be used to allow the user to grant the application the ability to make authenticated calls on behalf of the user.

Note: Setter function for property authorizationUrl.

See also authorizationUrl().

void QAbstractOAuth::setClientIdentifier(const QString &clientIdentifier)

Sets the current client identifier to clientIdentifier.

Note: Setter function for property clientIdentifier.

See also clientIdentifier().

void QAbstractOAuth::setContentType(QAbstractOAuth::ContentType contentType)

Sets the current Content-Type to contentType.

Note: Setter function for property contentType.

See also contentType().

void QAbstractOAuth::setModifyParametersFunction(const QAbstractOAuth::ModifyParametersFunction &modifyParametersFunction)

Sets the parameter-modification function modifyParametersFunction. This function is used to customize the parameters sent to the server during a specified authorization stage. The number of calls to this function depends on the flow used during the authentication.

See also modifyParametersFunction(), ModifyParametersFunction, and Stage.

void QAbstractOAuth::setNetworkAccessManager(QNetworkAccessManager *networkAccessManager)

Sets the network manager to networkAccessManager. QAbstractOAuth does not take ownership of networkAccessManager. If no custom network access manager is set, an internal network access manager is used. This network access manager will be used to make the request to the authentication server and the authenticated request to the web service.

See also networkAccessManager() and QNetworkAccessManager.

void QAbstractOAuth::setReplyHandler(QAbstractOAuthReplyHandler *handler)

Sets the current reply handler to handler.

Note: Does not take ownership of handler.

See also replyHandler().

[protected] void QAbstractOAuth::setStatus(QAbstractOAuth::Status status)

Sets the current status to status. This method is for use by classes based on QAbstractOAuth.

See also status().

void QAbstractOAuth::setToken(const QString &token)

Sets the token used to sign authenticated requests to token.

Note: Setter function for property token.

See also token().

QAbstractOAuth::Status QAbstractOAuth::status() const

Returns the current authentication status.

Note: Getter function for property status.

See also setStatus() and Status.

QString QAbstractOAuth::token() const

Returns the token used to sign the authenticated requests.

Note: Getter function for property token.

See also setToken().