QAbstractOAuth2 Class

멤버 함수 설명서

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

parent 를 부모로 사용하여 QAbstractOAuth2 객체를 생성합니다.

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

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

[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 및 액세스 토큰이 결합된 형태입니다.

[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] void QAbstractOAuth2::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray())

QAbstractOAuth::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body)를 재구현합니다.

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

사용된 response_type 을 반환합니다.

[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> requires if_compatible_callback<Functor> 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()도 참조하십시오 .