内容

公共类型
特性
公共函数
公共槽
信号
保护函数
静态保护成员
详细描述

QAbstractOAuth Class

QAbstractOAuth class is the base of all implementations of OAuth authentication methods. 更多...

头：	#include <QAbstractOAuth>
qmake:	QT += networkauth
Since:	Qt 5.8
继承：	QObject
继承者：	QAbstractOAuth2

所有成员列表，包括继承成员

公共类型

enum	ContentType { WwwFormUrlEncoded, Json }
enum	Error { NoError, NetworkError, ServerError, OAuthTokenNotFoundError, OAuthTokenSecretNotFoundError, OAuthCallbackNotVerified }
typedef	ModifyParametersFunction
enum	Stage { RequestingTemporaryCredentials, RequestingAuthorization, RequestingAccessToken, RefreshingAccessToken }
enum	Status { NotAuthenticated, TemporaryCredentialsReceived, Granted, RefreshingToken }

特性

authorizationUrl : QUrl
contentType : QAbstractOAuth::ContentType
extraTokens : const QVariantMap
status : const Status

1 特性继承自 QObject

公共函数

virtual	~QAbstractOAuth ()
QUrl	authorizationUrl () const
virtual QString	clientIdentifier () const = 0
ContentType	contentType () const
virtual QNetworkReply *	deleteResource (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) = 0
QVariantMap	extraTokens () const
virtual QNetworkReply *	get (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) = 0
virtual QNetworkReply *	head (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) = 0
ModifyParametersFunction	modifyParametersFunction () const
QNetworkAccessManager *	networkAccessManager () const
virtual QNetworkReply *	post (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) = 0
QAbstractOAuthReplyHandler *	replyHandler () const
void	setAuthorizationUrl (const QUrl & url )
virtual void	setClientIdentifier (const QString & clientIdentifier ) = 0
void	setContentType (ContentType contentType )
void	setModifyParametersFunction (const ModifyParametersFunction & modifyParametersFunction )
void	setNetworkAccessManager (QNetworkAccessManager * networkAccessManager )
void	setReplyHandler (QAbstractOAuthReplyHandler * handler )
virtual void	setToken (const QString & token ) = 0
Status	status () const
virtual QString	token () const = 0

32 公共函数继承自 QObject

公共槽

virtual void

grant () = 0

1 公共槽继承自 QObject

信号

void	authorizationUrlChanged (const QUrl & url )
void	authorizeWithBrowser (const QUrl & url )
void	clientIdentifierChanged (const QString & clientIdentifier )
void	contentTypeChanged (ContentType contentType )
void	extraTokensChanged (const QVariantMap & tokens )
void	finished (QNetworkReply * reply )
void	granted ()
void	replyDataReceived (const QByteArray & data )
void	requestFailed (const Error error )
void	statusChanged (Status status )
void	tokenChanged (const QString & token )

2 信号继承自 QObject

保护函数

	QAbstractOAuth ( QAbstractOAuthPrivate & , QObject * parent = nullptr)
QString	callback () const
virtual void	resourceOwnerAuthorization (const QUrl & url , const QVariantMap & 参数 )
void	setStatus (Status status )

9 保护函数继承自 QObject

静态保护成员

QByteArray

generateRandomString (quint8 length )

额外继承成员

11 静态公共成员继承自 QObject

详细描述

QAbstractOAuth class is the base of all implementations of OAuth authentication methods.

The class defines the basic interface of the OAuth authentication classes. By inheriting this class, you can create custom authentication methods for different web services.

It also contains some functions to ease the process of implementing different authentication flows.

成员类型文档编制

enum QAbstractOAuth:: ContentType

Indicates the MIME Content-Type of the POST methods in authenticated calls.

常量	值	描述
`QAbstractOAuth::WwwFormUrlEncoded`	`0`	Uses application/x-www-form-urlencoded format.
`QAbstractOAuth::Json`	`1`	Uses application/json format.

enum QAbstractOAuth:: Error

Indicates the latest received error.

常量	值	描述
`QAbstractOAuth::NoError`	`0`	No error has ocurred.
`QAbstractOAuth::NetworkError`	`1`	Failed to connect to the server.
`QAbstractOAuth::ServerError`	`2`	The server answered the request with an error.
`QAbstractOAuth::OAuthTokenNotFoundError`	`3`	The server's response to a token request provided no token identifier.
`QAbstractOAuth::OAuthTokenSecretNotFoundError`	`4`	The server's response to a token request provided no token secret.
`QAbstractOAuth::OAuthCallbackNotVerified`	`5`	The authorization server has not verified the supplied callback URI in the request. This usually happens when the provided callback does not match with the callback supplied during client registration.

typedef QAbstractOAuth:: ModifyParametersFunction

enum QAbstractOAuth:: Stage

Identifies an authentication stage. It's passed to a ModifyParametersFunction so that it can make different changes to parameters at each call to it during the process of authentication.

常量	值	描述
`QAbstractOAuth::RequestingTemporaryCredentials`	`0`	Preparing the temporary credentials request.
`QAbstractOAuth::RequestingAuthorization`	`1`	Preparing the authorization grant URL.
`QAbstractOAuth::RequestingAccessToken`	`2`	Preparing the token request.
`QAbstractOAuth::RefreshingAccessToken`	`3`	Preparing the access token refresh.

enum QAbstractOAuth:: Status

Indicates the current authentication status.

常量	值	描述
`QAbstractOAuth::NotAuthenticated`	`0`	No token has been retrieved.
`QAbstractOAuth::TemporaryCredentialsReceived`	`1`	Temporary credentials have been received, this status is used in some OAuth authetication methods.
`QAbstractOAuth::Granted`	`2`	Token credentials have been received and authenticated calls are allowed.
`QAbstractOAuth::RefreshingToken`	`3`	New token credentials have been requested.

特性文档编制

authorizationUrl : QUrl

This property holds the URL used to request the Resource Owner Authorization as described in: The OAuth 1.0 Protocol: Resource Owner Authorization

访问函数：

QUrl	authorizationUrl () const
void	setAuthorizationUrl (const QUrl & url )

通知程序信号：

void	authorizationUrlChanged (const QUrl & url )

contentType : QAbstractOAuth::ContentType

This property holds the Content-Type to use when sending authorization parameters.

This property controls how parameters are formatted when sent with a POST request. A suitable header is also added.

访问函数：

ContentType	contentType () const
void	setContentType (ContentType contentType )

通知程序信号：

void	contentTypeChanged (ContentType contentType )

extraTokens : const QVariantMap

This property holds the extra tokens received from the server.

访问函数：

QVariantMap extraTokens () const

通知程序信号：

void	extraTokensChanged (const QVariantMap & tokens )

status : const Status

This property holds the current authentication status.

访问函数：

Status status () const

通知程序信号：

void	statusChanged (Status status )

成员函数文档编制

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

Copy constructor.

`[virtual]` QAbstractOAuth:: ~QAbstractOAuth ()

Destroys the abstract OAuth.

QUrl QAbstractOAuth:: authorizationUrl () const

Returns the authorization request URL.

注意： Getter 函数对于特性 authorizationUrl .

另请参阅 setAuthorizationUrl ().

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

此信号被发射当 url generated by resourceOwnerAuthorization () is ready to be used in the web browser to allow the application to impersonate the user.

另请参阅 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.

另请参阅 replyHandler () 和 setReplyHandler ().

`[pure virtual]` QString QAbstractOAuth:: clientIdentifier () const

另请参阅 setClientIdentifier ().

`[signal]` void QAbstractOAuth:: clientIdentifierChanged (const QString & clientIdentifier )

ContentType QAbstractOAuth:: contentType () const

Returns the current Content-Type used in authenticated calls.

注意： Getter 函数对于特性 contentType .

另请参阅 setContentType () 和 post ().

`[pure virtual]` QNetworkReply QAbstractOAuth:: deleteResource (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

Posts an authenticated DELETE request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: DELETE

QVariantMap QAbstractOAuth:: extraTokens () const

Returns the extra tokens received from the server during authentication.

注意： Getter 函数对于特性 extraTokens .

另请参阅 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.

另请参阅 : The OAuth 1.0 Protocol: Nonce and Timestamp .

`[pure virtual]` QNetworkReply QAbstractOAuth:: get (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

Posts an authenticated GET request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: GET

`[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 & 参数 = QVariantMap())

Posts an authenticated HEAD request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: HEAD

ModifyParametersFunction QAbstractOAuth:: modifyParametersFunction () const

Returns the current parameter-modification function.

另请参阅 ModifyParametersFunction , setModifyParametersFunction ()，和 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.

另请参阅 setNetworkAccessManager () 和 QNetworkAccessManager .

`[pure virtual]` QNetworkReply QAbstractOAuth:: post (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

Posts an authenticated POST request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: POST

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

QAbstractOAuthReplyHandler *QAbstractOAuth:: replyHandler () const

Returns the reply handler currently in use.

另请参阅 setReplyHandler () 和 QAbstractOAuthReplyHandler .

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

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

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 参数 . When the URL is ready, the authorizeWithBrowser () signal will be emitted with the generated URL.

另请参阅 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.

注意： Setter 函数对于特性 authorizationUrl .

另请参阅 authorizationUrl ().

`[pure virtual]` void QAbstractOAuth:: setClientIdentifier (const QString & clientIdentifier )

另请参阅 clientIdentifier ().

void QAbstractOAuth:: setContentType ( ContentType contentType )

Sets the current Content-Type to contentType .

注意： Setter 函数对于特性 contentType .

另请参阅 contentType ().

void QAbstractOAuth:: setModifyParametersFunction (const ModifyParametersFunction & modifyParametersFunction )

另请参阅 modifyParametersFunction ().

void QAbstractOAuth:: setNetworkAccessManager ( QNetworkAccessManager * networkAccessManager )

将网络管理器设为 networkAccessManager . QAbstractOAuth 未拥有所有权对于 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.

另请参阅 networkAccessManager () 和 QNetworkAccessManager .

void QAbstractOAuth:: setReplyHandler ( QAbstractOAuthReplyHandler * handler )

Sets the current reply handler to handler .

注意： Does not take ownership of handler .

另请参阅 replyHandler ().

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

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

另请参阅 status ().

`[pure virtual]` void QAbstractOAuth:: setToken (const QString & token )

另请参阅 token ().

Status QAbstractOAuth:: status () const

Returns the current authentication status.

注意： Getter 函数对于特性 status .

另请参阅 setStatus () 和 Status .

`[pure virtual]` QString QAbstractOAuth:: token () const

另请参阅 setToken ().

内容

QAbstractOAuth Class

公共类型

特性

公共函数

公共槽

信号

保护函数

静态保护成员

额外继承成员

详细描述

成员类型文档编制

enum QAbstractOAuth:: ContentType

enum QAbstractOAuth:: Error

typedef QAbstractOAuth:: ModifyParametersFunction

enum QAbstractOAuth:: Stage

enum QAbstractOAuth:: Status

特性文档编制

authorizationUrl : QUrl

contentType : QAbstractOAuth::ContentType

extraTokens : const QVariantMap

status : const Status

成员函数文档编制

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

[virtual] QAbstractOAuth:: ~QAbstractOAuth ()

QUrl QAbstractOAuth:: authorizationUrl () const

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

[protected] QString QAbstractOAuth:: callback () const

[pure virtual] QString QAbstractOAuth:: clientIdentifier () const

[signal] void QAbstractOAuth:: clientIdentifierChanged (const QString & clientIdentifier )

ContentType QAbstractOAuth:: contentType () const

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

QVariantMap QAbstractOAuth:: extraTokens () const

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

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

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

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

[signal] void QAbstractOAuth:: granted ()

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

ModifyParametersFunction QAbstractOAuth:: modifyParametersFunction () const

QNetworkAccessManager *QAbstractOAuth:: networkAccessManager () const

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

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

QAbstractOAuthReplyHandler *QAbstractOAuth:: replyHandler () const

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

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

void QAbstractOAuth:: setAuthorizationUrl (const QUrl & url )

[pure virtual] void QAbstractOAuth:: setClientIdentifier (const QString & clientIdentifier )

void QAbstractOAuth:: setContentType ( ContentType contentType )

void QAbstractOAuth:: setModifyParametersFunction (const ModifyParametersFunction & modifyParametersFunction )

void QAbstractOAuth:: setNetworkAccessManager ( QNetworkAccessManager * networkAccessManager )

void QAbstractOAuth:: setReplyHandler ( QAbstractOAuthReplyHandler * handler )

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

[pure virtual] void QAbstractOAuth:: setToken (const QString & token )

Status QAbstractOAuth:: status () const

[pure virtual] QString QAbstractOAuth:: token () const

[signal] void QAbstractOAuth:: tokenChanged (const QString & token )

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

`[virtual]` QAbstractOAuth:: ~QAbstractOAuth ()

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

`[protected]` QString QAbstractOAuth:: callback () const

`[pure virtual]` QString QAbstractOAuth:: clientIdentifier () const

`[signal]` void QAbstractOAuth:: clientIdentifierChanged (const QString & clientIdentifier )

`[pure virtual]` QNetworkReply QAbstractOAuth:: deleteResource (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

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

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

`[pure virtual]` QNetworkReply QAbstractOAuth:: get (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

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

`[signal]` void QAbstractOAuth:: granted ()

`[pure virtual]` QNetworkReply QAbstractOAuth:: head (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

`[pure virtual]` QNetworkReply QAbstractOAuth:: post (const QUrl & url* , const QVariantMap & 参数 = QVariantMap())

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

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

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

`[pure virtual]` void QAbstractOAuth:: setClientIdentifier (const QString & clientIdentifier )

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

`[pure virtual]` void QAbstractOAuth:: setToken (const QString & token )

`[pure virtual]` QString QAbstractOAuth:: token () const

`[signal]` void QAbstractOAuth:: tokenChanged (const QString & token )