QNetworkRequest Class
La clase `QNetworkRequest` contiene una solicitud que se enviará con ` QNetworkAccessManager`. Más información...
| Cabecera: | #include <QNetworkRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
- Lista de todos los miembros, incluidos los heredados
- QNetworkRequest forma parte de la API de programación de red y de las clases compartidas implícitamente.
Tipos públicos
| enum | Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, CacheLoadControlAttribute, …, UserMax } |
| enum | CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache } |
| enum | KnownHeaders { ContentDispositionHeader, ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, …, ServerHeader } |
| enum | LoadControl { Automatic, Manual } |
| enum | Priority { HighPriority, NormalPriority, LowPriority } |
| enum | RedirectPolicy { ManualRedirectPolicy, NoLessSafeRedirectPolicy, SameOriginRedirectPolicy, UserVerifiedRedirectPolicy } |
| enum | TransferTimeoutConstant { DefaultTransferTimeoutConstant } |
Funciones públicas
| QNetworkRequest() | |
| QNetworkRequest(const QUrl &url) | |
| QNetworkRequest(const QNetworkRequest &other) | |
| ~QNetworkRequest() | |
| QVariant | attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const |
(since 6.2) qint64 | decompressedSafetyCheckThreshold() const |
| bool | hasRawHeader(QAnyStringView headerName) const |
| QVariant | header(QNetworkRequest::KnownHeaders header) const |
(since 6.8) QHttpHeaders | headers() const |
(since 6.5) QHttp1Configuration | http1Configuration() const |
| QHttp2Configuration | http2Configuration() const |
| int | maximumRedirectsAllowed() const |
| QObject * | originatingObject() const |
| QString | peerVerifyName() const |
| QNetworkRequest::Priority | priority() const |
| QByteArray | rawHeader(QAnyStringView headerName) const |
| QList<QByteArray> | rawHeaderList() const |
| void | setAttribute(QNetworkRequest::Attribute code, const QVariant &value) |
(since 6.2) void | setDecompressedSafetyCheckThreshold(qint64 threshold) |
| void | setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value) |
(since 6.8) void | setHeaders(QHttpHeaders &&newHeaders) |
(since 6.8) void | setHeaders(const QHttpHeaders &newHeaders) |
(since 6.5) void | setHttp1Configuration(const QHttp1Configuration &configuration) |
| void | setHttp2Configuration(const QHttp2Configuration &configuration) |
| void | setMaximumRedirectsAllowed(int maxRedirectsAllowed) |
| void | setOriginatingObject(QObject *object) |
| void | setPeerVerifyName(const QString &peerName) |
| void | setPriority(QNetworkRequest::Priority priority) |
| void | setRawHeader(const QByteArray &headerName, const QByteArray &headerValue) |
| void | setSslConfiguration(const QSslConfiguration &config) |
(since 6.11) void | setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle) |
(since 6.11) void | setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval) |
(since 6.11) void | setTcpKeepAliveProbeCount(int probes) |
| void | setTransferTimeout(int timeout) |
(since 6.7) void | setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout) |
| void | setUrl(const QUrl &url) |
| QSslConfiguration | sslConfiguration() const |
| void | swap(QNetworkRequest &other) |
(since 6.11) std::chrono::seconds | tcpKeepAliveIdleTimeBeforeProbes() const |
(since 6.11) std::chrono::seconds | tcpKeepAliveIntervalBetweenProbes() const |
(since 6.11) int | tcpKeepAliveProbeCount() const |
| int | transferTimeout() const |
(since 6.7) std::chrono::milliseconds | transferTimeoutAsDuration() const |
| QUrl | url() const |
| bool | operator!=(const QNetworkRequest &other) const |
| QNetworkRequest & | operator=(const QNetworkRequest &other) |
| bool | operator==(const QNetworkRequest &other) const |
Miembros públicos estáticos
| const std::chrono::std::chrono::milliseconds | DefaultTransferTimeout |
Descripción detallada
QNetworkRequest forma parte de la API de acceso a la red y es la clase que contiene la información necesaria para enviar una solicitud a través de la red. Contiene una URL y cierta información complementaria que puede utilizarse para modificar la solicitud.
Véase también QNetworkReply y QNetworkAccessManager.
Documentación sobre los tipos de miembros
enum QNetworkRequest::Attribute
Códigos de atributos para QNetworkRequest y QNetworkReply.
Los atributos son metadatos adicionales que se utilizan para controlar el comportamiento de la solicitud y para devolver información adicional de la respuesta a la aplicación. Los atributos también son extensibles, lo que permite que las implementaciones personalizadas pasen valores personalizados.
La siguiente tabla explica cuáles son los códigos de atributos por defecto, los tipos de QVariant asociados, el valor por defecto si falta dicho atributo y si se utiliza en solicitudes o en respuestas.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::HttpStatusCodeAttribute | 0 | Solo en respuestas, tipo: QMetaType::Int (sin valor predeterminado) Indica el código de estado HTTP recibido del servidor HTTP (como 200, 304, 404, 401, etc.). Si la conexión no se basaba en HTTP, este atributo no estará presente. |
QNetworkRequest::HttpReasonPhraseAttribute | 1 | Solo en respuestas, tipo: QMetaType::QByteArray (sin valor por defecto) Indica la frase de motivo HTTP tal y como se recibió del servidor HTTP (como «Ok», «Found», «Not Found», «Access Denied», etc.). Se trata de la representación legible para el usuario del código de estado (véase más arriba). Si la conexión no se basaba en HTTP, este atributo no estará presente. Nota: La frase de motivo no se utiliza cuando se emplea HTTP/2. |
QNetworkRequest::RedirectionTargetAttribute | 2 | Solo en respuestas, tipo: QMetaType::QUrl (sin valor por defecto). Si está presente, indica que el servidor está redirigiendo la solicitud a una URL diferente. La API de acceso a la red sigue las redirecciones de forma predeterminada, a menos que se utilice QNetworkRequest::ManualRedirectPolicy. Además, si se utiliza QNetworkRequest::UserVerifiedRedirectPolicy, este atributo se establecerá si no se ha seguido la redirección. La URL devuelta puede ser relativa. Utiliza QUrl::resolved() para crear una URL absoluta a partir de ella. |
QNetworkRequest::ConnectionEncryptedAttribute | 3 | Solo para respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si los datos se obtuvieron a través de una conexión cifrada (segura). |
QNetworkRequest::CacheLoadControlAttribute | 4 | Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::PreferNetwork). Controla cómo se debe acceder a la caché. Los valores posibles son los de QNetworkRequest::CacheLoadControl. Ten en cuenta que la implementación predeterminada de QNetworkAccessManager no admite el almacenamiento en caché. Sin embargo, este atributo puede ser utilizado por ciertos backends para modificar sus solicitudes (por ejemplo, para proxies de caché). |
QNetworkRequest::CacheSaveControlAttribute | 5 | Solo solicitudes, tipo: QMetaType::Bool (por defecto: true) Controla si los datos obtenidos deben guardarse en la caché para usos futuros. Si el valor es false, los datos obtenidos no se almacenarán automáticamente en la caché. Si es true, los datos pueden almacenarse en la caché, siempre que sean almacenables (lo que es almacenable depende del protocolo que se utilice). |
QNetworkRequest::SourceIsFromCacheAttribute | 6 | Solo respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si los datos se han obtenido de la caché o no. |
QNetworkRequest::DoNotBufferUploadDataAttribute | 7 | Solo solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si se permite que el código QNetworkAccessManager almacene en búfer los datos de carga, p. ej., al realizar un HTTP POST. Al utilizar este indicador con datos de carga secuenciales, debe establecerse el encabezado ContentLengthHeader. |
QNetworkRequest::HttpPipeliningAllowedAttribute | 8 | Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si se permite que el código QNetworkAccessManager utilice el pipelining HTTP con esta solicitud. |
QNetworkRequest::HttpPipeliningWasUsedAttribute | 9 | Solo respuestas, tipo: QMetaType::Bool Indica si se utilizó el pipelining HTTP para recibir esta respuesta. |
QNetworkRequest::CustomVerbAttribute | 10 | Solo para solicitudes, tipo: QMetaType::QByteArray Contiene el valor del verbo HTTP personalizado que se va a enviar (destinado al uso de verbos distintos de GET, POST, PUT y DELETE). Este verbo se establece al llamar a QNetworkAccessManager::sendCustomRequest(). |
QNetworkRequest::CookieLoadControlAttribute | 11 | Solo en solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic) Indica si se deben enviar encabezados «Cookie» en la solicitud. Qt WebKit establece este atributo en «false» al crear una solicitud XMLHttpRequest de origen cruzado cuando el código JavaScript que ha creado la solicitud no ha establecido explícitamente «withCredentials» en «true». Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.) |
QNetworkRequest::CookieSaveControlAttribute | 13 | Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic) Indica si se deben guardar los encabezados «Cookie» recibidos del servidor en respuesta a la solicitud. Qt WebKit establece este atributo en «false» al crear una solicitud XMLHttpRequest de origen cruzado en la que el código JavaScript que ha creado la solicitud no haya establecido explícitamente «withCredentials» en «true». Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.) |
QNetworkRequest::AuthenticationReuseAttribute | 12 | Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic). Indica si se deben utilizar las credenciales de autorización almacenadas en caché en la solicitud, si están disponibles. Si se establece en QNetworkRequest::Manual y el mecanismo de autenticación es «Basic» o «Digest», Qt no enviará un encabezado HTTP «Authorization» con las credenciales almacenadas en caché que pueda tener para la URL de la solicitud. Qt WebKit establece este atributo en QNetworkRequest::Manual al crear una solicitud XMLHttpRequest de origen cruzado cuando el código JavaScript que ha creado la solicitud no ha establecido explícitamente withCredentials en true. Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.) |
QNetworkRequest::BackgroundRequestAttribute | 17 | Tipo: QMetaType::Bool (por defecto: false) Indica que se trata de una transferencia en segundo plano, en lugar de una transferencia iniciada por el usuario. Dependiendo de la plataforma, las transferencias en segundo plano pueden estar sujetas a políticas diferentes. |
QNetworkRequest::Http2AllowedAttribute | 19 | Solo solicitudes, tipo: QMetaType::Bool (por defecto: true) Indica si se permite que el código QNetworkAccessManager utilice HTTP/2 con esta solicitud. Esto se aplica a las solicitudes SSL o a HTTP/2 en «texto sin cifrar» si se ha establecido Http2CleartextAllowedAttribute. |
QNetworkRequest::Http2WasUsedAttribute | 20 | Solo respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si se utilizó HTTP/2 para recibir esta respuesta. (Este valor se introdujo en la versión 5.9.) |
QNetworkRequest::EmitAllUploadProgressSignalsAttribute | 18 | Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si deben emitirse todas las señales de carga. Por defecto, la señal uploadProgress solo se emite en intervalos de 100 milisegundos. (Este valor se introdujo en la versión 5.5.) |
QNetworkRequest::OriginalContentLengthAttribute | 21 | Solo respuestas, tipo: QMetaType::Int Conserva el atributo «content-length» original antes de que quede invalidado y se elimine del encabezado cuando los datos se comprimen y la solicitud se ha marcado para que se descomprima automáticamente. (Este valor se introdujo en la versión 5.9.) |
QNetworkRequest::RedirectPolicyAttribute | 22 | Solo para solicitudes, tipo: QMetaType::Int; debe ser uno de los valores de QNetworkRequest::RedirectPolicy (por defecto: NoLessSafeRedirectPolicy). (Este valor se introdujo en la versión 5.9.) |
QNetworkRequest::Http2DirectAttribute | 23 | Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false). Si se establece, este atributo obligará a QNetworkAccessManager a utilizar el protocolo HTTP/2 sin negociación inicial del protocolo HTTP/2. El uso de este atributo implica el conocimiento previo de que un servidor concreto es compatible con HTTP/2. El atributo funciona con SSL o con HTTP/2 en «texto sin cifrar» si se establece Http2CleartextAllowedAttribute. Si resulta que un servidor no es compatible con HTTP/2, cuando se ha especificado HTTP/2 directo, QNetworkAccessManager abandona la conexión sin intentar recurrir a HTTP/1.1. Si se establecen tanto Http2AllowedAttribute como Http2DirectAttribute, Http2DirectAttribute tiene prioridad. (Este valor se introdujo en la versión 5.11.) |
QNetworkRequest::AutoDeleteReplyOnFinishAttribute | 25 | Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Si se activa, este atributo hará que QNetworkAccessManager elimine el QNetworkReply tras haber emitido «finished». (Este valor se introdujo en la versión 5.14.) |
QNetworkRequest::ConnectionCacheExpiryTimeoutSecondsAttribute | 26 | Solo para solicitudes, tipo: QMetaType::Int Controla cuándo deben cerrarse las conexiones TCP con un servidor (HTTP1 y HTTP2) una vez procesada la última solicitud pendiente. Si no se configura, se utiliza el tiempo de espera predeterminado de 120 segundos. Si se establece en un valor negativo (por ejemplo, -1), se desactiva el almacenamiento en caché de la conexión para esta solicitud: la conexión no se almacenará ni se recuperará de la caché, y se cerrará inmediatamente después de que finalice la solicitud. Establecerlo en 0 significa que la conexión se comparte mientras está en uso, pero se libera tan pronto como no haya nada en la cola. Un valor positivo especifica un tiempo de caducación personalizado en segundos. (Este valor se introdujo en la versión 6.3.) |
QNetworkRequest::Http2CleartextAllowedAttribute | 27 | Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Si se establece, este atributo indicará a QNetworkAccessManager que intente una actualización a HTTP/2 sobre texto sin cifrar (también conocido como h2c). Hasta Qt 7, el valor por defecto de este atributo se puede anular y establecer en «true» configurando la variable de entorno QT_NETWORK_H2C_ALLOWED. Este atributo se ignora si no se ha establecido Http2AllowedAttribute. (Este valor se introdujo en la versión 6.3.) |
QNetworkRequest::UseCredentialsAttribute | 28 | Solo para peticiones, tipo: QMetaType::Bool (por defecto: false) Indica si las peticiones de control de acceso entre sitios de XMLHttpRequest subyacentes deben realizarse utilizando credenciales. No tiene ningún efecto en las peticiones del mismo origen. Esto solo afecta a la plataforma WebAssembly. (Este valor se introdujo en la versión 6.5.) |
QNetworkRequest::FullLocalServerNameAttribute | 29 | Solo para solicitudes, tipo: QMetaType::String Contiene el nombre completo del servidor local que se utilizará para el QLocalSocket subyacente. Este atributo lo utiliza el QNetworkAccessManager para conectarse a un servidor local específico, cuando el comportamiento de QLocalSocket para un nombre simple no es suficiente. La URL en QNetworkRequest debe seguir utilizando el esquema unix+http: o local+http:. Además, el nombre de host de la URL se utilizará para el encabezado Host en la solicitud HTTP. (Este valor se introdujo en la versión 6.8.) |
QNetworkRequest::User | 1000 | Tipo especial. Se puede pasar información adicional en QVariants con tipos que van desde «User» hasta «UserMax». La implementación predeterminada de «Network Access» ignorará cualquier atributo de solicitud dentro de este rango y no generará ningún atributo de este rango en las respuestas. El rango está reservado para extensiones de QNetworkAccessManager. |
QNetworkRequest::UserMax | 32767 | Tipo especial. Véase «User». |
enum QNetworkRequest::CacheLoadControl
Controla el mecanismo de almacenamiento en caché de QNetworkAccessManager.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::AlwaysNetwork | 0 | cargar siempre desde la red y no comprobar si la caché tiene una entrada válida (similar a la función «Actualizar» de los navegadores); además, obliga a las cachés intermedias a volver a validar. |
QNetworkRequest::PreferNetwork | 1 | valor por defecto; se carga desde la red si la entrada almacenada en caché es más antigua que la entrada de la red. Esto nunca devolverá datos obsoletos de la caché, pero revalidará los recursos que se hayan vuelto obsoletos. |
QNetworkRequest::PreferCache | 2 | Cargar desde la caché si está disponible; de lo contrario, cargar desde la red. Ten en cuenta que esto puede devolver elementos posiblemente obsoletos (pero no caducados) de la caché. |
QNetworkRequest::AlwaysCache | 3 | Solo cargar desde la caché, indicando un error si el elemento no estaba almacenado en la caché (es decir, modo sin conexión). |
enum QNetworkRequest::KnownHeaders
Lista de tipos de encabezado conocidos que analiza QNetworkRequest. Cada encabezado conocido también se muestra en formato sin procesar con su nombre HTTP completo.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::ContentDispositionHeader | 6 | Corresponde al encabezado HTTP «Content-Disposition» y contiene una cadena con el tipo de disposición (por ejemplo, «attachment») y un parámetro (por ejemplo, «filename»). |
QNetworkRequest::ContentTypeHeader | 0 | Corresponde al encabezado HTTP «Content-Type» y contiene una cadena con el tipo de medio (MIME) y cualquier dato auxiliar (por ejemplo, el juego de caracteres). |
QNetworkRequest::ContentLengthHeader | 1 | Corresponde al encabezado HTTP «Content-Length» y contiene la longitud en bytes de los datos transmitidos. |
QNetworkRequest::LocationHeader | 2 | Corresponde al encabezado HTTP «Location» y contiene una URL que representa la ubicación real de los datos, incluida la URL de destino en caso de redireccionamientos. |
QNetworkRequest::LastModifiedHeader | 3 | Corresponde al encabezado HTTP «Last-Modified» y contiene un « QDateTime » que representa la fecha de la última modificación del contenido. |
QNetworkRequest::IfModifiedSinceHeader | 9 | Corresponde al encabezado HTTP «If-Modified-Since» y contiene un « QDateTime ». Suele añadirse a un « QNetworkRequest ». El servidor enviará una respuesta 304 (Not Modified) si el recurso no ha cambiado desde ese momento. |
QNetworkRequest::ETagHeader | 10 | Corresponde al encabezado HTTP «ETag» y contiene un « QString » que representa el estado de la última modificación del contenido. |
QNetworkRequest::IfMatchHeader | 11 | Corresponde al encabezado HTTP If-Match y contiene un QStringList. Suele añadirse a un QNetworkRequest. El servidor enviará una respuesta 412 (Precondition Failed) si el recurso no coincide. |
QNetworkRequest::IfNoneMatchHeader | 12 | Corresponde al encabezado HTTP «If-None-Match» y contiene un QStringList. Suele añadirse a un QNetworkRequest. El servidor enviará una respuesta 304 (Not Modified) si el recurso coincide. |
QNetworkRequest::CookieHeader | 4 | Corresponde al encabezado HTTP «Cookie» y contiene un QList<QNetworkCookie> que representa las cookies que se deben enviar de vuelta al servidor. |
QNetworkRequest::SetCookieHeader | 5 | Corresponde al encabezado HTTP «Set-Cookie» y contiene un QList<QNetworkCookie> que representa las cookies enviadas por el servidor para su almacenamiento local. |
QNetworkRequest::UserAgentHeader | 7 | El encabezado User-Agent enviado por los clientes HTTP. |
QNetworkRequest::ServerHeader | 8 | El encabezado «Server» recibido por los clientes HTTP. |
Véase también header(), setHeader(), rawHeader() y setRawHeader().
enum QNetworkRequest::LoadControl
Indica si se ha anulado manualmente algún aspecto del mecanismo de carga de la solicitud, por ejemplo, mediante Qt WebKit.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::Automatic | 0 | valor por defecto: indica el comportamiento predeterminado. |
QNetworkRequest::Manual | 1 | indica que el comportamiento se ha anulado manualmente. |
enum QNetworkRequest::Priority
Esta enumeración enumera las posibles prioridades de las solicitudes de red.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::HighPriority | 1 | Prioridad alta |
QNetworkRequest::NormalPriority | 3 | Prioridad normal |
QNetworkRequest::LowPriority | 5 | Prioridad baja |
enum QNetworkRequest::RedirectPolicy
Indica si la API de acceso a la red debe seguir automáticamente una respuesta de redireccionamiento HTTP o no.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::ManualRedirectPolicy | 0 | No seguir ninguna redirección. |
QNetworkRequest::NoLessSafeRedirectPolicy | 1 | Valor por defecto: solo se permiten redireccionamientos de «http» a «http», de «http» a «https» o de «https» a «https». |
QNetworkRequest::SameOriginRedirectPolicy | 2 | Se requiere que el protocolo, el host y el puerto sean los mismos. Ten en cuenta que http://example.com y http://example.com:80 fallarán con esta política (los puertos implícitos/explícitos se consideran una discrepancia). |
QNetworkRequest::UserVerifiedRedirectPolicy | 3 | El cliente decide si seguir cada redirección gestionando la señal `redirected()`, emitiendo `redirectAllowed()` en el objeto ` QNetworkReply ` para permitir la redirección o abortándola/finalizándola para rechazarla. Esto se puede utilizar, por ejemplo, para preguntar al usuario si acepta la redirección o para decidir en función de alguna configuración específica de la aplicación. Nota: Cuando Qt gestiona redirecciones, por motivos de compatibilidad y con vistas al futuro, enviará la solicitud redirigida utilizando el método GET cuando el servidor devuelva una respuesta 301 o 302, independientemente del método original utilizado, a menos que fuera HEAD. |
enum QNetworkRequest::TransferTimeoutConstant
Una constante que se puede utilizar para activar los tiempos de espera de transferencia con un valor preestablecido.
| Constante | Valor | Descripción |
|---|---|---|
QNetworkRequest::DefaultTransferTimeoutConstant | 30000 | El tiempo de espera de la transferencia en milisegundos. Se utiliza si se llama a setTransferTimeout() sin ningún argumento. |
Véase también QNetworkRequest::DefaultTransferTimeout.
Documentación de funciones de miembro
QNetworkRequest::QNetworkRequest()
Crea un objeto `QNetworkRequest` sin ninguna URL que solicitar. Utiliza ` setUrl()` para establecer una.
Véase también url() y setUrl().
[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)
Crea un objeto QNetworkRequest con url como URL a solicitar.
Véase también url() y setUrl().
QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)
Crea una copia de other.
[noexcept] QNetworkRequest::~QNetworkRequest()
Elimina el objeto ` QNetworkRequest `.
QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const
Devuelve el atributo asociado al código code. Si el atributo no se ha establecido, devuelve defaultValue.
Nota: Esta función no aplica los valores por defecto que figuran en QNetworkRequest::Attribute.
Véase también setAttribute() y QNetworkRequest::Attribute.
[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const
Devuelve el umbral para las comprobaciones de «archive bomb».
Si el tamaño descomprimido de una respuesta es inferior a este valor, Qt simplemente la descomprimirá, sin realizar comprobaciones adicionales.
Esta función se introdujo en Qt 6.2.
Véase también setDecompressedSafetyCheckThreshold().
bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const
Devuelve ` true ` si el encabezado sin procesar ` headerName ` está presente en esta solicitud de red.
Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba QByteArray.
Véase también rawHeader() y setRawHeader().
QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const
Devuelve el valor del encabezado de red conocido « header » si está presente en esta solicitud. Si no está presente, devuelve QVariant() (es decir, una variante no válida).
Véase también KnownHeaders, rawHeader() y setHeader().
[since 6.8] QHttpHeaders QNetworkRequest::headers() const
Devuelve los encabezados que se han establecido en esta solicitud de red.
Esta función se introdujo en Qt 6.8.
Véase también ` setHeaders()`.
[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const
Devuelve los parámetros actuales que utiliza QNetworkAccessManager para la conexión HTTP/1 subyacente de esta solicitud.
Esta función se introdujo en Qt 6.5.
Véase también setHttp1Configuration.
QHttp2Configuration QNetworkRequest::http2Configuration() const
Devuelve los parámetros actuales que QNetworkAccessManager está utilizando para esta solicitud y su conexión HTTP/2 subyacente. Se trata bien de una configuración establecida previamente por una aplicación, bien de una configuración predeterminada.
Los valores predeterminados que utiliza QNetworkAccessManager son:
- El tamaño de ventana para el control de flujo a nivel de conexión es de 2147483647 octetos
- El tamaño de ventana para el control de flujo a nivel de flujo es de 214748364 octetos
- El tamaño máximo de trama es de 16 384
Por defecto, el «server push» está desactivado, mientras que la compresión Huffman y la indexación de cadenas están activadas.
Véase también setHttp2Configuration.
int QNetworkRequest::maximumRedirectsAllowed() const
Devuelve el número máximo de redirecciones que se pueden seguir para esta solicitud.
Véase también setMaximumRedirectsAllowed().
QObject *QNetworkRequest::originatingObject() const
Devuelve una referencia al objeto que inició esta solicitud de red; devuelve « nullptr » si no se ha establecido o si el objeto se ha destruido.
Véase también setOriginatingObject().
QString QNetworkRequest::peerVerifyName() const
Devuelve el nombre de host establecido para la validación del certificado, tal y como se ha configurado en setPeerVerifyName. Por defecto, devuelve una cadena nula.
Véase también setPeerVerifyName.
QNetworkRequest::Priority QNetworkRequest::priority() const
Devuelve la prioridad de esta solicitud.
Véase también setPriority().
QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const
Devuelve la forma sin procesar del encabezado headerName. Si no existe dicho encabezado, se devuelve un QByteArray vacío, lo que puede resultar indistinguible de un encabezado que sí existe pero que no tiene contenido (utiliza hasRawHeader() para comprobar si el encabezado existe o no).
Los encabezados sin procesar se pueden establecer con setRawHeader() o con setHeader().
Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba ` QByteArray `.
Véase también header() y setRawHeader().
QList<QByteArray> QNetworkRequest::rawHeaderList() const
Devuelve una lista de todos los encabezados sin procesar que se han establecido en esta solicitud de red. La lista aparece en el orden en que se establecieron los encabezados.
Véase también hasRawHeader() y rawHeader().
void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)
Establece el atributo asociado al código code con el valor value. Si el atributo ya está establecido, se descarta el valor anterior. En particular, si value es un QVariant no válido, se desactiva el atributo.
Véase también attribute() y QNetworkRequest::Attribute.
[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)
Establece el valor de « threshold » para las comprobaciones de archivos de gran tamaño.
Algunos algoritmos de compresión compatibles pueden, en un archivo comprimido minúsculo, codificar un archivo descomprimido de un tamaño espectacularmente grande. Esto solo es posible si el contenido descomprimido es extremadamente monótono, lo cual rara vez ocurre con archivos reales que se transmiten de buena fe: los archivos que presentan ratios de compresión tan desmesuradamente altos suelen ser cargas útiles de ataques de desbordamiento de búfer o de denegación de servicio (al consumir demasiada memoria). Por consiguiente, es mejor rechazar como malware sospechoso los archivos que, al descomprimirse, alcanzan tamaños enormes, especialmente si proceden de formatos comprimidos minúsculos.
Si el tamaño descomprimido de una respuesta supera este umbral (por defecto, 10 MiB, es decir, 10 * 1024 * 1024), Qt comprobará la relación de compresión: si es desproporcionadamente alta (40:1 para GZip y Deflate, o 100:1 para Brotli y ZStandard), la respuesta se tratará como un error. Establecer el umbral en -1 desactiva esta comprobación.
Nota: Esta comprobación solo detecta respuestas con relaciones de compresión inusualmente altas. No impone un límite absoluto al tamaño total de la salida descomprimida. Una respuesta que mantenga una relación de compresión moderada (por ejemplo, 39:1 para GZip) puede descomprimirse hasta alcanzar un tamaño arbitrariamente grande sin activar la comprobación. Las aplicaciones que se comuniquen con servidores no fiables deben supervisar QNetworkReply::bytesAvailable() o QNetworkReply::downloadProgress() e interrumpir las transferencias que superen un tamaño aceptable.
Esta función se introdujo en Qt 6.2.
Véase también decompressedSafetyCheckThreshold().
void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
Establece el valor del encabezado conocido « header » en « value », anulando cualquier encabezado establecido anteriormente. Esta operación también establece el encabezado HTTP sin procesar equivalente.
Véase también KnownHeaders, setRawHeader() y header().
[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)
Establece « newHeaders » como encabezados en esta solicitud de red, sustituyendo cualquier encabezado establecido anteriormente.
Si algunos encabezados coinciden con los encabezados conocidos, se analizarán los valores y también se establecerá el formulario analizado correspondiente.
Esta función se introdujo en Qt 6.8.
Véase también headers() y KnownHeaders.
[since 6.8] void QNetworkRequest::setHeaders(const QHttpHeaders &newHeaders)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
[since 6.5] void QNetworkRequest::setHttp1Configuration(const QHttp1Configuration &configuration)
Establece los parámetros HTTP/1 de la solicitud a partir de configuration.
Esta función se introdujo en Qt 6.5.
Véase también http1Configuration, QNetworkAccessManager y QHttp1Configuration.
void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)
Establece los parámetros HTTP/2 de la solicitud a partir de configuration.
Nota: La configuración debe establecerse antes de realizar una solicitud.
Nota: HTTP/2 multiplexa varios flujos en una única conexión HTTP/2. Esto implica que QNetworkAccessManager utilizará la configuración que se encuentre en la primera solicitud de una serie de solicitudes enviadas al mismo servidor.
Véase también http2Configuration, QNetworkAccessManager y QHttp2Configuration.
void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)
Establece el número máximo de redireccionamientos que se pueden seguir para esta solicitud a maxRedirectsAllowed.
Véase también maximumRedirectsAllowed().
void QNetworkRequest::setOriginatingObject(QObject *object)
Permite establecer una referencia al objeto « object » que inicia la solicitud.
Por ejemplo, Qt WebKit establece el objeto de origen como el QWebFrame que inició la solicitud.
Véase también originatingObject().
void QNetworkRequest::setPeerVerifyName(const QString &peerName)
Establece peerName como nombre de host para la validación del certificado, en lugar del que se utiliza para la conexión TCP.
Véase también peerVerifyName.
void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)
Establece la prioridad de esta solicitud en « priority ».
Nota: La prioridad « priority » es solo una sugerencia para el gestor de acceso a la red. Este puede utilizarla o no. Actualmente se utiliza para HTTP a la hora de decidir qué solicitud debe enviarse primero a un servidor.
Véase también priority().
void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)
Establece el valor de la cabecera « headerName » en « headerValue ». Si « headerName » corresponde a una cabecera conocida (véase QNetworkRequest::KnownHeaders), se analizará el formato sin procesar y se establecerá también la cabecera «procesada» correspondiente.
Por ejemplo:
request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));también establecerá el encabezado conocido LastModifiedHeader como el objeto QDateTime de la fecha analizada.
Nota: Establecer el mismo encabezado dos veces anula la configuración anterior. Para conseguir el comportamiento de varios encabezados HTTP con el mismo nombre, debes concatenar los dos valores, separándolos con una coma («,») y establecer un único encabezado sin procesar.
Nota: Desde Qt 6.8, los nombres de los campos de los encabezados se normalizan convirtiéndolos a minúsculas.
Véase también KnownHeaders, setHeader(), hasRawHeader() y rawHeader().
void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)
Establece la configuración SSL de esta solicitud de red como config. Los parámetros que se aplican son la clave privada, el certificado local, el protocolo TLS (por ejemplo, TLS 1.3), los certificados de la autoridad de certificación (CA) y los algoritmos de cifrado que el backend SSL tiene permiso para utilizar.
Véase también sslConfiguration() y QSslConfiguration::defaultConfiguration().
[since 6.11] void QNetworkRequest::setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle)
Establece el tiempo que la conexión debe permanecer inactiva antes de que TCP comience a enviar sondas de mantenimiento de conexión (keepalive) para que se considere « idle », siempre que se haya activado la funcionalidad de mantenimiento de conexión de TCP.
Esta función se introdujo en Qt 6.11.
Véase también tcpKeepAliveIdleTimeBeforeProbes().
[since 6.11] void QNetworkRequest::setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval)
Establece el intervalo de tiempo entre cada sondeo de keepalive en interval, si se ha activado la funcionalidad TCP Keepalive.
Esta función se introdujo en Qt 6.11.
Véase también tcpKeepAliveIntervalBetweenProbes().
[since 6.11] void QNetworkRequest::setTcpKeepAliveProbeCount(int probes)
Establece el número máximo de mensajes « probes » de mantenimiento de conexión que el TCP debe enviar antes de interrumpir la conexión, siempre que se haya activado la funcionalidad «TCP Keepalive».
Esta función se introdujo en Qt 6.11.
Véase también tcpKeepAliveProbeCount().
void QNetworkRequest::setTransferTimeout(int timeout)
Establece timeout como tiempo de espera de la transferencia en milisegundos.
Véase también setTransferTimeout(std::chrono::milliseconds), transferTimeout() y transferTimeoutAsDuration().
[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = 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.
Esta función se introdujo en Qt 6.7.
Véase también transferTimeoutAsDuration().
void QNetworkRequest::setUrl(const QUrl &url)
Establece la URL a la que hace referencia esta solicitud de red como url.
Véase también url().
QSslConfiguration QNetworkRequest::sslConfiguration() const
Devuelve la configuración SSL de esta solicitud de red. Por defecto, es la misma que la de QSslConfiguration::defaultConfiguration().
Véase también setSslConfiguration() y QSslConfiguration::defaultConfiguration().
[noexcept] void QNetworkRequest::swap(QNetworkRequest &other)
Intercambia esta solicitud de red con other. Esta operación es muy rápida y nunca falla.
[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIdleTimeBeforeProbes() const
Devuelve el tiempo que la conexión debe permanecer inactiva antes de que TCP comience a enviar sondeos de mantenimiento de conexión, si se ha activado la funcionalidad de mantenimiento de conexión de TCP.
Esta función se introdujo en Qt 6.11.
Véase también ` setTcpKeepAliveIdleTimeBeforeProbes()`.
[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIntervalBetweenProbes() const
Devuelve el tiempo transcurrido entre cada sondeo de keepalive, si se ha activado la funcionalidad TCP Keepalive.
Esta función se introdujo en Qt 6.11.
Véase también setTcpKeepAliveIntervalBetweenProbes().
[since 6.11] int QNetworkRequest::tcpKeepAliveProbeCount() const
Devuelve el número máximo de sondeos de mantenimiento (keepalive) que el protocolo TCP debe enviar antes de interrumpir la conexión, si se ha activado la funcionalidad TCP Keepalive.
Esta función se introdujo en Qt 6.11.
Véase también ` setTcpKeepAliveProbeCount()`.
int QNetworkRequest::transferTimeout() const
Devuelve el tiempo de espera utilizado para las transferencias, en milisegundos.
Si transferTimeoutAsDuration().count() no se puede representar en int, esta función devuelve INT_MAX/INT_MIN en su lugar.
Véase también setTransferTimeout() y transferTimeoutAsDuration().
[since 6.7] std::chrono::milliseconds QNetworkRequest::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 ningún tiempo de espera.
Esta función se introdujo en Qt 6.7.
Véase también setTransferTimeout(std::chrono::milliseconds).
QUrl QNetworkRequest::url() const
Devuelve la URL a la que hace referencia esta solicitud de red.
Véase también setUrl().
bool QNetworkRequest::operator!=(const QNetworkRequest &other) const
Devuelve ` false ` si este objeto no es el mismo que ` other`.
Véase también operator==().
QNetworkRequest &QNetworkRequest::operator=(const QNetworkRequest &other)
Crea una copia de other
bool QNetworkRequest::operator==(const QNetworkRequest &other) const
Devuelve « true » si este objeto es el mismo que « other » (es decir, si tienen la misma URL, los mismos encabezados y la misma configuración de metadatos).
Véase también operator!=().
Documentación de las variables de miembro
const std::chrono::std::chrono::milliseconds QNetworkRequest::DefaultTransferTimeout
El tiempo de espera de la transferencia es de QNetworkRequest::TransferTimeoutConstant milisegundos. Se utiliza si se llama a setTransferTimeout() sin ningún argumento.
© 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.