Класс QNetworkCookieJar

Класс QNetworkCookieJar реализует простой контейнер объектов QNetworkCookie. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Защищенные функции

Подробное описание

Куки — это небольшие фрагменты информации, которые используют бессостоятельные протоколы, такие как HTTP, для сохранения некоторой постоянной информации между запросами.

Куки устанавливаются удалённым сервером в ответ на запрос и ожидают, что этот куки будет отправлен в ответ на последующие запросы.

Контейнер куки — это объект, хранящий все куки, установленные в предыдущих запросах. Веб-браузеры сохраняют свои контейнеры куки на диске, чтобы сохранить постоянные куки между запусками приложения.

QNetworkCookieJar не реализует постоянное хранение: он сохраняет куки только в памяти. После удаления объекта QNetworkCookieJar все хранившиеся в нём куки будут удалены. Если вы хотите сохранить куки, вы должны унаследовать от этого класса и реализовать сохранение на диск в свой собственный формат хранения.

Этот класс реализует только основные рекомендации по безопасности, заданные спецификациями куки, и не реализует никакой политики приема куки (он принимает все куки, установленные любыми запросами). Для переопределения этих правил необходимо переопределить виртуальные функции cookiesForUrl() и setCookiesFromUrl(). Они вызываются QNetworkReply и QNetworkAccessManager, когда они обнаруживают новые куки и когда им нужны куки.

См. также QNetworkCookie, QNetworkAccessManager, QNetworkReply, QNetworkRequest и QNetworkAccessManager::setCookieJar().

Документация по функциям-членам

QNetworkCookieJar::QNetworkCookieJar(QObject *parent = nullptr)

Создаёт объект QNetworkCookieJar и устанавливает родительский объект в parent.

Контейнер куки инициализируется пустым.

[virtual] 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, since 5.0] bool QNetworkCookieJar::deleteCookie(const QNetworkCookie &cookie)

Удаляет из контейнера куки куки, идентификатор которого совпадает с cookie.

Возвращает true если куки был удалён, в противном случае false.

Эта функция была добавлена в Qt 5.0.

См. также QNetworkCookie::hasSameIdentifier().

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

Добавляет cookie в этот контейнер куки.

Возвращает true если cookie был добавлен, в противном случае false.

Если куки с тем же идентификатором уже существует в контейнере куки, он будет перезаписан.

Эта функция была добавлена в Qt 5.0.

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

Устанавливает внутренний список куки, хранимых в этом контейнере куки, в cookieList. Эта функция подходит для производных классов, чтобы реализовать загрузку куки из постоянного хранилища или свои собственные политики приема куки, переопределив setCookiesFromUrl().

См. также allCookies() и setCookiesFromUrl().

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

Добавляет куки из списка cookieList в этот контейнер куки. Перед вставкой куки нормализуются.

Возвращает true если один или несколько куки были установлены для url, в противном случае false.

Если куки уже существует в контейнере куки, он будет перезаписан теми, что в cookieList.

По умолчанию класс QNetworkCookieJar реализует только очень простую политику безопасности (он гарантирует, что домен и путь куки совпадают с ответом). Чтобы улучшить политику безопасности с помощью собственных алгоритмов, переопределите setCookiesFromUrl().

Также QNetworkCookieJar не имеет максимального размера контейнера куки. Переопределите эту функцию, чтобы отбрасывать более старые куки, чтобы освободить место для новых.

См. также cookiesForUrl(), QNetworkAccessManager::setCookieJar() и QNetworkCookie::normalize().

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

Если куки с тем же идентификатором, что и cookie, существует в этом контейнере куки, он будет обновлён. Эта функция использует insertCookie().

Возвращает true если cookie был обновлён, в противном случае false, если в контейнере нет куки, соответствующего идентификатору cookie.

Эта функция была добавлена в Qt 5.0.

См. также QNetworkCookie::hasSameIdentifier().

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

Возвращает true если домен и путь cookie допустимы, в противном случае — false. Параметр url используется для определения, разрешен ли домен, указанный в cookie.

Эта функция была добавлена в Qt 5.0.