QNetworkCookieJar Class
La clase QNetworkCookieJar implementa un sencillo «jar» de objetos de tipo « QNetworkCookie ». Más información...
| Encabezado: | #include <QNetworkCookieJar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Heredado de: | QObject |
Funciones públicas
| QNetworkCookieJar(QObject *parent = nullptr) | |
| virtual | ~QNetworkCookieJar() |
| virtual QList<QNetworkCookie> | cookiesForUrl(const QUrl &url) const |
| virtual bool | deleteCookie(const QNetworkCookie &cookie) |
| virtual bool | insertCookie(const QNetworkCookie &cookie) |
| virtual bool | setCookiesFromUrl(const QList<QNetworkCookie> &cookieList, const QUrl &url) |
| virtual bool | updateCookie(const QNetworkCookie &cookie) |
Funciones protegidas
| QList<QNetworkCookie> | allCookies() const |
| void | setAllCookies(const QList<QNetworkCookie> &cookieList) |
| virtual bool | validateCookie(const QNetworkCookie &cookie, const QUrl &url) const |
Descripción detallada
Las cookies son pequeños fragmentos de información que los protocolos sin estado, como HTTP, utilizan para mantener cierta información persistente entre solicitudes.
Un servidor remoto establece una cookie cuando responde a una solicitud y espera que se le envíe de vuelta la misma cookie cuando se envíen nuevas solicitudes.
El «cookie jar» es el objeto que contiene todas las cookies establecidas en solicitudes anteriores. Los navegadores web guardan sus «cookie jars» en el disco para conservar las cookies permanentes entre las diferentes ejecuciones de la aplicación.
QNetworkCookieJar no implementa almacenamiento permanente: solo mantiene las cookies en memoria. Una vez que se elimina el objeto QNetworkCookieJar, todas las cookies que contenía también se descartarán. Si deseas guardar las cookies, debes derivar de esta clase e implementar el guardado en disco en tu propio formato de almacenamiento.
Esta clase solo implementa la seguridad básica recomendada por las especificaciones de cookies y no implementa ninguna política de aceptación de cookies (acepta todas las cookies establecidas por cualquier solicitud). Para anular esas reglas, debes reimplementar las funciones virtuales ` cookiesForUrl()` y ` setCookiesFromUrl()`. Estas son llamadas por ` QNetworkReply ` y ` QNetworkAccessManager ` cuando detectan nuevas cookies y cuando las necesitan.
Véase también QNetworkCookie, QNetworkAccessManager, QNetworkReply, QNetworkRequest y QNetworkAccessManager::setCookieJar().
Documentación de las funciones miembro
[explicit] QNetworkCookieJar::QNetworkCookieJar(QObject *parent = nullptr)
Crea un objeto `QNetworkCookieJar` y establece como objeto padre ` parent`.
El almacén de cookies se inicializa como vacío.
[virtual noexcept] QNetworkCookieJar::~QNetworkCookieJar()
Destruye este objeto «cookie jar» y descarta todas las cookies almacenadas en él. Las cookies no se guardan en el disco en la implementación predeterminada de QNetworkCookieJar.
Si necesitas guardar las cookies en el disco, debes derivar de ` QNetworkCookieJar ` y encargarte tú mismo de guardarlas en el disco.
[protected] QList<QNetworkCookie> QNetworkCookieJar::allCookies() const
Devuelve todas las cookies almacenadas en este «bote de cookies». Esta función es adecuada para que las clases derivadas guarden las cookies en el disco, así como para implementar la caducidad de las cookies y otras políticas.
Véase también setAllCookies() y cookiesForUrl().
[virtual] QList<QNetworkCookie> QNetworkCookieJar::cookiesForUrl(const QUrl &url) const
Devuelve las cookies que se deben añadir al enviar una solicitud a url. Esta función es llamada por la función predeterminada QNetworkAccessManager::createRequest(), que añade las cookies devueltas por esta función a la solicitud que se está enviando.
Si se encuentra más de una cookie con el mismo nombre, pero con rutas diferentes, se devuelve primero la que tiene la ruta más larga antes que la que tiene la ruta más corta. En otras palabras, esta función devuelve las cookies ordenadas de mayor a menor según la longitud de la ruta.
La clase predeterminada QNetworkCookieJar solo implementa una política de seguridad muy básica (se asegura de que el dominio y la ruta de las cookies coincidan con los de la respuesta). Para mejorar la política de seguridad con tus propios algoritmos, sobrescribe cookiesForUrl().
Véase también setCookiesFromUrl() y QNetworkAccessManager::setCookieJar().
[virtual] bool QNetworkCookieJar::deleteCookie(const QNetworkCookie &cookie)
Elimina del almacén de cookies la cookie cuyo identificador coincida con el de cookie.
Devuelve true si se ha eliminado una cookie; en caso contrario, devuelve false.
Véase también QNetworkCookie::hasSameIdentifier().
[virtual] bool QNetworkCookieJar::insertCookie(const QNetworkCookie &cookie)
Añade « cookie » a este almacén de cookies.
Devuelve true si se ha añadido cookie; en caso contrario, devuelve false.
Si ya existe una cookie con el mismo identificador en el almacén de cookies, se sobrescribirá.
[protected] void QNetworkCookieJar::setAllCookies(const QList<QNetworkCookie> &cookieList)
Establece la lista interna de cookies que contiene este «cookie jar» en cookieList. Esta función es adecuada para que las clases derivadas implementen la carga de cookies desde el almacenamiento permanente, o sus propias políticas de aceptación de cookies, mediante la reimplementación de setCookiesFromUrl().
Véanse también allCookies() y setCookiesFromUrl().
[virtual] bool QNetworkCookieJar::setCookiesFromUrl(const QList<QNetworkCookie> &cookieList, const QUrl &url)
Añade las cookies de la lista cookieList a este almacén de cookies. Antes de insertarlas, las cookies se normalizan.
Devuelve true si hay una o más cookies establecidas para url; en caso contrario, devuelve false.
Si ya existe una cookie en el almacén de cookies, será sobrescrita por las de cookieList.
La clase predeterminada ` QNetworkCookieJar ` solo implementa una política de seguridad muy básica (se asegura de que el dominio y la ruta de las cookies coincidan con los de la respuesta). Para mejorar la política de seguridad con tus propios algoritmos, sobrescribe `setCookiesFromUrl()`.
Además, ` QNetworkCookieJar ` no tiene un tamaño máximo para el almacén de cookies. Reimplementa esta función para descartar las cookies más antiguas y dejar espacio para las nuevas.
Véase también cookiesForUrl(), QNetworkAccessManager::setCookieJar() y QNetworkCookie::normalize().
[virtual] bool QNetworkCookieJar::updateCookie(const QNetworkCookie &cookie)
Si en este almacén de cookies existe una cookie con el mismo identificador que cookie, se actualizará. Esta función utiliza insertCookie().
Devuelve true si se ha actualizado cookie, y false si ninguna cookie del repositorio coincide con el identificador de cookie.
Véase también QNetworkCookie::hasSameIdentifier().
[virtual protected] bool QNetworkCookieJar::validateCookie(const QNetworkCookie &cookie, const QUrl &url) const
Devuelve « true » si el dominio y la ruta de cookie son válidos; en caso contrario, devuelve «false». El parámetro « url » se utiliza para determinar si el dominio especificado en la cookie está permitido.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.