QAbstractOAuth2 Class

멤버 함수 문서

[explicit] QAbstractOAuth2::QAbstractOAuth2(QObject *parent = nullptr)

parent 을 부모로 사용하여 QAbstractOAuth2 객체를 구축합니다.

[explicit] QAbstractOAuth2::QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr)

parent 을 부모로 사용하고 manager 을 네트워크 액세스 관리자로 설정하여 QAbstractOAuth2 개체를 구성합니다.

[virtual noexcept] QAbstractOAuth2::~QAbstractOAuth2()

QAbstractOAuth2 인스턴스를 삭제합니다.

[signal, since 6.9] void QAbstractOAuth2::accessTokenAboutToExpire()

이 신호는 액세스 토큰이 곧 만료될 때 발신됩니다.

이 신호를 보내려면 액세스 토큰에 유효한 만료 시간이 있어야 합니다. 이 신호를 수동으로 처리하는 다른 방법은 autoRefresh 을 사용하는 것입니다.

이 함수는 Qt 6.9에 도입되었습니다.

refreshLeadTime, autoRefresh, refreshTokens()도 참조하세요 .

[signal] void QAbstractOAuth2::authorizationCallbackReceived(const QVariantMap &data)

응답 서버가 서버로부터 권한 부여 콜백을 수신할 때 발생하는 신호: data 서버로부터 받은 값을 포함합니다.

void QAbstractOAuth2::clearNetworkRequestModifier()

네트워크 요청 수정자를 지웁니다.

setNetworkRequestModifier()도 참조하세요 .

[virtual invokable] QUrl QAbstractOAuth2::createAuthenticatedUrl(const QUrl &url, const QVariantMap &parameters = QVariantMap())

반환된 URL은 url 을 기반으로 하며, 지정된 parameters 및 액세스 토큰과 결합됩니다.

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

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::deleteResource(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 DELETE 요청을 전송하고 새로운 QNetworkReply 을 반환합니다. url 과 parameters 은 요청을 생성하는 데 사용됩니다.

참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: DELETE

[signal, until 6.13] void QAbstractOAuth2::error(const QString &error, const QString &errorDescription, const QUrl &uri)

이 기능은 버전 6.13에서 더 이상 사용되지 않을 예정입니다.

대신 serverReportedErrorOccurred 사용

서버가 RFC 6749 오류 응답에 정의된 오류와 함께 권한 부여 요청에 응답할 때 발생하는 신호입니다.

error 는 오류의 이름이고 errorDescription 는 오류를 설명하며 uri 는 오류에 대한 자세한 정보가 포함된 선택적 URI입니다.

QAbstractOAuth::requestFailed() 및 QAbstractOAuth2::serverReportedErrorOccurred()도 참조하세요 .

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

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::get(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대체를 참조하세요.

인증된 GET 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 및 parameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: GET

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

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::head(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 HEAD 요청을 전송하고 새로운 QNetworkReply 을 반환합니다. url 과 parameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: HEAD

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

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::post(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 과 parameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, QHttpMultiPart *multiPart)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 및 multiPart 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST}

post(), QHttpMultiPart, https://tools.ietf.org/html/rfc2616#section-9.6도 참조하세요 .

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QByteArray &data)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 및 data 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST}

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

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::put(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대체를 참조하세요.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 과 parameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, QHttpMultiPart *multiPart)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 및 multiPart 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT}

put(), QHttpMultiPart, https://tools.ietf.org/html/rfc2616#section-9.6도 참조하세요 .

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QByteArray &data)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. url 및 data 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT}

put() 및 https://tools.ietf.org/html/rfc2616#section-9.6 을참조하세요 .

QString QAbstractOAuth2::refreshToken() const

현재 새로고침 토큰을 가져옵니다.

새로 고침 토큰은 일반적으로 액세스 토큰보다 수명이 길기 때문에 나중에 사용할 수 있도록 저장해 두는 것이 좋습니다.

현재 새로 고침 토큰을 반환하거나 사용 가능한 새로 고침 토큰이 없는 경우 빈 문자열을 반환합니다.

setRefreshToken()도 참조하세요 .

[slot, since 6.9] void QAbstractOAuth2::refreshTokens()

토큰을 새로 고치려면 이 함수를 호출합니다. 이 함수는 refreshTokensImplementation()를 호출하여 실제 새로 고침을 수행합니다.

이 함수는 Qt 6.9에 도입되었습니다.

refreshTokensImplementation() 및 autoRefresh 을참조하십시오 .

[protected slot, since 6.9] void QAbstractOAuth2::refreshTokensImplementation()

이 슬롯은 refreshTokens()에서 토큰 새로 고침 요청을 보내기 위해 호출합니다.

파생 클래스는 토큰 새로 고침을 지원하기 위해 이 슬롯을 다시 구현해야 합니다:

class MyClass : public QAbstractOAuth2 { ...protected Q_SLOTS: void refreshTokensImplementation() QT7_ONLY(override); };void MyClass::refreshTokensImplementation(){
    qDebug("refresh");

이 기능은 Qt 6.9에 도입되었습니다.

autoRefresh 및 accessTokenAboutToExpire()도 참조하십시오 .

QString QAbstractOAuth2::responseType() const

사용된 응답 유형을 반환합니다.

[signal, since 6.9] void QAbstractOAuth2::serverReportedErrorOccurred(const QString &error, const QString &errorDescription, const QUrl &uri)

서버가 RFC 6749 오류 응답에 정의된 오류와 함께 권한 부여 요청에 응답할 때 발생하는 신호입니다.

error 는 오류의 이름이고 errorDescription 는 오류를 설명하며 uri 는 오류에 대한 자세한 정보가 포함된 선택적 URI입니다.

이러한 RFC 정의 오류를 포함한 모든 오류를 단일 신호로 포착하려면 QAbstractOAuth::requestFailed()를 사용합니다.

이 함수는 Qt 6.9에 도입되었습니다.

[since 6.9] template <typename Functor, QAbstractOAuth2::if_compatible_callback<Functor> = true> void QAbstractOAuth2::setNetworkRequestModifier(const QAbstractOAuth2::ContextTypeForFunctor<Functor> *context, Functor &&callback)

네트워크 요청 수정 기능을 callback 으로 설정합니다. 이 기능은 서버로 전송되는 네트워크 요청을 사용자 지정하는 데 사용됩니다.

callback 시그니처 void(QNetworkRequest&, QAbstractOAuth::Stage) 를 구현해야 합니다. 제공된 QNetworkRequest 은 직접 수정할 수 있으며 콜백이 완료된 직후에 사용됩니다. callback 은 함수 포인터, 람다, 멤버 함수 또는 모든 호출 가능한 객체일 수 있습니다. 제공된 QAbstractOAuth::Stage 은 요청이 어느 단계와 관련이 있는지 확인하는 데 사용할 수 있습니다( QOAuth2DeviceAuthorizationFlow 의 경우 토큰 요청, 토큰 새로 고침 요청 또는 권한 요청).

context 는 호출의 수명을 제어하고 context 가 파괴된 경우 할당 해제된 리소스에 대한 액세스를 방지합니다. 즉, 컨텍스트로 제공된 객체가 소멸되면 콜백이 실행되지 않습니다. context 은 유효한 QObject 을 가리켜야 합니다(콜백이 멤버 함수인 경우 실제로 해당 함수가 있어야 함). 콜백의 결과는 즉시 사용되므로 context 은 QAbstractOAuth2 인스턴스와 동일한 스레드에 있어야 합니다.

이 함수는 Qt 6.9에 도입되었습니다.

clearNetworkRequestModifier() 및 QNetworkRequest도참조하십시오 .

void QAbstractOAuth2::setRefreshToken(const QString &refreshToken)

새 새로 고침 토큰 refreshToken 을 사용하도록 설정합니다.

사용자 지정 새로 고침 토큰을 사용하여 이 메서드를 통해 액세스 토큰을 새로 고친 다음 refreshTokens()를 통해 액세스 토큰을 새로 고칠 수 있습니다.

refreshToken()도 참조하세요 .

[since 6.5] void QAbstractOAuth2::setSslConfiguration(const QSslConfiguration &configuration)

클라이언트와 권한 부여 서버 간에 상호 TLS 연결을 설정할 때 사용할 TLS configuration 를 설정합니다.

이 함수는 Qt 6.5에 도입되었습니다.

sslConfiguration() 및 sslConfigurationChanged()도 참조하십시오 .

[since 6.5] QSslConfiguration QAbstractOAuth2::sslConfiguration() const

클라이언트와 권한 부여 서버 간에 상호 TLS 연결을 설정할 때 사용할 TLS 구성을 반환합니다.

이 함수는 Qt 6.5에 도입되었습니다.

setSslConfiguration() 및 sslConfigurationChanged()도 참조하십시오 .

[signal, since 6.5] void QAbstractOAuth2::sslConfigurationChanged(const QSslConfiguration &configuration)

이 신호는 TLS 구성이 변경되었을 때 전송됩니다. configuration 매개변수에는 새 TLS 구성이 포함됩니다.

이 함수는 Qt 6.5에 도입되었습니다.

sslConfiguration() 및 setSslConfiguration()도 참조하세요 .