QHttpServerConfiguration Class
La classe QHttpServerConfiguration contrôle les paramètres du serveur. Plus d'informations...
| En-tête : | #include <QHttpServerConfiguration> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS HttpServer)target_link_libraries(mytarget PRIVATE Qt6::HttpServer) |
| qmake : | QT += httpserver |
| Depuis : | Qt 6.9 |
Fonctions publiques
| 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.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.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) |
Non-membres apparentés
| bool | operator!=(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs) |
| bool | operator==(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs) |
Documentation des fonctions membres
QHttpServerConfiguration::QHttpServerConfiguration()
Default construit un objet QHttpServerConfiguration.
Une telle configuration a les valeurs suivantes :
- La limite de débit est désactivée
QHttpServerConfiguration::QHttpServerConfiguration(const QHttpServerConfiguration &other)
Copie-construit cette QHttpServerConfiguration.
[constexpr noexcept] QHttpServerConfiguration::QHttpServerConfiguration(QHttpServerConfiguration &&other)
Move-construit cette QHttpServerConfiguration à partir de other
[noexcept] QHttpServerConfiguration::~QHttpServerConfiguration()
Destructeur.
[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::blacklist() const
Renvoie la liste noire des sous-réseaux dont l'accès est refusé par QHttpServer.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi setBlacklist().
[since 6.10] std::chrono::seconds QHttpServerConfiguration::keepAliveTimeout() const
Renvoie le délai de maintien en vie utilisé par QHttpServer.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi setKeepAliveTimeout().
[since 6.11] qint64 QHttpServerConfiguration::maximumBodySize() const
Renvoie la taille maximale du corps entrant accepté par le serveur.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi setMaximumBodySize().
[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldCount() const
Renvoie le nombre maximum de champs d'en-tête acceptés par le serveur.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi setMaximumHeaderFieldCount().
[since 6.11] qint64 QHttpServerConfiguration::maximumHeaderFieldSize() const
Renvoie la taille maximale des en-têtes entrants acceptés par le serveur.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi setMaximumHeaderFieldSize().
[since 6.11] qint64 QHttpServerConfiguration::maximumTotalHeaderSize() const
Renvoie la taille maximale de l'ensemble des en-têtes entrants acceptés par le serveur.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi setMaximumTotalHeaderSize().
[since 6.11] qint64 QHttpServerConfiguration::maximumUrlSize() const
Renvoie la taille maximale de l'URL acceptée par le serveur.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi setMaximumUrlSize().
quint32 QHttpServerConfiguration::rateLimitPerSecond() const
Renvoie le nombre maximum de requêtes entrantes par seconde et par IP acceptées par le serveur.
Voir aussi setRateLimitPerSecond().
[since 6.10] void QHttpServerConfiguration::setBlacklist(QSpan<const std::pair<QHostAddress, int>> subnetList)
Définit subnetList comme liste noire de sous-réseaux.
Les adresses IP figurant sur cette liste se verront refuser l'accès par QHttpServer. La liste noire n'est active que lorsque la liste blanche est vide.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi blacklist(), setWhitelist() et QHostAddress::parseSubnet().
[since 6.10] void QHttpServerConfiguration::setKeepAliveTimeout(std::chrono::seconds timeout)
Définit timeout comme délai d'attente pour QHttpServer.
Le délai de maintien en vie détermine la durée pendant laquelle une connexion inactive est maintenue ouverte avant d'être fermée. Par défaut, le délai est fixé à 15 secondes.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi keepAliveTimeout().
[since 6.11] void QHttpServerConfiguration::setMaximumBodySize(qint64 maxSize)
Fixe à maxSize la taille maximale du corps du message que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 413 Content Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 32 MiB.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi maximumBodySize() et QHttpServerResponder::StatusCode.
[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldCount(qint64 maxSize)
Fixe à maxSize le nombre maximum de champs d'en-tête acceptés par le serveur. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est 128.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi maximumHeaderFieldCount() et QHttpServerResponder::StatusCode.
[since 6.11] void QHttpServerConfiguration::setMaximumHeaderFieldSize(qint64 maxSize)
Fixe à maxSize la taille maximale d'un seul en-tête que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 48 KiB.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi maximumHeaderFieldSize() et QHttpServerResponder::StatusCode.
[since 6.11] void QHttpServerConfiguration::setMaximumTotalHeaderSize(qint64 maxSize)
Fixe à maxSize la taille totale maximale des en-têtes que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 431 Request Header Fields Too Large. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 64 KiB.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi maximumTotalHeaderSize() et QHttpServerResponder::StatusCode.
[since 6.11] void QHttpServerConfiguration::setMaximumUrlSize(qint64 maxSize)
Fixe à maxSize la taille maximale de l'URL que le serveur acceptera. Si la limite est dépassée, QHttpServer répondra avec le statut 414 Request-URI Too Long. Si maxSize vaut -1, il n'y a pas de limite. La valeur par défaut est de 64 KiB.
Cette fonction a été introduite dans Qt 6.11.
Voir aussi maximumUrlSize() et QHttpServerResponder::StatusCode.
void QHttpServerConfiguration::setRateLimitPerSecond(quint32 maxRequests)
Fixe à maxRequests le nombre maximum de requêtes entrantes par seconde et par IP qui seront acceptées par QHttpServer. Si la limite est dépassée, QHttpServer répondra par QHttpServerResponder::StatusCode::TooManyRequests.
Voir aussi rateLimitPerSecond() et QHttpServerResponder::StatusCode.
[since 6.10] void QHttpServerConfiguration::setWhitelist(QSpan<const std::pair<QHostAddress, int>> subnetList)
Définit subnetList comme liste blanche des sous-réseaux autorisés.
Si la liste n'est pas vide, seules les adresses IP figurant dans cette liste seront autorisées par QHttpServer. La liste blanche est prioritaire sur la liste noire.
Chaque sous-réseau est représenté par une paire composée de :
- une adresse IP de base de type QHostAddress.
- Une longueur de préfixe CIDR de type int, qui définit le masque de sous-réseau.
Pour n'autoriser qu'une adresse IP spécifique, utilisez une longueur de préfixe de 32 pour IPv4 (par exemple, "192.168.1.100/32") ou de 128 pour IPv6 (par exemple, "2001:db8::1/128").
Cette fonction a été introduite dans Qt 6.10.
Voir aussi whitelist(), setBlacklist(), et QHostAddress::parseSubnet().
[noexcept] void QHttpServerConfiguration::swap(QHttpServerConfiguration &other)
Remplace cette configuration par other. Cette opération est très rapide et n'échoue jamais.
[since 6.10] QSpan<const std::pair<QHostAddress, int>> QHttpServerConfiguration::whitelist() const
Renvoie la liste blanche des sous-réseaux autorisés par QHttpServer.
Cette fonction a été introduite dans Qt 6.10.
Voir aussi setWhitelist().
[noexcept] QHttpServerConfiguration &QHttpServerConfiguration::operator=(QHttpServerConfiguration &&other)
Move-assigns other to this QHttpServerConfiguration.
QHttpServerConfiguration &QHttpServerConfiguration::operator=(const QHttpServerConfiguration &other)
Copie-assignation de other à ce QHttpServerConfiguration.
Non-membres apparentés
[noexcept] bool operator!=(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)
Renvoie true si lhs et rhs n'ont pas le même ensemble de paramètres de configuration.
[noexcept] bool operator==(const QHttpServerConfiguration &lhs, const QHttpServerConfiguration &rhs)
Renvoie true si lhs et rhs ont le même ensemble de paramètres de configuration.
© 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.