QNetworkReply Class
La clase `QNetworkReply` contiene los datos y los encabezados de una solicitud enviada con ` QNetworkAccessManager`. Más información...
| Encabezado: | #include <QNetworkReply> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Heredado de: | QIODevice |
- Lista de todos los miembros, incluidos los heredados
- QNetworkReply forma parte de la API de programación de red.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | NetworkError { NoError, ConnectionRefusedError, RemoteHostClosedError, HostNotFoundError, TimeoutError, …, UnknownServerError } |
| RawHeaderPair |
Funciones públicas
| virtual | ~QNetworkReply() |
| QVariant | attribute(QNetworkRequest::Attribute code) const |
| QNetworkReply::NetworkError | error() const |
| bool | hasRawHeader(QAnyStringView headerName) const |
| QVariant | header(QNetworkRequest::KnownHeaders header) const |
(since 6.8) QHttpHeaders | headers() const |
| void | ignoreSslErrors(const QList<QSslError> &errors) |
| bool | isFinished() const |
| bool | isRunning() const |
| QNetworkAccessManager * | manager() const |
| QNetworkAccessManager::Operation | operation() const |
| QByteArray | rawHeader(QAnyStringView headerName) const |
| QList<QByteArray> | rawHeaderList() const |
| const QList<QNetworkReply::RawHeaderPair> & | rawHeaderPairs() const |
| qint64 | readBufferSize() const |
| QNetworkRequest | request() const |
| virtual void | setReadBufferSize(qint64 size) |
| void | setSslConfiguration(const QSslConfiguration &config) |
| QSslConfiguration | sslConfiguration() const |
| QUrl | url() const |
Funciones públicas reimplementadas
| virtual void | close() override |
| virtual bool | isSequential() const override |
Ranuras públicas
| virtual void | abort() = 0 |
| virtual void | ignoreSslErrors() |
Señales
| void | downloadProgress(qint64 bytesReceived, qint64 bytesTotal) |
| void | encrypted() |
| void | errorOccurred(QNetworkReply::NetworkError code) |
| void | finished() |
| void | metaDataChanged() |
| void | preSharedKeyAuthenticationRequired(QSslPreSharedKeyAuthenticator *authenticator) |
| void | redirectAllowed() |
| void | redirected(const QUrl &url) |
(since 6.3) void | requestSent() |
(since 6.3) void | socketStartedConnecting() |
| void | sslErrors(const QList<QSslError> &errors) |
| void | uploadProgress(qint64 bytesSent, qint64 bytesTotal) |
Funciones protegidas
| QNetworkReply(QObject *parent = nullptr) | |
| virtual void | ignoreSslErrorsImplementation(const QList<QSslError> &errors) |
| void | setAttribute(QNetworkRequest::Attribute code, const QVariant &value) |
| void | setError(QNetworkReply::NetworkError errorCode, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value) |
(since 6.8) void | setHeaders(const QHttpHeaders &newHeaders) |
(since 6.8) void | setHeaders(QHttpHeaders &&newHeaders) |
| void | setOperation(QNetworkAccessManager::Operation operation) |
| void | setRawHeader(const QByteArray &headerName, const QByteArray &value) |
| void | setRequest(const QNetworkRequest &request) |
| virtual void | setSslConfigurationImplementation(const QSslConfiguration &configuration) |
| void | setUrl(const QUrl &url) |
(since 6.8) void | setWellKnownHeader(QHttpHeaders::WellKnownHeader name, QByteArrayView value) |
| virtual void | sslConfigurationImplementation(QSslConfiguration &configuration) const |
Funciones protegidas reimplementadas
| virtual qint64 | writeData(const char *data, qint64 len) override |
Descripción detallada
La clase `QNetworkReply` contiene los datos y metadatos relacionados con una solicitud enviada mediante ` QNetworkAccessManager`. Al igual que ` QNetworkRequest`, contiene una URL y encabezados (tanto en formato analizado como sin procesar), cierta información sobre el estado de la respuesta y el contenido de la propia respuesta.
QNetworkReply es un ` QIODevice` de acceso secuencial, lo que significa que, una vez leídos los datos del objeto, el dispositivo ya no los conserva. Por lo tanto, es responsabilidad de la aplicación conservar estos datos si los necesita. Cada vez que se reciben y procesan más datos de la red, se emite la señal ` readyRead()`.
La señal downloadProgress() también se emite cuando se reciben datos, pero es posible que el número de bytes que contiene no represente los bytes realmente recibidos, si se realiza alguna transformación en el contenido (por ejemplo, descomprimir y eliminar la sobrecarga del protocolo).
Aunque QNetworkReply es un objeto de tipo « QIODevice » conectado al contenido de la respuesta, también emite la señal « uploadProgress()», que indica el progreso de la carga en las operaciones que tienen dicho contenido.
Nota: No elimines el objeto en la ranura conectada a la señal « errorOccurred()» o « finished()». Utiliza « deleteLater()».
Véase también QNetworkRequest y QNetworkAccessManager.
Documentación sobre tipos de miembros
enum QNetworkReply::NetworkError
Indica todas las posibles condiciones de error detectadas durante el procesamiento de la solicitud.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkReply::NoError | 0 | No hay ninguna condición de error. Nota: Cuando el protocolo HTTP devuelve una redirección, no se notificará ningún error. Puedes comprobar si hay una redirección con el atributo « QNetworkRequest::RedirectionTargetAttribute ». |
QNetworkReply::ConnectionRefusedError | 1 | el servidor remoto ha rechazado la conexión (el servidor no acepta solicitudes) |
QNetworkReply::RemoteHostClosedError | 2 | el servidor remoto cerró la conexión prematuramente, antes de que se recibiera y procesara la respuesta completa |
QNetworkReply::HostNotFoundError | 3 | no se ha encontrado el nombre del host remoto (nombre de host no válido) |
QNetworkReply::TimeoutError | 4 | se agotó el tiempo de espera de la conexión con el servidor remoto |
QNetworkReply::OperationCanceledError | 5 | la operación se canceló mediante llamadas a ` abort()` o ` close()` antes de que finalizara. |
QNetworkReply::SslHandshakeFailedError | 6 | El protocolo de enlace SSL/TLS ha fallado y no se ha podido establecer el canal cifrado. Se debería haber emitido la señal ` sslErrors()`. |
QNetworkReply::TemporaryNetworkFailureError | 7 | La conexión se interrumpió debido a una desconexión de la red; sin embargo, el sistema ha iniciado el roaming hacia otro punto de acceso. La solicitud debe reenviarse y se procesará tan pronto como se restablezca la conexión. |
QNetworkReply::NetworkSessionFailedError | 8 | La conexión se ha interrumpido debido a una desconexión de la red o a un fallo al iniciar la red. |
QNetworkReply::BackgroundRequestNotAllowedError | 9 | La solicitud en segundo plano no está permitida actualmente debido a la política de la plataforma. |
QNetworkReply::TooManyRedirectsError | 10 | Al seguir las redirecciones, se ha alcanzado el límite máximo. El límite está establecido por defecto en 50 o según lo definido por QNetworkRequest::setMaxRedirectsAllowed(). (Este valor se introdujo en la versión 5.6.) |
QNetworkReply::InsecureRedirectError | 11 | Al seguir las redirecciones, la API de acceso a la red detectó una redirección de un protocolo cifrado (https) a uno no cifrado (http). (Este valor se introdujo en la versión 5.6.) |
QNetworkReply::ProxyConnectionRefusedError | 101 | Se ha rechazado la conexión con el servidor proxy (el servidor proxy no acepta solicitudes). |
QNetworkReply::ProxyConnectionClosedError | 102 | El servidor proxy cerró la conexión prematuramente, antes de que se recibiera y procesara la respuesta completa. |
QNetworkReply::ProxyNotFoundError | 103 | No se ha encontrado el nombre de host del proxy (nombre de host del proxy no válido) |
QNetworkReply::ProxyTimeoutError | 104 | La conexión con el proxy agotó el tiempo de espera o el proxy no respondió a tiempo a la solicitud enviada |
QNetworkReply::ProxyAuthenticationRequiredError | 105 | el proxy requiere autenticación para atender la solicitud, pero no ha aceptado ninguna de las credenciales proporcionadas (si las había) |
QNetworkReply::ContentAccessDenied | 201 | Se denegó el acceso al contenido remoto (similar al error HTTP 403) |
QNetworkReply::ContentOperationNotPermittedError | 202 | la operación solicitada sobre el contenido remoto no está permitida |
QNetworkReply::ContentNotFoundError | 203 | no se ha encontrado el contenido remoto en el servidor (similar al error HTTP 404) |
QNetworkReply::AuthenticationRequiredError | 204 | el servidor remoto requiere autenticación para servir el contenido, pero no se aceptaron las credenciales proporcionadas (si las hubiera) |
QNetworkReply::ContentReSendError | 205 | era necesario reenviar la solicitud, pero esto falló, por ejemplo, porque los datos de la carga no se pudieron leer por segunda vez. |
QNetworkReply::ContentConflictError | 206 | No se pudo completar la solicitud debido a un conflicto con el estado actual del recurso. |
QNetworkReply::ContentGoneError | 207 | El recurso solicitado ya no está disponible en el servidor. |
QNetworkReply::InternalServerError | 401 | El servidor se ha encontrado con una situación inesperada que le ha impedido atender la solicitud. |
QNetworkReply::OperationNotImplementedError | 402 | El servidor no admite la funcionalidad necesaria para atender la solicitud. |
QNetworkReply::ServiceUnavailableError | 403 | El servidor no puede gestionar la solicitud en este momento. |
QNetworkReply::ProtocolUnknownError | 301 | La API de acceso a la red no puede atender la solicitud porque se desconoce el protocolo. |
QNetworkReply::ProtocolInvalidOperationError | 302 | La operación solicitada no es válida para este protocolo. |
QNetworkReply::UnknownNetworkError | 99 | Se ha detectado un error desconocido relacionado con la red. |
QNetworkReply::UnknownProxyError | 199 | Se ha detectado un error desconocido relacionado con el proxy. |
QNetworkReply::UnknownContentError | 299 | Se ha detectado un error desconocido relacionado con el contenido remoto. |
QNetworkReply::ProtocolFailure | 399 | Se ha detectado un fallo en el protocolo (error de análisis, respuestas no válidas o inesperadas, etc.) |
QNetworkReply::UnknownServerError | 499 | Se ha detectado un error desconocido relacionado con la respuesta del servidor |
Véase también error() y errorOccurred().
QNetworkReply::RawHeaderPair
RawHeaderPair es un std::pair<QByteArray, QByteArray>, donde el primer QByteArray es el nombre del encabezado y el segundo es el encabezado.
Documentación de las funciones miembro
[explicit protected] QNetworkReply::QNetworkReply(QObject *parent = nullptr)
Crea un objeto `QNetworkReply` cuyo objeto padre es ` parent`.
No se pueden instanciar directamente objetos `QNetworkReply`. Para ello, utilice las funciones de ` QNetworkAccessManager `.
[virtual noexcept] QNetworkReply::~QNetworkReply()
Elimina esta respuesta y libera todos los recursos asociados a ella. Si aún hay conexiones de red abiertas, se cerrarán.
Véase también abort() y close().
[pure virtual slot] void QNetworkReply::abort()
Interrumpe la operación de inmediato y cierra cualquier conexión de red que siga abierta. Las subidas que aún estén en curso también se interrumpen.
También se emitirá la señal finished().
Véanse también « close()» y « finished()».
QVariant QNetworkReply::attribute(QNetworkRequest::Attribute code) const
Devuelve el atributo asociado al código code. Si el atributo no se ha establecido, devuelve un valor no válido QVariant (tipo QMetaType::UnknownType).
Se puede esperar que los valores por defecto que figuran en QNetworkRequest::Attribute se apliquen a los valores devueltos por esta función.
Véase también setAttribute() y QNetworkRequest::Attribute.
[override virtual] void QNetworkReply::close()
Reimplementa: QIODevice::close().
Cierra este dispositivo para lectura. Los datos no leídos se descartan, pero los recursos de red no se liberan hasta que se haya completado el proceso. En concreto, si hay alguna carga en curso, esta continuará hasta que finalice.
Se emite la señal finished() cuando todas las operaciones han finalizado y se han liberado los recursos de red.
Véase también abort() y finished().
[signal] void QNetworkReply::downloadProgress(qint64 bytesReceived, qint64 bytesTotal)
Esta señal se emite para indicar el progreso de la parte de descarga de esta solicitud de red, si la hubiera. Si no hay ninguna descarga asociada a esta solicitud, esta señal se emitirá una vez con el valor 0 tanto para « bytesReceived » como para « bytesTotal ».
El parámetro ` bytesReceived ` indica el número de bytes recibidos, mientras que ` bytesTotal ` indica el número total de bytes que se espera descargar. Si se desconoce el número de bytes que se van a descargar, ` bytesTotal ` será -1.
La descarga finaliza cuando bytesReceived es igual a bytesTotal. En ese momento, bytesTotal ya no será -1.
Tenga en cuenta que los valores tanto de bytesReceived como de bytesTotal pueden diferir de size(), del número total de bytes obtenidos mediante read() o readAll(), o del valor del encabezado (ContentLengthHeader). El motivo es que puede haber una sobrecarga del protocolo o que los datos se hayan comprimido durante la descarga.
Véase también uploadProgress() y bytesAvailable().
[signal] void QNetworkReply::encrypted()
Esta señal se emite cuando una sesión SSL/TLS ha completado con éxito el protocolo de establecimiento de conexión inicial. En este momento, aún no se han transmitido datos de usuario. La señal se puede utilizar 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. Si la respuesta no cumple los criterios esperados, se debe interrumpir llamando a ` QNetworkReply::abort()` desde un slot conectado a esta señal. La configuración SSL en uso se puede inspeccionar mediante el método ` QNetworkReply::sslConfiguration()`.
Internamente, ` QNetworkAccessManager ` puede abrir varias conexiones a un servidor, con el fin de 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 ` QNetworkAccessManager::encrypted()`.
QNetworkReply::NetworkError QNetworkReply::error() const
Devuelve el error que se ha detectado durante el procesamiento de esta solicitud. Si no se ha detectado ningún error, devuelve « NoError ».
Véase también setError().
[signal] void QNetworkReply::errorOccurred(QNetworkReply::NetworkError code)
Esta señal se emite cuando la respuesta detecta un error en el procesamiento. Probablemente le seguirá la señal ` finished()`, lo que indicará que la conexión ha finalizado.
El parámetro ` code ` contiene el código del error detectado. Llama a ` errorString()` para obtener una descripción textual de la condición de error.
Nota: No elimines el objeto en la ranura conectada a esta señal. Utiliza deleteLater().
Véase también error() y errorString().
[signal] void QNetworkReply::finished()
Esta señal se emite cuando ha finalizado el procesamiento de la respuesta. Una vez emitida esta señal, no habrá más actualizaciones en los datos ni en los metadatos de la respuesta.
A menos que se hayan llamado las funciones ` close()` o ` abort()`, la respuesta seguirá abierta para su lectura, por lo que los datos se podrán recuperar mediante llamadas a ` read()` o ` readAll()`. En concreto, si no se han realizado llamadas a ` read()` como resultado de ` readyRead()`, una llamada a ` readAll()` recuperará el contenido completo en un ` QByteArray`.
Esta señal se emite junto con QNetworkAccessManager::finished() cuando el parámetro de respuesta de dicha señal es este objeto.
Nota: No elimines el objeto en la ranura conectada a esta señal. Utiliza deleteLater().
También puedes utilizar ` isFinished()` para comprobar si una ` QNetworkReply ` ha finalizado incluso antes de recibir la señal `finished()`.
Véase también « setFinished()», « QNetworkAccessManager::finished()» y « isFinished()».
bool QNetworkReply::hasRawHeader(QAnyStringView headerName) const
Devuelve ` true ` si el servidor remoto ha enviado el encabezado sin procesar de nombre ` headerName `.
Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba QByteArray.
Véase también rawHeader().
QVariant QNetworkReply::header(QNetworkRequest::KnownHeaders header) const
Devuelve el valor del encabezado conocido « header », si dicho encabezado fue enviado por el servidor remoto. Si el encabezado no se envió, devuelve un valor no válido « QVariant ».
Véase también rawHeader(), setHeader() y QNetworkRequest::header().
[since 6.8] QHttpHeaders QNetworkReply::headers() const
Devuelve los encabezados que ha enviado el servidor remoto.
Esta función se introdujo en Qt 6.8.
Véase también setHeaders(), QNetworkRequest::setAttribute() y QNetworkRequest::Attribute.
[virtual slot] void QNetworkReply::ignoreSslErrors()
Si se invoca esta función, se ignorarán los errores SSL relacionados con la conexión de red, incluidos los errores de validación de certificados.
Advertencia: Asegúrate de permitir siempre que el usuario compruebe los errores notificados por la señal sslErrors(), y solo llama a este método tras recibir la confirmación del usuario de que puede continuar. Si se producen errores inesperados, la respuesta debe abortarse. Llamar a este método sin comprobar los errores reales supondrá, con toda probabilidad, un riesgo de seguridad para tu aplicación. ¡Úsalo con mucho cuidado!
Esta función se puede invocar desde el slot conectado a la señal sslErrors(), que indica qué errores se han detectado.
Nota: Si se ha habilitado HTTP Strict Transport Security para « QNetworkAccessManager », esta función no tiene ningún efecto.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// Connect using qOverload:
connect(sender, &SenderClass::signal,
networkReply, qOverload<>(&QNetworkReply::ignoreSslErrors));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
networkReply, [receiver = networkReply]() { receiver->ignoreSslErrors(); });Véase también sslConfiguration(), sslErrors() y QSslSocket::ignoreSslErrors().
void QNetworkReply::ignoreSslErrors(const QList<QSslError> &errors)
Si se invoca esta función, se ignorarán los errores SSL que se indican en errors.
Nota: Dado que la mayoría de los errores SSL están asociados a un certificado, para la mayoría de ellos debes especificar el certificado esperado al que se refiere dicho error SSL. Si, por ejemplo, deseas enviar una solicitud a un servidor que utiliza un certificado autofirmado, ten en cuenta el siguiente fragmento de código:
QList<QSslCertificate> cert = QSslCertificate::fromPath("server-certificate.pem"_L1);
QSslError error(QSslError::SelfSignedCertificate, cert.at(0));
QList<QSslError> expectedSslErrors;
expectedSslErrors.append(error);
QNetworkReply *reply = manager.get(QNetworkRequest(QUrl("https://server.tld/index.html")));
reply->ignoreSslErrors(expectedSslErrors);
// here connect signals etc.Las llamadas múltiples a esta función sustituirán la lista de errores que se haya pasado en llamadas anteriores. Puedes borrar la lista de errores que quieras ignorar llamando a esta función con una lista vacía.
Nota: Si HTTP Strict Transport Security está habilitado para QNetworkAccessManager, esta función no tiene ningún efecto.
Esta es una función sobrecargada.
Véase también sslConfiguration(), sslErrors(), QSslSocket::ignoreSslErrors() y QNetworkAccessManager::setStrictTransportSecurityEnabled().
[virtual protected] void QNetworkReply::ignoreSslErrorsImplementation(const QList<QSslError> &errors)
Este método virtual se proporciona para permitir anular el comportamiento de ` ignoreSslErrors()`. ` ignoreSslErrors()` es una envoltura pública de este método. ` errors ` contiene los errores que el usuario desea ignorar.
Véase también ignoreSslErrors().
bool QNetworkReply::isFinished() const
Devuelve « true » cuando la respuesta ha finalizado o se ha interrumpido.
Véase también isRunning().
bool QNetworkReply::isRunning() const
Devuelve « true » cuando la solicitud aún se está procesando y la respuesta aún no ha finalizado ni se ha cancelado.
Véase también isFinished().
[override virtual] bool QNetworkReply::isSequential() const
Reimplementa: ` QIODevice::isSequential()` const.
QNetworkAccessManager *QNetworkReply::manager() const
Devuelve el objeto ` QNetworkAccessManager ` que se utilizó para crear este objeto ` QNetworkReply `. Inicialmente, también es el objeto padre.
[signal] void QNetworkReply::metaDataChanged()
Esta señal se emite cada vez que cambian los metadatos de esta respuesta. Se entiende por metadatos cualquier información que no sea el contenido (datos) en sí mismo, incluidas las cabeceras de red. En la mayoría de los casos, los metadatos se conocerán por completo en el momento en que se reciba el primer byte de datos. Sin embargo, es posible recibir actualizaciones de las cabeceras u otros metadatos durante el procesamiento de los datos.
Véanse también header(), rawHeaderList(), rawHeader() y hasRawHeader().
QNetworkAccessManager::Operation QNetworkReply::operation() const
Devuelve la operación que se ha registrado para esta respuesta.
Véase también setOperation().
[signal] void QNetworkReply::preSharedKeyAuthenticationRequired(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.
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 un slot conectado a esta señal, rellenando el objeto ` authenticator ` pasado según sus necesidades.
Nota: Ignorar esta señal o no proporcionar las credenciales requeridas provocará que el protocolo de enlace falle y, por lo tanto, que se interrumpa la conexión.
Nota: El objeto ` authenticator ` es propiedad de la respuesta y la aplicación no debe eliminarlo.
Véase también QSslPreSharedKeyAuthenticator.
QByteArray QNetworkReply::rawHeader(QAnyStringView headerName) const
Devuelve el contenido sin procesar del encabezado headerName tal y como lo ha enviado el servidor remoto. Si no existe dicho encabezado, devuelve una matriz de bytes vacía, que puede resultar indistinguible de un encabezado vacío. Utiliza hasRawHeader() para comprobar si el servidor ha enviado dicho campo de encabezado.
Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba QByteArray.
Véase también setRawHeader(), hasRawHeader() y header().
QList<QByteArray> QNetworkReply::rawHeaderList() const
Devuelve una lista de los campos de encabezado que ha enviado el servidor remoto, en el orden en que se enviaron. Los encabezados duplicados se omiten.
const QList<QNetworkReply::RawHeaderPair> &QNetworkReply::rawHeaderPairs() const
Devuelve una lista de pares de encabezados sin procesar.
qint64 QNetworkReply::readBufferSize() const
Devuelve el tamaño del búfer de lectura, en bytes.
Véase también setReadBufferSize().
[signal] void QNetworkReply::redirectAllowed()
Cuando el código del cliente que gestiona la señal « redirected()» ha verificado la nueva URL, emite esta señal para permitir que se lleve a cabo la redirección. Este protocolo se aplica a las solicitudes de red cuya política de redirecciones esté configurada en QNetworkRequest::UserVerifiedRedirectPolicy
Véase también QNetworkRequest::UserVerifiedRedirectPolicy, QNetworkAccessManager::setRedirectPolicy() y QNetworkRequest::RedirectPolicyAttribute.
[signal] void QNetworkReply::redirected(const QUrl &url)
Esta señal se emite si no se ha establecido el parámetro « QNetworkRequest::ManualRedirectPolicy » en la solicitud y el servidor ha respondido con un código de estado 3xx (concretamente, los códigos de estado 301, 302, 303, 305, 307 o 308) con una URL válida en el encabezado «Location», lo que indica una redirección HTTP. El parámetro « url » contiene la nueva URL de redirección tal y como la devuelve el servidor en el encabezado «Location».
Véase también QNetworkRequest::RedirectPolicy.
QNetworkRequest QNetworkReply::request() const
Devuelve la solicitud que se envió para esta respuesta. En particular, ten en cuenta que la URL de la solicitud puede ser diferente a la de la respuesta.
Véase también QNetworkRequest::url(), url() y setRequest().
[signal, since 6.3] void QNetworkReply::requestSent()
Esta señal se emite una o más veces cuando se envía la solicitud. Resulta útil para gestionar de forma personalizada el progreso o los tiempos de espera.
Esta función se introdujo en Qt 6.3.
Véase también ` metaDataChanged()` y ` socketStartedConnecting()`.
[protected] void QNetworkReply::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)
Establece el atributo « code » con el valor « value ». Si se había establecido previamente « code », este valor se anulará. Si « value » es un « QVariant » no válido, el atributo se desactivará.
Véase también attribute() y QNetworkRequest::setAttribute().
[protected] void QNetworkReply::setError(QNetworkReply::NetworkError errorCode, const QString &errorString)
Establece la condición de error como « errorCode ». El mensaje legible para el usuario se establece con « errorString ».
La llamada a setError() no emite la señal errorOccurred(QNetworkReply::NetworkError).
Véase también error() y errorString().
[protected] void QNetworkReply::setFinished(bool finished)
Establece la respuesta como « finished ».
Una vez establecido esto, los datos de la respuesta no deben modificarse.
Véase también finished() y isFinished().
[protected] void QNetworkReply::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
Establece el valor de la cabecera conocida « header » en « value ». También se establecerá el formato sin procesar correspondiente de la cabecera.
Véase también header(), setRawHeader() y QNetworkRequest::setHeader().
[protected, since 6.8] void QNetworkReply::setHeaders(const QHttpHeaders &newHeaders)
Establece newHeaders como encabezados en esta respuesta de red, sustituyendo cualquier encabezado establecido anteriormente.
Si algunos encabezados coinciden con los encabezados conocidos, se analizarán y también se establecerá la forma analizada correspondiente.
Esta función se introdujo en Qt 6.8.
Véase también headers() y QNetworkRequest::KnownHeaders.
[protected, since 6.8] void QNetworkReply::setHeaders(QHttpHeaders &&newHeaders)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
[protected] void QNetworkReply::setOperation(QNetworkAccessManager::Operation operation)
Establece la operación asociada a este objeto como « operation ». Este valor será el que devuelva la función « operation()».
Nota: La operación debe establecerse al crear este objeto y no modificarse posteriormente.
Véase también operation() y setRequest().
[protected] void QNetworkReply::setRawHeader(const QByteArray &headerName, const QByteArray &value)
Establece el valor del encabezado sin procesar « headerName » en « value ». Si se había establecido previamente « headerName », este se anula. Varios encabezados HTTP con el mismo nombre son funcionalmente equivalentes a un único encabezado con los valores concatenados y separados por comas.
Si headerName coincide con un encabezado conocido, se analizará el valor value y también se establecerá la forma analizada correspondiente.
Véase también rawHeader(), header(), setHeader() y QNetworkRequest::setRawHeader().
[virtual] void QNetworkReply::setReadBufferSize(qint64 size)
Establece el tamaño del búfer de lectura en size bytes. El búfer de lectura es el búfer que almacena los datos que se están descargando de la red, antes de que se lean con QIODevice::read(). Si se establece el tamaño del búfer en 0, el tamaño del búfer será ilimitado.
QNetworkReply Intentará detener la lectura desde la red una vez que este búfer esté lleno (es decir, cuando bytesAvailable() devuelva size o más), lo que provocará que la descarga también se ralentice. Si el tamaño del búfer no está limitado, QNetworkReply intentará descargar desde la red lo más rápido posible.
A diferencia de ` QAbstractSocket::setReadBufferSize()`, ` QNetworkReply ` no puede garantizar la precisión en el tamaño del búfer de lectura. Es decir, ` bytesAvailable()` puede devolver más de ` size`.
Véase también readBufferSize().
[protected] void QNetworkReply::setRequest(const QNetworkRequest &request)
Establece la solicitud asociada a este objeto como request. Este valor será el devuelto por la función request().
Nota: La solicitud debe establecerse al crear este objeto y no debe modificarse posteriormente.
Véase también request() y setOperation().
void QNetworkReply::setSslConfiguration(const QSslConfiguration &config)
Establece la configuración SSL de la conexión de red asociada a esta solicitud, si es posible, para que sea la de config.
Véase también sslConfiguration().
[virtual protected] void QNetworkReply::setSslConfigurationImplementation(const QSslConfiguration &configuration)
Este método virtual se proporciona para permitir la sobrescritura del comportamiento de setSslConfiguration(). setSslConfiguration() es un envoltorio público para este método. Si sobrescribes este método, utiliza configuration para establecer la configuración SSL.
Véanse también sslConfigurationImplementation() y setSslConfiguration().
[protected] void QNetworkReply::setUrl(const QUrl &url)
Establece la URL que se está procesando como url. Normalmente, la URL coincide con la de la solicitud enviada, pero por diversas razones puede ser diferente (por ejemplo, si la ruta de un archivo se convierte en absoluta o canónica).
Véase también url(), request() y QNetworkRequest::url().
[protected, since 6.8] void QNetworkReply::setWellKnownHeader(QHttpHeaders::WellKnownHeader name, QByteArrayView value)
Establece el valor de la cabecera « name » en « value ». Si se había establecido previamente « name », se anula.
Esta función se introdujo en Qt 6.8.
[signal, since 6.3] void QNetworkReply::socketStartedConnecting()
Esta señal se emite 0 o más veces, mientras el socket se está conectando, antes de enviar la solicitud. Resulta útil para gestionar de forma personalizada el progreso o los tiempos de espera.
Esta función se introdujo en Qt 6.3.
Véase también metaDataChanged() y requestSent().
QSslConfiguration QNetworkReply::sslConfiguration() const
Devuelve la configuración y el estado de SSL asociados a esta respuesta, en caso de que se haya utilizado SSL. Contendrá el certificado del servidor remoto, su cadena de certificados que conduce a la autoridad de certificación, así como los algoritmos de cifrado utilizados.
El certificado del interlocutor y su cadena de certificados se conocerán en el momento en que se emita sslErrors(), si es que se emite.
Véase también setSslConfiguration().
[virtual protected] void QNetworkReply::sslConfigurationImplementation(QSslConfiguration &configuration) const
Este método virtual se proporciona para permitir la sobrescritura del comportamiento de ` sslConfiguration()`. ` sslConfiguration()` es un envoltorio público de este método. La configuración se devolverá en ` configuration`.
Véase también ` setSslConfigurationImplementation()` y ` sslConfiguration()`.
[signal] void QNetworkReply::sslErrors(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.
Para indicar que los errores no son graves y que la conexión debe continuar, se debe llamar a la función 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 que indique que la seguridad podría verse comprometida y para mostrar la configuración de 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(), QNetworkAccessManager::sslErrors(), sslConfiguration() y ignoreSslErrors().
[signal] void QNetworkReply::uploadProgress(qint64 bytesSent, qint64 bytesTotal)
Esta señal se emite para indicar el progreso de la parte de subida de esta solicitud de red, si la hay. Si no hay ninguna subida asociada a esta solicitud, no se emitirá esta señal.
El parámetro ` bytesSent ` indica el número de bytes subidos, mientras que ` bytesTotal ` indica el número total de bytes que se van a subir. Si no se ha podido determinar el número de bytes que se van a subir, ` bytesTotal ` será -1.
La subida finaliza cuando bytesSent es igual a bytesTotal. En ese momento, bytesTotal dejará de ser -1.
Véase también downloadProgress().
QUrl QNetworkReply::url() const
Devuelve la URL del contenido descargado o cargado. Ten en cuenta que la URL puede ser diferente de la de la solicitud original. Si se habilitaron las redirecciones en la solicitud, esta función devuelve la URL actual a la que está accediendo la API de red, es decir, la URL del recurso al que se redirigió la solicitud.
Véase también request(), setUrl(), QNetworkRequest::url() y redirected().
[override virtual protected] qint64 QNetworkReply::writeData(const char *data, qint64 len)
Reimplementa: QIODevice::writeData(const char *data, qint64 maxSize).
© 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.