QNetworkRequest Class

Documentación de las funciones miembro

QNetworkRequest::QNetworkRequest()

Construye un objeto QNetworkRequest sin URL a solicitar. Usa setUrl() para establecer una.

Véase también url() y setUrl().

[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)

Construye 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 no se ha establecido el atributo, devuelve defaultValue.

Véase también setAttribute() y QNetworkRequest::Attribute.

[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const

Devuelve el umbral para las comprobaciones de bomba de archivo.

Si el tamaño descomprimido de una respuesta es menor que esto, Qt simplemente la descomprimirá, sin más comprobaciones.

Esta función se introdujo en Qt 6.2.

Véase también setDecompressedSafetyCheckThreshold().

bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const

Devuelve true si la cabecera headerName está presente en esta petición de red.

Véase también rawHeader() y setRawHeader().

QVariant QNetworkRequest::header(QNetworkRequest::KnownHeaders header) const

Devuelve el valor de la cabecera de red conocida header si está presente en esta solicitud. Si no está presente, devuelve QVariant() (es decir, una variante inválida).

Véase también KnownHeaders, rawHeader(), y setHeader().

[since 6.8] QHttpHeaders QNetworkRequest::headers() const

Devuelve las cabeceras establecidas en esta petición 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 QNetworkAccessManager está utilizando para la conexión HTTP/1 subyacente de esta petición.

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 de una configuración establecida previamente por una aplicación o de una configuración predeterminada.

Los valores por defecto que QNetworkAccessManager está utilizando son:

• El tamaño de ventana para el control de flujo a nivel de conexión es 2147483647 octetos
• El tamaño de ventana para el control de flujo a nivel de flujo es 214748364 octetos
• El tamaño máximo de trama es 16384

Por defecto, el push del servidor está desactivado, 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 permitidas para esta petición.

Véase también setMaximumRedirectsAllowed().

QObject *QNetworkRequest::originatingObject() const

Devuelve una referencia al objeto que inició esta petición de red; devuelve nullptr si no se ha establecido o el objeto ha sido 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 establece 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 en bruto de la cabecera headerName. Si no existe tal cabecera, se devuelve un QByteArray vacío, que puede ser indistinguible de una cabecera presente pero sin contenido (utilice hasRawHeader() para averiguar si la cabecera existe o no).

Las cabeceras sin formato pueden establecerse con setRawHeader() o con setHeader().

Véase también header() y setRawHeader().

QList<QByteArray> QNetworkRequest::rawHeaderList() const

Devuelve una lista de todas las cabeceras sin procesar establecidas en esta solicitud de red. La lista está en el orden en que se establecieron las cabeceras.

Véase también hasRawHeader() y rawHeader().

void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)

Establece el atributo asociado con el código code al valor value. Si el atributo ya está establecido, se descarta el valor anterior. En especial, si value es un QVariant inválido, el atributo se anula.

Véase también attribute() y QNetworkRequest::Attribute.

[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)

Establece la dirección threshold para las comprobaciones de bomba de archivo.

Algunos algoritmos de compresión soportados pueden, en un archivo comprimido minúsculo, codificar un archivo descomprimido espectacularmente enorme. Esto sólo es posible si el contenido descomprimido es extremadamente monótono, lo que rara vez es el caso de los archivos reales que se transmiten de buena fe: los archivos que ejercen relaciones de compresión tan demencialmente altas suelen ser cargas útiles de ataques de desbordamiento de búfer o de denegación de servicio (por consumir demasiada memoria). En consecuencia, los archivos que se descomprimen hasta alcanzar tamaños enormes, especialmente a partir de formas comprimidas diminutas, es mejor rechazarlos como presunto malware.

Si el tamaño descomprimido de una respuesta es mayor que este umbral (por defecto, 10 MiB, es decir, 10 * 1024 * 1024), Qt comprobará la relación de compresión: si es excesivamente grande (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.

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 de la cabecera conocida header para que sea value, anulando cualquier cabecera establecida previamente. Esta operación también establece la cabecera HTTP sin procesar equivalente.

Véase también KnownHeaders, setRawHeader(), y header().

[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)

Establece newHeaders como cabeceras en esta petición de red, anulando cualquier cabecera establecida previamente.

Si algunas cabeceras se corresponden con las cabeceras conocidas, se analizarán los valores y también se establecerá la forma analizada 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 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 petición desde 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 petición desde configuration.

Véase también http2Configuration, QNetworkAccessManager, y QHttp2Configuration.

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

Establece el número máximo de redirecciones permitidas para esta petición en maxRedirectsAllowed.

Véase también maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Permite establecer una referencia al object que inicia la solicitud.

Por ejemplo Qt WebKit establece el objeto originador al QWebFrame que inició la petición.

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 utilizado para la conexión TCP.

Véase también peerVerifyName.

void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)

Establezca la prioridad de esta solicitud en priority.

Véase también priority().

void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

Establece la cabecera headerName con el valor 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 "cocinada" correspondiente.

Por ejemplo:

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

también establecerá la cabecera conocida LastModifiedHeader para que sea el objeto QDateTime de la fecha analizada.

Véase también KnownHeaders, setHeader(), hasRawHeader(), y rawHeader().

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Establece que la configuración SSL de esta solicitud de red sea config. Los ajustes que se aplican son la clave privada, el certificado local, el protocolo TLS (por ejemplo, TLS 1.3), los certificados CA y los cifrados que el backend SSL está autorizado a 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 necesita permanecer inactiva antes de que TCP comience a enviar sondas keepalive a idle, si la funcionalidad TCP Keepalive ha sido activada.

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 tiempo entre sondas keepalive individuales para ser interval, si la funcionalidad TCP Keepalive ha sido activada.

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 keepalive probes que TCP debe enviar antes de abandonar la conexión, si la funcionalidad TCP Keepalive ha sido activada.

Esta función se introdujo en Qt 6.11.

Véase también tcpKeepAliveProbeCount().

void QNetworkRequest::setTransferTimeout(int timeout)

Establece timeout como el tiempo de espera de 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 abortar la transferencia si no se intercambian datos.

Las transferencias se abortan si no se transfieren bytes antes de que expire el tiempo de espera. Cero significa que no se establece 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 se desactiva 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 que la URL a la que se refiere esta petición de red sea url.

Véase también url().

QSslConfiguration QNetworkRequest::sslConfiguration() const

Devuelve la configuración SSL de esta petición de red. Por defecto es la misma que 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 necesita permanecer inactiva antes de que TCP comience a enviar sondas keepalive, si la funcionalidad TCP Keepalive ha sido activada.

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 entre sondas keepalive individuales, si la funcionalidad TCP Keepalive ha sido activada.

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 sondas keepalive que TCP debería enviar antes de abandonar la conexión, si la funcionalidad TCP Keepalive ha sido activada.

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 puede representarse 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 el cual se cancela la transferencia si no se intercambian datos.

La duración por defecto es cero, lo que significa que el tiempo de espera no se utiliza.

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 se refiere esta petición 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, las mismas cabeceras y la misma configuración de metadatos).

Véase también operator!=().