En esta página

QHttp2Configuration Class

La clase QHttp2Configuration controla los parámetros y la configuración de HTTP/2. Más información...

Encabezado: #include <QHttp2Configuration>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QHttp2Configuration()
QHttp2Configuration(const QHttp2Configuration &other)
QHttp2Configuration(QHttp2Configuration &&other)
~QHttp2Configuration()
bool huffmanCompressionEnabled() const
(since 6.9) unsigned int maxConcurrentStreams() const
unsigned int maxFrameSize() const
bool serverPushEnabled() const
unsigned int sessionReceiveWindowSize() const
void setHuffmanCompressionEnabled(bool enable)
(since 6.9) void setMaxConcurrentStreams(unsigned int value)
bool setMaxFrameSize(unsigned int size)
void setServerPushEnabled(bool enable)
bool setSessionReceiveWindowSize(unsigned int size)
bool setStreamReceiveWindowSize(unsigned int size)
unsigned int streamReceiveWindowSize() const
void swap(QHttp2Configuration &other)
QHttp2Configuration &operator=(QHttp2Configuration &&other)
QHttp2Configuration &operator=(const QHttp2Configuration &other)
bool operator!=(const QHttp2Configuration &lhs, const QHttp2Configuration &rhs)
bool operator==(const QHttp2Configuration &lhs, const QHttp2Configuration &rhs)

Descripción detallada

QHttp2Configuration controla los parámetros y la configuración de HTTP/2 que utilizará QNetworkAccessManager para enviar solicitudes y procesar respuestas cuando el protocolo HTTP/2 esté habilitado.

Los parámetros HTTP/2 que admite actualmente QHttp2Configuration incluyen:

  • El tamaño de la ventana de sesión para el control de flujo a nivel de conexión. Se enviará a un par remoto cuando sea necesario como tramas «WINDOW_UPDATE» en el flujo con el identificador 0.
  • El tamaño de la ventana de recepción del flujo para el control de flujo a nivel de flujo. Se envía como parámetro «SETTINGS_INITIAL_WINDOW_SIZE» en la trama SETTINGS inicial y, cuando sea necesario, se enviarán tramas «WINDOW_UPDATE» en los flujos que abra QNetworkAccessManager.
  • El tamaño máximo de trama. Este parámetro limita la carga útil máxima que puede tener una trama procedente del par remoto. Enviado por QNetworkAccessManager como parámetro «SETTINGS_MAX_FRAME_SIZE» en la trama «SETTINGS» inicial.
  • El envío por parte del servidor. Permite habilitar o deshabilitar el envío por parte del servidor. Se envía como parámetro «SETTINGS_ENABLE_PUSH» en la trama «SETTINGS» inicial.

La clase QHttp2Configuration también controla si el algoritmo de compresión de encabezados (HPACK) utiliza además la codificación de Huffman para la compresión de cadenas.

Nota: La configuración debe establecerse antes de que se envíe la primera solicitud a un host determinado (y, por lo tanto, antes de que se establezca una sesión HTTP/2).

Nota: Se puede encontrarinformación detallada sobre el control de flujo, el envío por parte del servidor y «SETTINGS» en el RFC 7540. Los diferentes modos y parámetros del algoritmo de compresión HPACK se describen en el RFC 7541.

Véase también QNetworkRequest::setHttp2Configuration(), QNetworkRequest::http2Configuration() y QNetworkAccessManager.

Documentación de las funciones miembro

QHttp2Configuration::QHttp2Configuration()

Por defecto, se crea un objeto `QHttp2Configuration`.

Dicha configuración tiene los siguientes valores:

  • La función «server push» está desactivada
  • La compresión de cadenas Huffman está habilitada
  • El tamaño de ventana para el control de flujo a nivel de conexión es de 65 535 octetos
  • El tamaño de ventana para el control de flujo a nivel de flujo es de 65 535 octetos
  • El tamaño de trama es de 16 384 octetos
  • El tamaño máximo aceptado de la lista de encabezados es de 262 144 octetos (256 KiB)

QHttp2Configuration::QHttp2Configuration(const QHttp2Configuration &other)

Crea una copia de esta QHttp2Configuration.

[noexcept] QHttp2Configuration::QHttp2Configuration(QHttp2Configuration &&other)

Crea esta instancia de `QHttp2Configuration` a partir de other

[noexcept] QHttp2Configuration::~QHttp2Configuration()

Destructor.

bool QHttp2Configuration::huffmanCompressionEnabled() const

Devuelve « true » si la codificación de Huffman en HPACK está activada.

Véase también setHuffmanCompressionEnabled.

[since 6.9] unsigned int QHttp2Configuration::maxConcurrentStreams() const

Devuelve el número máximo de flujos simultáneos.

Esta función se introdujo en Qt 6.9.

Véase también setMaxConcurrentStreams().

unsigned int QHttp2Configuration::maxFrameSize() const

Devuelve el tamaño máximo de la carga útil que pueden tener las tramas HTTP/2. El valor predeterminado (inicial) es 16 384 octetos.

Véase también ` setMaxFrameSize()`.

bool QHttp2Configuration::serverPushEnabled() const

Devuelve «true» si se ha habilitado el «server push».

Nota: Por defecto, QNetworkAccessManager desactiva el «server push» a través del marco «SETTINGS».

Véase también setServerPushEnabled.

unsigned int QHttp2Configuration::sessionReceiveWindowSize() const

Devuelve el tamaño de la ventana para el control de flujo a nivel de conexión. El valor por defecto que utilizará QNetworkAccessManager es de 2147483647 octetos.

Véase también setSessionReceiveWindowSize().

void QHttp2Configuration::setHuffmanCompressionEnabled(bool enable)

Si enable es true, la compresión HPACK comprimirá adicionalmente las cadenas mediante la codificación de Huffman. Está habilitada por defecto.

Nota: Este parámetro solo afecta a las tramas «HEADERS» que envía QNetworkAccessManager.

Véase también huffmanCompressionEnabled.

[since 6.9] void QHttp2Configuration::setMaxConcurrentStreams(unsigned int value)

Establece « value » como el número máximo de flujos simultáneos que se comunicarán al par al enviar la trama SETTINGS.

Esta función se introdujo en Qt 6.9.

Véase también maxConcurrentStreams().

bool QHttp2Configuration::setMaxFrameSize(unsigned int size)

Establece el tamaño máximo de trama que QNetworkAccessManager comunicará al servidor al enviar su trama SETTINGS inicial.

Nota: Aunque este valor « size » debe estar comprendido entre 16384 y 16777215, ambos inclusive, el tamaño real de la carga útil en los tramas que la transportan puede ser inferior a 16384.

Devuelve true si se realiza correctamente; en caso contrario, devuelve false.

Véase también maxFrameSize().

void QHttp2Configuration::setServerPushEnabled(bool enable)

Si enable es true, un servidor remoto podría utilizar la función «server push» para enviar respuestas por adelantado.

Véase también serverPushEnabled.

bool QHttp2Configuration::setSessionReceiveWindowSize(unsigned int size)

Establece el tamaño de la ventana para el control de flujo a nivel de conexión. El valor « size » no puede ser 0 y no debe superar los 2147483647 octetos.

Devuelve true si la operación se realiza correctamente; en caso contrario, devuelve false.

Véase también sessionReceiveWindowSize.

bool QHttp2Configuration::setStreamReceiveWindowSize(unsigned int size)

Establece el tamaño de la ventana para el control de flujo a nivel de flujo. size no puede ser 0 y no debe superar los 2147483647 octetos.

Devuelve true si la operación se realiza correctamente; en caso contrario, devuelve false.

Véase también streamReceiveWindowSize.

unsigned int QHttp2Configuration::streamReceiveWindowSize() const

Devuelve el tamaño de la ventana para el control de flujo a nivel de flujo. El valor por defecto que utilizará QNetworkAccessManager es de 214748364 octetos (véase RFC 7540).

Véase también setStreamReceiveWindowSize().

[noexcept] void QHttp2Configuration::swap(QHttp2Configuration &other)

Cambia esta configuración por other. Esta operación es muy rápida y nunca falla.

[noexcept] QHttp2Configuration &QHttp2Configuration::operator=(QHttp2Configuration &&other)

Asigna other a este QHttp2Configuration.

QHttp2Configuration &QHttp2Configuration::operator=(const QHttp2Configuration &other)

Asigna por copia other a este QHttp2Configuration.

Personas no afiliadas relacionadas

[noexcept] bool operator!=(const QHttp2Configuration &lhs, const QHttp2Configuration &rhs)

Devuelve « true » si « lhs » y « rhs » no tienen el mismo conjunto de parámetros HTTP/2.

[noexcept] bool operator==(const QHttp2Configuration &lhs, const QHttp2Configuration &rhs)

Devuelve « true » si « lhs » y « rhs » tienen el mismo conjunto de parámetros HTTP/2.

© 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.