En esta página

QHttpServerConfiguration Class

La clase QHttpServerConfiguration controla los parámetros del servidor. Más información...

Encabezado: #include <QHttpServerConfiguration>
CMake: find_package(Qt6 REQUIRED COMPONENTS HttpServer)
target_link_libraries(mytarget PRIVATE Qt6::HttpServer)
qmake: QT += httpserver
Desde: Qt 6.9

Funciones públicas

QHttpServerConfiguration()
QHttpServerConfiguration(const QHttpServerConfiguration &other)
QHttpServerConfiguration(QHttpServerConfiguration &&other)
~QHttpServerConfiguration()
(since 6.10) QSpan<const std::pair<QHostAddress, int>> blacklist() const
(since 6.10) std::chrono::seconds keepAliveTimeout() const
(since 6.11) qint64 maximumBodySize() const
(since 6.12) quint32 maximumConnections() const
(since 6.12) quint32 maximumConnectionsPerHost() const
(since 6.11) qint64 maximumHeaderFieldCount() const
(since 6.11) qint64 maximumHeaderFieldSize() const
(since 6.11) qint64 maximumTotalHeaderSize() const
(since 6.11) qint64 maximumUrlSize() const
quint32 rateLimitPerSecond() const
(since 6.10) void setBlacklist(QSpan<const std::pair<QHostAddress, int>> subnetList)
(since 6.10) void setKeepAliveTimeout(std::chrono::seconds timeout)
(since 6.11) void setMaximumBodySize(qint64 maxSize)
(since 6.12) void setMaximumConnections(quint32 maxConnections)
(since 6.12) void setMaximumConnectionsPerHost(quint32 maxPerHost)
(since 6.11) void setMaximumHeaderFieldCount(qint64 maxSize)
(since 6.11) void setMaximumHeaderFieldSize(qint64 maxSize)
(since 6.11) void setMaximumTotalHeaderSize(qint64 maxSize)
(since 6.11) void setMaximumUrlSize(qint64 maxSize)
void setRateLimitPerSecond(quint32 maxRequests)
(since 6.10) void setWhitelist(QSpan<const std::pair<QHostAddress, int>> subnetList)
void swap(QHttpServerConfiguration &other)
(since 6.10) QSpan<const std::pair<QHostAddress, int>> whitelist() const
QHttpServerConfiguration &operator=(QHttpServerConfiguration &&other)
QHttpServerConfiguration &operator=(const QHttpServerConfiguration &other)
bool operator!=(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)
bool operator==(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)

Descripción detallada

Documentación de las funciones de miembro

QHttpServerConfiguration::QHttpServerConfiguration()

Por defecto, se crea un objeto `QHttpServerConfiguration`.

Dicha configuración tiene los siguientes valores:

  • El límite de velocidad está desactivado.
  • El número máximo de conexiones está desactivado.
  • El número máximo de conexiones por host está desactivado.
  • El tiempo de espera de Keep-Alive está fijado en 15 segundos.
  • La lista blanca está vacía.
  • La lista negra está vacía.
  • El tamaño máximo de la URL es de 64 KiB.
  • El tamaño máximo total de los encabezados es de 64 KiB.
  • El tamaño máximo de un campo de encabezado es de 48 KiB.
  • El número máximo de campos de encabezado es 128.
  • El tamaño máximo del cuerpo es de 32 MiB.

QHttpServerConfiguration::QHttpServerConfiguration(const QHttpServerConfiguration &other)

Crea una copia de esta configuración de QHttpServerConfiguration.

[constexpr noexcept default] QHttpServerConfiguration::QHttpServerConfiguration(QHttpServerConfiguration &&other)

Crea esta instancia de QHttpServerConfiguration a partir de other

[noexcept] QHttpServerConfiguration::~QHttpServerConfiguration()

Destructor.

[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::blacklist() const

Devuelve la lista negra de subredes a las que se les niega el acceso mediante ` QHttpServer`.

Esta función se introdujo en Qt 6.10.

Véase también setBlacklist().

[since 6.10] std::chrono::seconds QHttpServerConfiguration::keepAliveTimeout() const

Devuelve el tiempo de espera de «keep-alive» utilizado por QHttpServer. Se trata del tiempo que una conexión inactiva puede permanecer abierta antes de que se agote el tiempo de espera.

Esta función se introdujo en Qt 6.10.

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

[since 6.11] qint64 QHttpServerConfiguration::maximumBodySize() const

Devuelve el tamaño máximo del cuerpo del mensaje entrante que admite el servidor.

Esta función se introdujo en Qt 6.11.

Véase también setMaximumBodySize().

[since 6.12] quint32 QHttpServerConfiguration::maximumConnections() const

Devuelve el número máximo de conexiones simultáneas que admite el servidor en total.

Devuelve 0 si el límite total de conexiones está desactivado.

Esta función se introdujo en Qt 6.12.

Véase también setMaximumConnections().

[since 6.12] quint32 QHttpServerConfiguration::maximumConnectionsPerHost() const

Devuelve el número máximo de conexiones simultáneas por host que aceptará el servidor. El host se identifica mediante la dirección IP de la conexión TCP entrante.

Devuelve 0 si el límite de conexiones por host está desactivado.

Esta función se introdujo en Qt 6.12.

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

[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldCount() const

Devuelve el número máximo de campos de encabezado entrantes que acepta el servidor.

Esta función se introdujo en Qt 6.11.

Véase también setMaximumHeaderFieldCount().

[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldSize() const

Devuelve el tamaño máximo de cada campo de encabezado entrante aceptado por el servidor.

Esta función se introdujo en Qt 6.11.

Véase también setMaximumHeaderFieldSize().

[since 6.11] qint64 QHttpServerConfiguration::maximumTotalHeaderSize() const

Devuelve el tamaño máximo total de los encabezados entrantes que acepta el servidor.

Esta función se introdujo en Qt 6.11.

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

[since 6.11] qint64 QHttpServerConfiguration::maximumUrlSize() const

Devuelve el tamaño máximo de la URL que admite el servidor.

Esta función se introdujo en Qt 6.11.

Véase también setMaximumUrlSize().

quint32 QHttpServerConfiguration::rateLimitPerSecond() const

Devuelve el número máximo de solicitudes entrantes por segundo por dirección IP que acepta el servidor.

Este límite se aplica por separado a cada dirección IP de cliente. Devuelve 0 si la limitación de tasa está desactivada.

Véase también setRateLimitPerSecond().

[since 6.10] void QHttpServerConfiguration::setBlacklist(QSpan<const std::pair<QHostAddress, int>> subnetList)

Establece subnetList como lista negra de subredes.

QHttpServer denegará el acceso a las direcciones IP incluidas en esta lista. La lista negra solo está activa cuando la lista blanca está vacía.

Por defecto, la lista negra está vacía.

Esta función se introdujo en Qt 6.10.

Véase también blacklist(), setWhitelist() y QHostAddress::parseSubnet().

[since 6.10] void QHttpServerConfiguration::setKeepAliveTimeout(std::chrono::seconds timeout)

Establece ` timeout ` como tiempo de espera de «keep-alive» para ` QHttpServer`.

El tiempo de espera de «keep-alive» determina cuánto tiempo permanece abierta una conexión inactiva antes de cerrarse.

Por defecto, el tiempo de espera está fijado en 15 segundos.

Esta función se introdujo en Qt 6.10.

Véase también keepAliveTimeout().

[since 6.11] void QHttpServerConfiguration::setMaximumBodySize(qint64 maxSize)

Establece « maxSize » como el tamaño máximo del cuerpo de la solicitud que el servidor aceptará. Si se supera el límite, QHttpServer responderá con el código de estado 413 «Content Too Large». Si maxSize es -1, no hay límite.

El valor por defecto es 32 MiB.

Esta función se introdujo en Qt 6.11.

Véase también maximumBodySize() y QHttpServerResponder::StatusCode.

[since 6.12] void QHttpServerConfiguration::setMaximumConnections(quint32 maxConnections)

Establece el límite de maxConnections sobre el número total de conexiones simultáneas que aceptará el servidor. Si se alcanza el límite, el servidor rechaza nuevas conexiones. En el caso de las conexiones HTTP/1, QHttpServer responde con QHttpServerResponder::StatusCode::TooManyRequests y cierra la conexión.

Si maxConnections se establece en 0, se desactiva el límite total de conexiones.

Por defecto, este límite está desactivado.

Esta función se introdujo en Qt 6.12.

Véase también maximumConnections() y QHttpServerResponder::StatusCode.

[since 6.12] void QHttpServerConfiguration::setMaximumConnectionsPerHost(quint32 maxPerHost)

Establece el límite de conexiones simultáneas maxPerHost por host que aceptará QHttpServer. Si se supera el límite, QHttpServer responderá con QHttpServerResponder::StatusCode::TooManyRequests.

Si maxPerHost se establece en 0, se desactiva el límite de conexiones por host. Esto debe hacerse cuando se ejecuta detrás de un proxy inverso, ya que todos los sockets entrantes parecerán proceder del proxy inverso.

Cuando se alcanza el límite de conexiones por host, las conexiones HTTP/1 se cierran con una respuesta 429 (Demasiadas solicitudes). En el caso de las conexiones SSL, la conexión se cierra cuando se supera el límite.

Por defecto, esta opción está desactivada.

Esta función se introdujo en Qt 6.12.

Véase también maximumConnectionsPerHost() y QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldCount(qint64 maxSize)

Establece « maxSize » como el número máximo de campos de encabezado que el servidor aceptará en una solicitud. Si se supera el límite, QHttpServer responderá con el código de estado 431 «Request Header Fields Too Large». Si maxSize es -1, no hay límite.

El valor por defecto es 128.

Esta función se introdujo en Qt 6.11.

Véanse también « maximumHeaderFieldCount()» y « QHttpServerResponder::StatusCode ».

[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldSize(qint64 maxSize)

Establece « maxSize » como el tamaño máximo de cualquier campo de encabezado individual que el servidor aceptará en una solicitud. Si se supera el límite, QHttpServer responderá con el código de estado 431 «Request Header Fields Too Large». Si maxSize es -1, no hay límite.

El valor por defecto es 48 KiB.

Esta función se introdujo en Qt 6.11.

Véase también maximumHeaderFieldSize() y QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumTotalHeaderSize(qint64 maxSize)

Establece « maxSize » como el tamaño total máximo de los campos de encabezado que el servidor aceptará en una solicitud. Si se supera el límite, QHttpServer responderá con el código de estado 431 «Request Header Fields Too Large». Si maxSize es -1, no hay límite.

El valor por defecto es 64 KiB.

Esta función se introdujo en Qt 6.11.

Véase también maximumTotalHeaderSize() y QHttpServerResponder::StatusCode.

[since 6.11] void QHttpServerConfiguration::setMaximumUrlSize(qint64 maxSize)

Establece maxSize como el tamaño máximo de la URL de la solicitud que el servidor aceptará. Si se supera el límite, QHttpServer responderá con el código de estado 414 «Request-URI Too Long». Si maxSize es -1, no hay límite.

El valor por defecto es 64 KiB.

Esta función se introdujo en Qt 6.11.

Véase también maximumUrlSize() y QHttpServerResponder::StatusCode.

void QHttpServerConfiguration::setRateLimitPerSecond(quint32 maxRequests)

Establece « maxRequests » como el número máximo de solicitudes entrantes por segundo por dirección IP que aceptará QHttpServer. Si se supera el límite, QHttpServer responderá con QHttpServerResponder::StatusCode::TooManyRequests.

Este límite se aplica por separado a cada dirección IP de cliente. Un valor de 0 desactiva la limitación de tasa.

Por defecto, la limitación de tasa está desactivada.

Véase también rateLimitPerSecond() y QHttpServerResponder::StatusCode.

[since 6.10] void QHttpServerConfiguration::setWhitelist(QSpan<const std::pair<QHostAddress, int>> subnetList)

Establece subnetList como la lista blanca de subredes permitidas.

Cuando la lista no está vacía, QHttpServer solo permitirá las direcciones IP que figuren en ella. La lista blanca tiene prioridad sobre la lista negra.

Cada subred se representa como un par formado por:

  • Una dirección IP base de tipo QHostAddress.
  • Una longitud de prefijo CIDR de tipo int, que define la máscara de subred.

Para permitir únicamente una dirección IP específica, utilice una longitud de prefijo de 32 para IPv4 (por ejemplo, "192.168.1.100/32") o de 128 para IPv6 (por ejemplo, "2001:db8::1/128").

Por defecto, la lista blanca está vacía.

Esta función se introdujo en Qt 6.10.

Véase también whitelist(), setBlacklist() y QHostAddress::parseSubnet().

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

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

[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::whitelist() const

Devuelve la lista blanca de subredes permitidas por QHttpServer.

Cuando la lista blanca no está vacía, solo se permiten las direcciones de las subredes devueltas. La lista blanca tiene prioridad sobre la lista negra.

Por defecto, la lista blanca está vacía.

Esta función se introdujo en Qt 6.10.

Véase también setWhitelist().

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

Asigna « other » a este « QHttpServerConfiguration ».

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

Asigna por copia other a esta dirección QHttpServerConfiguration.

Personas no socias relacionadas

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

Devuelve « true » si « lhs » y « rhs » no tienen el mismo conjunto de parámetros de configuración.

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

Devuelve « true » si « lhs » y « rhs » tienen el mismo conjunto de parámetros de configuración.

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