QNetworkAccessManager Class
La clase QNetworkAccessManager permite a la aplicación enviar solicitudes de red y recibir respuestas. Más información...
| Encabezado: | #include <QNetworkAccessManager> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Heredado de: | QObject |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QNetworkAccessManager forma parte de la API de programación de red.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | Operation { HeadOperation, GetOperation, PutOperation, PostOperation, DeleteOperation, CustomOperation } |
Funciones públicas
| QNetworkAccessManager(QObject *parent = nullptr) | |
| virtual | ~QNetworkAccessManager() |
| void | addStrictTransportSecurityHosts(const QList<QHstsPolicy> &knownHosts) |
| bool | autoDeleteReplies() const |
| QAbstractNetworkCache * | cache() const |
| void | clearAccessCache() |
| void | clearConnectionCache() |
| void | connectToHost(const QString &hostName, quint16 port = 80) |
| void | connectToHostEncrypted(const QString &hostName, quint16 port = 443, const QSslConfiguration &sslConfiguration = QSslConfiguration::defaultConfiguration()) |
| void | connectToHostEncrypted(const QString &hostName, quint16 port, const QSslConfiguration &sslConfiguration, const QString &peerName) |
| QNetworkCookieJar * | cookieJar() const |
| QNetworkReply * | deleteResource(const QNetworkRequest &request) |
| void | enableStrictTransportSecurityStore(bool enabled, const QString &storeDir = QString()) |
| QNetworkReply * | get(const QNetworkRequest &request) |
(since 6.7) QNetworkReply * | get(const QNetworkRequest &request, QIODevice *data) |
(since 6.7) QNetworkReply * | get(const QNetworkRequest &request, const QByteArray &data) |
| QNetworkReply * | head(const QNetworkRequest &request) |
| bool | isStrictTransportSecurityEnabled() const |
| bool | isStrictTransportSecurityStoreEnabled() const |
| QNetworkReply * | post(const QNetworkRequest &request, QIODevice *data) |
| QNetworkReply * | post(const QNetworkRequest &request, QHttpMultiPart *multiPart) |
| QNetworkReply * | post(const QNetworkRequest &request, const QByteArray &data) |
(since 6.8) QNetworkReply * | post(const QNetworkRequest &request, std::nullptr_t nptr) |
| QNetworkProxy | proxy() const |
| QNetworkProxyFactory * | proxyFactory() const |
| QNetworkReply * | put(const QNetworkRequest &request, QIODevice *data) |
| QNetworkReply * | put(const QNetworkRequest &request, QHttpMultiPart *multiPart) |
| QNetworkReply * | put(const QNetworkRequest &request, const QByteArray &data) |
(since 6.8) QNetworkReply * | put(const QNetworkRequest &request, std::nullptr_t nptr) |
| QNetworkRequest::RedirectPolicy | redirectPolicy() const |
| QNetworkReply * | sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QIODevice *data = nullptr) |
| QNetworkReply * | sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QHttpMultiPart *multiPart) |
| QNetworkReply * | sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, const QByteArray &data) |
| void | setAutoDeleteReplies(bool shouldAutoDelete) |
| void | setCache(QAbstractNetworkCache *cache) |
| void | setCookieJar(QNetworkCookieJar *cookieJar) |
| void | setProxy(const QNetworkProxy &proxy) |
| void | setProxyFactory(QNetworkProxyFactory *factory) |
| void | setRedirectPolicy(QNetworkRequest::RedirectPolicy policy) |
| void | setStrictTransportSecurityEnabled(bool enabled) |
| void | setTransferTimeout(int timeout) |
(since 6.7) void | setTransferTimeout(std::chrono::milliseconds duration = QNetworkRequest::DefaultTransferTimeout) |
| QList<QHstsPolicy> | strictTransportSecurityHosts() const |
| virtual QStringList | supportedSchemes() const |
| int | transferTimeout() const |
(since 6.7) std::chrono::milliseconds | transferTimeoutAsDuration() const |
Señales
| void | authenticationRequired(QNetworkReply *reply, QAuthenticator *authenticator) |
| void | encrypted(QNetworkReply *reply) |
| void | finished(QNetworkReply *reply) |
| void | preSharedKeyAuthenticationRequired(QNetworkReply *reply, QSslPreSharedKeyAuthenticator *authenticator) |
| void | proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *authenticator) |
| void | sslErrors(QNetworkReply *reply, const QList<QSslError> &errors) |
Funciones protegidas
| virtual QNetworkReply * | createRequest(QNetworkAccessManager::Operation op, const QNetworkRequest &originalReq, QIODevice *outgoingData = nullptr) |
Descripción detallada
La API de acceso a la red se articula en torno a un objeto `QNetworkAccessManager`, que contiene la configuración y los ajustes comunes para las solicitudes que envía. Incluye la configuración del proxy y de la caché, así como las señales relacionadas con estos aspectos, y señales de respuesta que pueden utilizarse para supervisar el progreso de una operación de red. Una sola instancia de QNetworkAccessManager debería ser suficiente para toda la aplicación Qt. Dado que QNetworkAccessManager se basa en QObject, solo puede utilizarse desde el hilo al que pertenece.
Una vez creado un objeto QNetworkAccessManager, la aplicación puede utilizarlo para enviar solicitudes a través de la red. Se proporciona un conjunto de funciones estándar que aceptan una solicitud y datos opcionales, y cada una devuelve un objeto ` QNetworkReply `. El objeto devuelto se utiliza para obtener cualquier dato devuelto en respuesta a la solicitud correspondiente.
Una simple descarga desde la red podría realizarse así:
QNetworkAccessManager *manager = new QNetworkAccessManager(this);
connect(manager, &QNetworkAccessManager::finished,
this, &MyClass::replyFinished);
manager->get(QNetworkRequest(QUrl("http://qt-project.org")));QNetworkAccessManager dispone de una API asíncrona. Cuando se invoca la ranura replyFinished anterior, el parámetro que toma es el objeto QNetworkReply que contiene los datos descargados, así como los metadatos (encabezados, etc.).
Nota: Una vez finalizada la solicitud, es responsabilidad del usuario eliminar el objeto ` QNetworkReply ` en el momento oportuno. No lo elimines directamente dentro de la ranura conectada a ` finished()`. Puedes utilizar la función ` deleteLater()`.
Nota: QNetworkAccessManager pone en cola las solicitudes que recibe. El número de solicitudes ejecutadas en paralelo depende del protocolo. Actualmente, para el protocolo HTTP en plataformas de escritorio, se ejecutan 6 solicitudes en paralelo por cada combinación de host y puerto.
Nota: QNetworkAccessManager no gestiona correctamente la sección 8.2.2 del RFC 2616, ya que no reacciona a los datos entrantes hasta que haya terminado de escribir. Por ejemplo, la subida de un archivo de gran tamaño no se detendrá aunque el servidor devuelva un código de estado que indique al cliente que no continúe.
Un ejemplo más complejo, suponiendo que el gestor ya exista, podría ser:
QNetworkRequest request;
request.setUrl(QUrl("http://qt-project.org"));
request.setRawHeader("User-Agent", "MyOwnBrowser 1.0");
QNetworkReply *reply = manager->get(request);
connect(reply, &QIODevice::readyRead, this, &MyClass::slotReadyRead);
connect(reply, &QNetworkReply::errorOccurred,
this, &MyClass::slotError);
connect(reply, &QNetworkReply::sslErrors,
this, &MyClass::slotSslErrors);Desde Qt 6.11 se han modificado los valores predeterminados de los parámetros de TCP Keepalive utilizados por QNetworkAccessManager. Con la configuración actual, la conexión se interrumpirá tras 2 minutos de inactividad.
Estos ajustes se pueden modificar para cada solicitud individual, para hacerlos más flexibles o incluso más estrictos, a través de la API ` QNetworkRequest `.
QNetworkRequest networkRequest(url);
networkRequest.setTcpKeepAliveIdleTimeBeforeProbes(20s);
networkRequest.setTcpKeepAliveIntervalBetweenProbes(2s);
networkRequest.setTcpKeepAliveProbeCount(5);En el fragmento de código anterior optamos por una estrategia más agresiva, para interrumpir la conexión tras treinta segundos de inactividad. Esto puede resultar útil, por ejemplo, para la detección temprana de bloqueos de red provocados por cambios en la red en Linux.
Véase también QNetworkRequest, QNetworkReply y QNetworkProxy.
Documentación sobre los tipos de miembros
enum QNetworkAccessManager::Operation
Indica la operación que se está procesando en esta respuesta.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkAccessManager::HeadOperation | 1 | Operación de recuperación de encabezados (creada con head()) |
QNetworkAccessManager::GetOperation | 2 | Operación de recuperación de encabezados y descarga de contenidos (creada con get()) |
QNetworkAccessManager::PutOperation | 3 | Operación de carga de contenidos (creada con put()) |
QNetworkAccessManager::PostOperation | 4 | Enviar el contenido de un formulario HTML para su procesamiento mediante HTTP POST (creado con post()) |
QNetworkAccessManager::DeleteOperation | 5 | Operación de eliminación de contenido (creada con deleteResource()) |
QNetworkAccessManager::CustomOperation | 6 | Operación personalizada (creada con sendCustomRequest()) |
Véase también QNetworkReply::operation().
Documentación de funciones de miembro
[explicit] QNetworkAccessManager::QNetworkAccessManager(QObject *parent = nullptr)
Crea un objeto `QNetworkAccessManager`, que constituye el núcleo de la API de acceso a la red, y establece ` parent ` como objeto padre.
[virtual noexcept] QNetworkAccessManager::~QNetworkAccessManager()
Destruye el objeto ` QNetworkAccessManager ` y libera los recursos correspondientes. Ten en cuenta que los objetos ` QNetworkReply ` que devuelve esta clase tienen este objeto como padre, lo que significa que se eliminarán junto con él si no llamas a ` QObject::setParent()` sobre ellos.
void QNetworkAccessManager::addStrictTransportSecurityHosts(const QList<QHstsPolicy> &knownHosts)
Añade políticas de HTTP Strict Transport Security a la caché HSTS. El archivo « knownHosts » contiene los hosts conocidos que tienen información sobre el protocolo « QHstsPolicy ».
Nota: Una política caducada eliminará un host conocido de la caché, si este se encontraba previamente en ella.
Nota: Durante el procesamiento de las respuestas HTTP, QNetworkAccessManager también puede actualizar la caché HSTS, eliminando o actualizando políticas existentes o introduciendo nuevas knownHosts. Por lo tanto, la implementación actual está controlada por el servidor; el código del cliente puede proporcionar a QNetworkAccessManager políticas previamente conocidas o descubiertas, pero esta información puede ser anulada por los encabezados de respuesta «Strict-Transport-Security».
Véase también strictTransportSecurityHosts(), enableStrictTransportSecurityStore() y QHstsPolicy.
[signal] void QNetworkAccessManager::authenticationRequired(QNetworkReply *reply, QAuthenticator *authenticator)
Esta señal se emite cada vez que un servidor final solicita autenticación antes de entregar el contenido solicitado. La ranura conectada a esta señal debe introducir las credenciales para el contenido (que pueden determinarse inspeccionando el objeto ` reply `) en el objeto ` authenticator `.
QNetworkAccessManager Almacenará las credenciales en caché internamente y enviará los mismos valores si el servidor vuelve a requerir autenticación, sin emitir la señal authenticationRequired(). Si rechaza las credenciales, esta señal se emitirá de nuevo.
Nota: Para que la solicitud no envíe credenciales, no debes llamar a setUser() ni a setPassword() en el objeto authenticator. Esto provocará que se emita la señal finished() con un QNetworkReply con el error AuthenticationRequiredError.
Nota: Noes posible utilizar una `QueuedConnection` para conectarse a esta señal, ya que la conexión fallará si no se ha rellenado el autenticador con nueva información cuando la señal devuelva un resultado.
Véase también proxyAuthenticationRequired(), QAuthenticator::setUser() y QAuthenticator::setPassword().
bool QNetworkAccessManager::autoDeleteReplies() const
Devuelve «true» si « QNetworkAccessManager » está configurado actualmente para eliminar automáticamente las respuestas de QNetworkReplies; en caso contrario, devuelve «false».
Véase también setAutoDeleteReplies y QNetworkRequest::AutoDeleteReplyOnFinishAttribute.
QAbstractNetworkCache *QNetworkAccessManager::cache() const
Devuelve la caché que se utiliza para almacenar los datos obtenidos de la red.
Véase también setCache().
void QNetworkAccessManager::clearAccessCache()
Vacíe la caché interna de datos de autenticación y conexiones de red.
Esta función resulta útil para realizar pruebas automáticas.
Véase también clearConnectionCache().
void QNetworkAccessManager::clearConnectionCache()
Vacía la caché interna de conexiones de red. A diferencia de clearAccessCache(), los datos de autenticación se conservan.
Véase también clearAccessCache().
void QNetworkAccessManager::connectToHost(const QString &hostName, quint16 port = 80)
Inicia una conexión con el servidor especificado en hostName en el puerto port. Esta función resulta útil para completar el protocolo de enlace TCP con un servidor antes de realizar la solicitud HTTP, lo que se traduce en una menor latencia de red.
Nota: Esta función no tiene la posibilidad de notificar errores.
Véanse también connectToHostEncrypted(), get(), post(), put() y deleteResource().
void QNetworkAccessManager::connectToHostEncrypted(const QString &hostName, quint16 port = 443, const QSslConfiguration &sslConfiguration = QSslConfiguration::defaultConfiguration())
Inicia una conexión con el servidor especificado en hostName en el puerto port, utilizando sslConfiguration. Esta función resulta útil para completar el protocolo de enlace TCP y SSL con un servidor antes de realizar la solicitud HTTPS, lo que se traduce en una menor latencia de red.
Nota: Se puedeestablecer previamente una conexión HTTP/2 llamando a setAllowedNextProtocols() en sslConfiguration con QSslConfiguration::ALPNProtocolHTTP2 incluido en la lista de protocolos permitidos. Al utilizar HTTP/2, basta con una única conexión por host; es decir, llamar a este método varias veces por host no se traducirá en transacciones de red más rápidas.
Nota: Esta función no tiene la posibilidad de informar de errores.
Véase también connectToHost(), get(), post(), put() y deleteResource().
void QNetworkAccessManager::connectToHostEncrypted(const QString &hostName, quint16 port, const QSslConfiguration &sslConfiguration, const QString &peerName)
Inicia una conexión con el host indicado en hostName en el puerto port, utilizando sslConfiguration con peerName configurado como el nombre de host que se utilizará para la validación del certificado. Esta función resulta útil para completar el establecimiento de conexión TCP y SSL con un host antes de que se realice la solicitud HTTPS, lo que se traduce en una menor latencia de red.
Nota: Se puede establecer una conexión HTTP/2previa llamando a setAllowedNextProtocols() en sslConfiguration con QSslConfiguration::ALPNProtocolHTTP2 incluido en la lista de protocolos permitidos. Al utilizar HTTP/2, basta con una única conexión por host; es decir, llamar a este método varias veces por host no se traducirá en transacciones de red más rápidas.
Nota: Esta función no tiene la posibilidad de notificar errores.
Se trata de una función sobrecargada.
Véase también connectToHost(), get(), post(), put() y deleteResource().
QNetworkCookieJar *QNetworkAccessManager::cookieJar() const
Devuelve el objeto ` QNetworkCookieJar `, que se utiliza para almacenar las cookies obtenidas de la red, así como las que están a punto de enviarse.
Véase también setCookieJar().
[virtual protected] QNetworkReply *QNetworkAccessManager::createRequest(QNetworkAccessManager::Operation op, const QNetworkRequest &originalReq, QIODevice *outgoingData = nullptr)
Devuelve un nuevo objeto ` QNetworkReply ` para gestionar la operación ` op ` y la solicitud ` originalReq`. El parámetro ` outgoingData ` del dispositivo es siempre 0 para las solicitudes `Get` y `Head`, pero es el valor que se pasa a ` post()` y ` put()` en dichas operaciones (las variantes ` QByteArray ` pasarán un objeto ` QBuffer `).
La implementación predeterminada llama a QNetworkCookieJar::cookiesForUrl() sobre el almacén de cookies configurado con setCookieJar() para obtener las cookies que se enviarán al servidor remoto.
El objeto devuelto debe estar en estado abierto.
QNetworkReply *QNetworkAccessManager::deleteResource(const QNetworkRequest &request)
Envía una solicitud para eliminar el recurso identificado por la URL request.
Nota: Esta función solo está disponible actualmente para HTTP, mediante una solicitud HTTP DELETE.
Véase también get(), post(), put() y sendCustomRequest().
void QNetworkAccessManager::enableStrictTransportSecurityStore(bool enabled, const QString &storeDir = QString())
Si enabled es true, la caché interna de HSTS utilizará un almacén persistente para leer y escribir políticas HSTS. storeDir define dónde se ubicará este almacén. La ubicación por defecto viene definida por QStandardPaths::CacheLocation. Si no hay ningún QStandartPaths::CacheLocation en el que se pueda escribir y storeDir es una cadena vacía, el almacén se ubicará en el directorio de trabajo del programa.
Nota: Si la caché de HSTS ya contiene políticas de HSTS en el momento en que se habilita el almacén persistente, estas políticas se conservarán en el almacén. En caso de que tanto la caché como el almacén contengan los mismos hosts conocidos, se considerará que las políticas de la caché están más actualizadas (y, por lo tanto, sobrescribirán los valores anteriores del almacén). Si este comportamiento no es el deseado, habilita el almacén HSTS antes de habilitar la Seguridad de transporte estricta. De forma predeterminada, el almacén persistente de políticas HSTS está deshabilitado.
Nota: El almacén de HSTS guarda las políticas en el disco mediante un archivo ` QSettings ` en formato INI, sin cifrado ni protección de integridad. El almacén revela con qué hosts se ha comunicado la aplicación a través de HTTPS, ya que se registra una entrada HSTS para cada host que envía un encabezado «Strict-Transport-Security». En aplicaciones en las que la privacidad es fundamental, este historial de conexiones debe tratarse como datos confidenciales.
Un atacante con acceso de escritura al archivo de almacenamiento podría eliminar entradas HSTS de dominios específicos, lo que provocaría que la aplicación permitiera conexiones HTTP en texto plano a dichos dominios en solicitudes posteriores y, potencialmente, facilitaría ataques de «SSL stripping». Las aplicaciones que dependen de HSTS deben asegurarse de que el directorio de almacenamiento esté protegido mediante los permisos adecuados del sistema de archivos.
Véase también isStrictTransportSecurityStoreEnabled(), setStrictTransportSecurityEnabled() y QStandardPaths::standardLocations().
[signal] void QNetworkAccessManager::encrypted(QNetworkReply *reply)
Esta señal se emite cuando una sesión SSL/TLS ha completado con éxito el protocolo de establecimiento inicial. En este momento, aún no se han transmitido datos de usuario. La señal puede utilizarse para realizar comprobaciones adicionales en la cadena de certificados, por ejemplo, para notificar a los usuarios cuando ha cambiado el certificado de un sitio web. El parámetro ` reply ` especifica qué respuesta de red es la responsable. Si la respuesta no cumple los criterios esperados, debe abortarse llamando a ` QNetworkReply::abort()` desde un slot conectado a esta señal. La configuración SSL en uso puede consultarse mediante el método ` QNetworkReply::sslConfiguration()`.
Internamente, ` QNetworkAccessManager ` puede abrir varias conexiones a un servidor para permitir el procesamiento de solicitudes en paralelo. Estas conexiones pueden reutilizarse, lo que significa que no se emitiría la señal `encrypted()`. Esto implica que solo se garantiza la recepción de esta señal para la primera conexión a un sitio durante el ciclo de vida de ` QNetworkAccessManager`.
Véanse también QSslSocket::encrypted() y QNetworkReply::encrypted().
[signal] void QNetworkAccessManager::finished(QNetworkReply *reply)
Esta señal se emite cada vez que finaliza una respuesta de red pendiente. El parámetro ` reply ` contendrá un puntero a la respuesta que acaba de finalizar. Esta señal se emite junto con la señal ` QNetworkReply::finished()`.
Consulta QNetworkReply::finished() para obtener información sobre el estado en el que se encontrará el objeto.
Nota: No elimines el objeto ` reply ` en la ranura conectada a esta señal. Utiliza ` deleteLater()`.
Véase también QNetworkReply::finished() y QNetworkReply::error().
QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request)
Envía una solicitud para obtener el contenido de la dirección request y devuelve un nuevo objeto QNetworkReply abierto en modo lectura, que emite la señal readyRead() cada vez que llegan nuevos datos.
Se descargarán tanto el contenido como los encabezados asociados.
Véase también post(), put(), deleteResource() y sendCustomRequest().
[since 6.7] QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request, QIODevice *data)
Nota: Una solicitud GET con cuerpo de mensaje no se almacena en caché.
Nota: Si la solicitud se redirige, el cuerpo del mensaje solo se conservará si el código de estado es 308.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
[since 6.7] QNetworkReply *QNetworkAccessManager::get(const QNetworkRequest &request, const QByteArray &data)
Nota: Una solicitud GET con cuerpo de mensaje no se almacena en caché.
Nota: Si la solicitud se redirige, el cuerpo del mensaje solo se conservará si el código de estado es 308.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.7.
QNetworkReply *QNetworkAccessManager::head(const QNetworkRequest &request)
Envía una solicitud para obtener los encabezados de red de request y devuelve un nuevo objeto QNetworkReply que contendrá dichos encabezados.
La función recibe su nombre del tipo de solicitud HTTP asociada (HEAD).
bool QNetworkAccessManager::isStrictTransportSecurityEnabled() const
Devuelve «true» si se ha habilitado HTTP Strict Transport Security (HSTS). Por defecto, HSTS está deshabilitado.
Véase también ` setStrictTransportSecurityEnabled()`.
bool QNetworkAccessManager::isStrictTransportSecurityStoreEnabled() const
Devuelve «true» si la caché HSTS utiliza un almacenamiento permanente para cargar y guardar políticas HSTS.
Véase también enableStrictTransportSecurityStore().
QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, QIODevice *data)
Envía una solicitud HTTP POST al destino especificado por request y devuelve un nuevo objeto QNetworkReply abierto en modo lectura que contendrá la respuesta enviada por el servidor. El contenido del dispositivo data se subirá al servidor.
data debe estar abierto en modo lectura y debe permanecer válido hasta que se emita la señal finished() para esta respuesta.
Nota: El envío de una solicitud POST en protocolos distintos de HTTP y HTTPS no está definido y probablemente fallará.
Véanse también get(), put(), deleteResource() y sendCustomRequest().
QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, QHttpMultiPart *multiPart)
Envía el contenido del mensaje « multiPart » al destino especificado por « request ».
Esto se puede utilizar para enviar mensajes MIME multiparte a través de HTTP.
Se trata de una función sobrecargada.
Véanse también QHttpMultiPart, QHttpPart y put().
QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, const QByteArray &data)
Envía el contenido de la matriz de bytes ` data ` al destino especificado por ` request`.
Esta es una función sobrecargada.
[since 6.8] QNetworkReply *QNetworkAccessManager::post(const QNetworkRequest &request, std::nullptr_t nptr)
Envía la solicitud POST especificada por ` request ` sin cuerpo y devuelve un nuevo objeto ` QNetworkReply `.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
[signal] void QNetworkAccessManager::preSharedKeyAuthenticationRequired(QNetworkReply *reply, QSslPreSharedKeyAuthenticator *authenticator)
Esta señal se emite si el protocolo de enlace SSL/TLS negocia un conjunto de cifrado PSK y, por lo tanto, se requiere una autenticación PSK. El objeto « reply » es el « QNetworkReply » que está negociando dichos conjuntos de cifrado.
Al utilizar PSK, el cliente debe enviar al servidor una identidad válida y una clave precompartida válida para que el protocolo de enlace SSL pueda continuar. Las aplicaciones pueden proporcionar esta información en una ranura conectada a esta señal, rellenando el objeto ` authenticator ` pasado según sus necesidades.
Nota: Si se ignora esta señal o no se proporcionan las credenciales necesarias, el protocolo de enlace fallará y, por lo tanto, la conexión se interrumpirá.
Nota: El objeto ` authenticator ` es propiedad de la respuesta y la aplicación no debe eliminarlo.
Véase también QSslPreSharedKeyAuthenticator.
QNetworkProxy QNetworkAccessManager::proxy() const
Devuelve el QNetworkProxy que utilizarán las solicitudes enviadas mediante este objeto QNetworkAccessManager. El valor predeterminado del proxy es QNetworkProxy::DefaultProxy.
Véanse también setProxy(), setProxyFactory() y proxyAuthenticationRequired().
[signal] void QNetworkAccessManager::proxyAuthenticationRequired(const QNetworkProxy &proxy, QAuthenticator *authenticator)
Esta señal se emite cada vez que un proxy solicita autenticación y QNetworkAccessManager no encuentra una credencial válida almacenada en caché. El slot conectado a esta señal debe introducir las credenciales para el proxy proxy en el objeto authenticator.
QNetworkAccessManager almacenará las credenciales en caché internamente. La próxima vez que el proxy solicite autenticación, QNetworkAccessManager enviará automáticamente las mismas credenciales sin emitir de nuevo la señal «proxyAuthenticationRequired».
Si el proxy rechaza las credenciales, QNetworkAccessManager emitirá la señal de nuevo.
Véase también proxy(), setProxy() y authenticationRequired().
QNetworkProxyFactory *QNetworkAccessManager::proxyFactory() const
Devuelve la fábrica de proxies que este objeto ` QNetworkAccessManager ` utiliza para determinar los proxies que se emplearán en las solicitudes.
Ten en cuenta que el puntero devuelto por esta función es gestionado por QNetworkAccessManager y podría ser eliminado en cualquier momento.
Véase también setProxyFactory() y proxy().
QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, QIODevice *data)
Carga el contenido de data en el destino request y devuelve un nuevo objeto QNetworkReply que permanecerá abierto para la respuesta.
data Debe estar abierto en modo lectura cuando se llama a esta función y debe permanecer válido hasta que se emita la señal finished() para esta respuesta.
Que haya algo disponible para leer en el objeto devuelto depende del protocolo. En el caso de HTTP, el servidor puede enviar una pequeña página HTML indicando que la subida se ha realizado correctamente (o no). Es probable que otros protocolos incluyan contenido en sus respuestas.
Nota: En el caso de HTTP, esta función enviará una solicitud PUT, que la mayoría de los servidores no permiten. Los mecanismos de envío de formularios, incluido el de subir archivos a través de formularios HTML, utilizan el mecanismo POST.
Véase también get(), post(), deleteResource() y sendCustomRequest().
QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, QHttpMultiPart *multiPart)
Envía el contenido del mensaje « multiPart » al destino especificado en « request ».
Esto se puede utilizar para enviar mensajes MIME multiparte a través de HTTP.
Se trata de una función sobrecargada.
Véanse también QHttpMultiPart, QHttpPart y post().
QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, const QByteArray &data)
Envía el contenido de la matriz de bytes « data » al destino especificado por « request ».
Esta es una función sobrecargada.
[since 6.8] QNetworkReply *QNetworkAccessManager::put(const QNetworkRequest &request, std::nullptr_t nptr)
Envía la solicitud PUT especificada por request sin cuerpo y devuelve un nuevo objeto QNetworkReply.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
QNetworkRequest::RedirectPolicy QNetworkAccessManager::redirectPolicy() const
Devuelve la política de redireccionamiento que se utiliza al crear nuevas solicitudes.
Véase también setRedirectPolicy() y QNetworkRequest::RedirectPolicy.
QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QIODevice *data = nullptr)
Envía una solicitud personalizada al servidor identificado por la URL request.
Es responsabilidad del usuario enviar una solicitud verb al servidor que sea válida según la especificación HTTP.
Este método permite enviar verbos distintos de los habituales proporcionados a través de get() o post() etc., por ejemplo, enviando un comando HTTP OPTIONS.
Si data no está vacío, el contenido del dispositivo data se subirá al servidor; en ese caso, los datos deben estar abiertos para su lectura y deben permanecer válidos hasta que se emita la señal finished() para esta respuesta.
Nota: Esta función solo está disponible actualmente para HTTP(S).
Véase también get(), post(), put() y deleteResource().
QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, QHttpMultiPart *multiPart)
Envía una solicitud personalizada al servidor identificado por la URL request.
Envía el contenido del mensaje multiPart al destino especificado por request.
Esto se puede utilizar para enviar mensajes MIME multiparte para verbos personalizados.
Se trata de una función sobrecargada.
Véase también QHttpMultiPart, QHttpPart y put().
QNetworkReply *QNetworkAccessManager::sendCustomRequest(const QNetworkRequest &request, const QByteArray &verb, const QByteArray &data)
Envía el contenido de la matriz de bytes « data » al destino especificado por « request ».
Esta es una función sobrecargada.
void QNetworkAccessManager::setAutoDeleteReplies(bool shouldAutoDelete)
Activa o desactiva la eliminación automática de QNetworkReplies.
Establecer « shouldAutoDelete » en «true» equivale a establecer el atributo « QNetworkRequest::AutoDeleteReplyOnFinishAttribute » en «true» en todos los futuros « QNetworkRequests » pasados a esta instancia de « QNetworkAccessManager », a menos que el atributo ya se haya establecido explícitamente en el « QNetworkRequest ».
Véase también autoDeleteReplies y QNetworkRequest::AutoDeleteReplyOnFinishAttribute.
void QNetworkAccessManager::setCache(QAbstractNetworkCache *cache)
Establece la caché de red del gestor en el objeto « cache » especificado. La caché se utiliza para todas las solicitudes enviadas por el gestor.
Utiliza esta función para establecer el objeto de caché de red en una clase que implemente características adicionales, como guardar las cookies en un almacenamiento permanente.
Nota: ` QNetworkAccessManager ` asume la propiedad del objeto ` cache `.
QNetworkAccessManager Por defecto, no tiene una caché configurada. Qt proporciona una caché de disco sencilla, ` QNetworkDiskCache`, que se puede utilizar.
Véase también ` cache()` y ` QNetworkRequest::CacheLoadControl`.
void QNetworkAccessManager::setCookieJar(QNetworkCookieJar *cookieJar)
Establece el «cookie jar» del gestor en el cookieJar especificado. El «cookie jar» es utilizado por todas las solicitudes enviadas por el gestor.
Utiliza esta función para establecer el objeto «cookie jar» en una clase que implemente características adicionales, como guardar las cookies en un almacenamiento permanente.
Nota: ` QNetworkAccessManager ` asume la propiedad del objeto ` cookieJar `.
Si cookieJar se encuentra en el mismo hilo que este QNetworkAccessManager, establecerá el padre de cookieJar de modo que el «cookie jar» se elimine cuando también se elimine este objeto. Si desea compartir «cookie jars» entre diferentes objetos QNetworkAccessManager, es posible que le interese establecer el padre del «cookie jar» en 0 tras llamar a esta función.
QNetworkAccessManager Por defecto, no implementa ninguna política de cookies propia: acepta todas las cookies enviadas por el servidor, siempre que estén bien formadas y cumplan los requisitos mínimos de seguridad (el dominio de la cookie coincide con el de la solicitud y la ruta de la cookie coincide con la de la solicitud). Para implementar tu propia política de seguridad, sobrescribe las funciones virtuales ` QNetworkCookieJar::cookiesForUrl()` y ` QNetworkCookieJar::setCookiesFromUrl()`. QNetworkAccessManager invoca esas funciones cuando detecta una nueva cookie.
Véase también cookieJar(), QNetworkCookieJar::cookiesForUrl() y QNetworkCookieJar::setCookiesFromUrl().
void QNetworkAccessManager::setProxy(const QNetworkProxy &proxy)
Establece el proxy que se utilizará en futuras solicitudes como proxy. Esto no afecta a las solicitudes que ya se hayan enviado. Se emitirá la señal proxyAuthenticationRequired() si el proxy solicita autenticación.
El proxy configurado con esta función se utilizará para todas las solicitudes emitidas por QNetworkAccessManager. En algunos casos, puede ser necesario seleccionar diferentes proxies en función del tipo de solicitud que se envíe o del host de destino. Si ese es el caso, deberías plantearte utilizar setProxyFactory().
Véase también proxy() y proxyAuthenticationRequired().
void QNetworkAccessManager::setProxyFactory(QNetworkProxyFactory *factory)
Establece la fábrica de proxies de esta clase como factory. Una fábrica de proxies se utiliza para determinar una lista más específica de proxies que se utilizarán para una solicitud determinada, en lugar de intentar utilizar el mismo valor de proxy para todas las solicitudes.
Todas las consultas enviadas por QNetworkAccessManager tendrán el tipo QNetworkProxyQuery::UrlRequest.
Por ejemplo, una fábrica de proxies podría aplicar las siguientes reglas:
- si la dirección de destino se encuentra en la red local (por ejemplo, si el nombre de host no contiene puntos o si se trata de una dirección IP dentro del rango de la organización), devuelve QNetworkProxy::NoProxy
- si la solicitud es FTP, devuelve un proxy FTP
- si la solicitud es HTTP o HTTPS, devuelve un proxy HTTP
- en caso contrario, devolver un servidor proxy SOCKSv5
La vida útil del objeto ` factory ` será gestionada por ` QNetworkAccessManager`. Este eliminará el objeto cuando sea necesario.
Nota: Si se configura un proxy específico con ` setProxy()`, no se utilizará la fábrica.
Véase también proxyFactory(), setProxy() y QNetworkProxyQuery.
void QNetworkAccessManager::setRedirectPolicy(QNetworkRequest::RedirectPolicy policy)
Establece la política de redireccionamiento del gestor para que sea la especificada en policy. Esta política afectará a todas las solicitudes posteriores creadas por el gestor.
Utiliza esta función para habilitar o deshabilitar las redirecciones HTTP a nivel del gestor.
Nota: Al crear una solicitud, QNetworkRequest::RedirectAttributePolicy tiene la máxima prioridad, seguida, por orden de prioridad, de la política del gestor.
El valor por defecto es QNetworkRequest::NoLessSafeRedirectPolicy. Se recomienda a los clientes que utilicen la gestión manual de redireccionamientos que establezcan esta política de forma explícita en su código.
Véase también ` redirectPolicy()` y ` QNetworkRequest::RedirectPolicy`.
void QNetworkAccessManager::setStrictTransportSecurityEnabled(bool enabled)
Si enabled es true, QNetworkAccessManager sigue la política de seguridad de transporte estricto de HTTP (HSTS, RFC 6797). Al procesar una solicitud, QNetworkAccessManager sustituye automáticamente el esquema «http» por «https» y utiliza un transporte seguro para los hosts HSTS. Si se configura explícitamente, el puerto 80 se sustituye por el puerto 443.
Cuando HSTS está habilitado, por cada respuesta HTTP que contenga un encabezado HSTS y se reciba a través de un transporte seguro, QNetworkAccessManager actualizará su caché HSTS, ya sea recordando un host con una política válida o eliminando un host con una política HSTS caducada o deshabilitada.
Véase también isStrictTransportSecurityEnabled().
void QNetworkAccessManager::setTransferTimeout(int timeout)
Establece timeout como el tiempo de espera de la transferencia en milisegundos.
Véase también setTransferTimeout(std::chrono::milliseconds), transferTimeout() y transferTimeoutAsDuration().
[since 6.7] void QNetworkAccessManager::setTransferTimeout(std::chrono::milliseconds duration = QNetworkRequest::DefaultTransferTimeout)
Establece el tiempo de espera duration, para interrumpir la transferencia si no se intercambian datos.
Las transferencias se interrumpen si no se transfieren bytes antes de que expire el tiempo de espera. El valor cero significa que no se ha establecido ningún temporizador. Si no se proporciona ningún argumento, el tiempo de espera es QNetworkRequest::DefaultTransferTimeout. Si no se llama a esta función, el tiempo de espera queda desactivado y tiene el valor cero. Los tiempos de espera distintos de cero específicos de la solicitud que se hayan establecido para las solicitudes que se ejecuten anulan este valor. Esto significa que, si QNetworkAccessManager tiene un tiempo de espera activado, es necesario desactivarlo para ejecutar una solicitud sin tiempo de espera.
Esta función se introdujo en Qt 6.7.
Véase también transferTimeoutAsDuration().
[signal] void QNetworkAccessManager::sslErrors(QNetworkReply *reply, const QList<QSslError> &errors)
Esta señal se emite si la sesión SSL/TLS ha detectado errores durante el establecimiento, incluidos los errores de verificación de certificados. El parámetro ` errors ` contiene la lista de errores y ` reply ` es el ` QNetworkReply ` en el que se han producido dichos errores.
Para indicar que los errores no son graves y que la conexión debe continuar, se debe llamar a la función QNetworkReply::ignoreSslErrors() desde el slot conectado a esta señal. Si no se llama a esta función, la sesión SSL se interrumpirá antes de que se intercambie ningún dato (incluida la URL).
Esta señal se puede utilizar para mostrar al usuario un mensaje de error indicando que la seguridad podría verse comprometida y para mostrar la configuración SSL (véase sslConfiguration() para obtenerla). Si el usuario decide continuar tras analizar el certificado remoto, el slot debe llamar a ignoreSslErrors().
Véase también QSslSocket::sslErrors(), QNetworkReply::sslErrors(), QNetworkReply::sslConfiguration() y QNetworkReply::ignoreSslErrors().
QList<QHstsPolicy> QNetworkAccessManager::strictTransportSecurityHosts() const
Devuelve la lista de políticas de seguridad de transporte estricto (HSTS). Esta lista puede diferir de la configurada inicialmente mediante addStrictTransportSecurityHosts() si la caché de HSTS se ha actualizado a partir de un encabezado de respuesta «Strict-Transport-Security».
Véase también ` addStrictTransportSecurityHosts()` y ` QHstsPolicy`.
[virtual] QStringList QNetworkAccessManager::supportedSchemes() const
Enumera todos los esquemas de URL compatibles con el gestor de acceso.
Reimplementa este método para proporcionar tus propios esquemas compatibles en una subclase de ` QNetworkAccessManager `. Esto resulta necesario, por ejemplo, cuando tu subclase ofrece compatibilidad con nuevos protocolos.
int QNetworkAccessManager::transferTimeout() const
Devuelve el tiempo de espera utilizado para las transferencias, en milisegundos.
Véase también setTransferTimeout().
[since 6.7] std::chrono::milliseconds QNetworkAccessManager::transferTimeoutAsDuration() const
Devuelve la duración del tiempo de espera tras la cual se interrumpe la transferencia si no se intercambian datos.
La duración por defecto es cero, lo que significa que no se aplica el tiempo de espera.
Esta función se introdujo en Qt 6.7.
Véase también ` setTransferTimeout` (`std::chrono::milliseconds`).
© 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.