QNetworkCookieJar Class

멤버 함수 문서

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

QNetworkCookieJar 객체를 생성하고, 부모 객체를 parent 로 설정합니다.

쿠키 저장소는 비어 있는 상태로 초기화됩니다.

[virtual noexcept] QNetworkCookieJar::~QNetworkCookieJar()

이 쿠키 항아리 객체를 삭제하고, 그 안에 저장된 모든 쿠키를 제거합니다. QNetworkCookieJar 의 기본 구현에서는 쿠키가 디스크에 저장되지 않습니다.

쿠키를 디스크에 저장해야 하는 경우, ` QNetworkCookieJar `을 상속받아 직접 쿠키를 디스크에 저장해야 합니다.

[protected] QList<QNetworkCookie> QNetworkCookieJar::allCookies() const

이 쿠키 저장소에 저장된 모든 쿠키를 반환합니다. 이 함수는 파생 클래스가 쿠키를 디스크에 저장하거나, 쿠키 만료 및 기타 정책을 구현하는 데 적합합니다.

setAllCookies() 및 cookiesForUrl()도 참조하십시오 .

[virtual] QList<QNetworkCookie> QNetworkCookieJar::cookiesForUrl(const QUrl &url) const

url 로 요청이 전송될 때 추가될 쿠키를 반환합니다. 이 함수는 기본 ` QNetworkAccessManager::createRequest()`에 의해 호출되며, 이 함수는 이 함수가 반환한 쿠키를 전송 중인 요청에 추가합니다.

동일한 이름을 가지지만 경로가 다른 쿠키가 두 개 이상 발견될 경우, 경로가 더 긴 쿠키가 경로가 더 짧은 쿠키보다 먼저 반환됩니다. 즉, 이 함수는 경로 길이가 긴 순서대로 정렬된 쿠키를 반환합니다.

기본 QNetworkCookieJar 클래스는 매우 기본적인 보안 정책만 구현합니다(쿠키의 도메인과 경로가 응답의 도메인 및 경로와 일치하는지 확인함). 사용자 정의 알고리즘을 사용하여 보안 정책을 강화하려면 cookiesForUrl()을 재정의하십시오.

setCookiesFromUrl() 및 QNetworkAccessManager::setCookieJar()도 참조하십시오 .

[virtual] bool QNetworkCookieJar::deleteCookie(const QNetworkCookie &cookie)

cookie 와 동일한 식별자를 가진 쿠키를 쿠키 저장소에서 삭제합니다.

쿠키가 삭제된 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.

QNetworkCookie::hasSameIdentifier()도 참조하십시오 .

[virtual] bool QNetworkCookieJar::insertCookie(const QNetworkCookie &cookie)

이 쿠키 저장소에 ` cookie `를 추가합니다.

cookie 가 추가된 경우 true 를 반환하고, 그렇지 않은 경우 false를 반환합니다.

쿠키 저장소에 동일한 식별자를 가진 쿠키가 이미 존재하는 경우, 해당 쿠키는 덮어쓰게 됩니다.

[protected] void QNetworkCookieJar::setAllCookies(const QList<QNetworkCookie> &cookieList)

이 쿠키 저장소가 보유한 내부 쿠키 목록을 cookieList 로 설정합니다. 이 함수는 파생 클래스가 setCookiesFromUrl()를 재구현하여 영구 저장소에서 쿠키를 불러오거나, 자체 쿠키 허용 정책을 구현하는 데 적합합니다.

allCookies() 및 setCookiesFromUrl()도 참조하십시오 .

[virtual] bool QNetworkCookieJar::setCookiesFromUrl(const QList<QNetworkCookie> &cookieList, const QUrl &url)

cookieList 목록에 있는 쿠키들을 이 쿠키 저장소에 추가합니다. 삽입되기 전에 쿠키들은 정규화됩니다.

url 에 하나 이상의 쿠키가 설정되어 있으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

쿠키 저장소에 이미 쿠키가 존재하는 경우, 해당 쿠키는 cookieList 에 포함된 쿠키로 덮어쓰게 됩니다.

기본 QNetworkCookieJar 클래스는 매우 기본적인 보안 정책만 구현합니다(쿠키의 도메인과 경로가 응답의 도메인 및 경로와 일치하는지 확인합니다). 자체 알고리즘을 사용하여 보안 정책을 강화하려면 setCookiesFromUrl()을 재정의하십시오.

또한, ` QNetworkCookieJar `에는 쿠키 저장소의 최대 크기가 정해져 있지 않습니다. 이 함수를 재구현하여 오래된 쿠키를 삭제하고 새로운 쿠키를 저장할 공간을 확보하십시오.

cookiesForUrl(), QNetworkAccessManager::setCookieJar(), QNetworkCookie::normalize()도 참조하십시오 .

[virtual] bool QNetworkCookieJar::updateCookie(const QNetworkCookie &cookie)

이 쿠키 저장소에 cookie 과 동일한 식별자를 가진 쿠키가 존재하면 해당 쿠키가 업데이트됩니다. 이 함수는 insertCookie()를 사용합니다.

cookie 가 업데이트된 경우 true 를 반환하고, 쿠키 저장소에 cookie 의 식별자와 일치하는 쿠키가 없는 경우 false를 반환합니다.

QNetworkCookie::hasSameIdentifier()도 참조하십시오 .

[virtual protected] bool QNetworkCookieJar::validateCookie(const QNetworkCookie &cookie, const QUrl &url) const

cookie 의 도메인과 경로가 유효한 경우 ` true `을 반환하고, 그렇지 않은 경우 `false`를 반환합니다. ` url ` 매개변수는 쿠키에 지정된 도메인이 허용되는지 여부를 판단하는 데 사용됩니다.