QHttpServerConfiguration Class

Dokumentation der Memberfunktionen

QHttpServerConfiguration::QHttpServerConfiguration()

Default konstruiert ein QHttpServerConfiguration-Objekt.

Eine solche Konfiguration hat die folgenden Werte:

• Ratenbegrenzung ist deaktiviert

QHttpServerConfiguration::QHttpServerConfiguration(const QHttpServerConfiguration &other)

Kopiert diese QHttpServerConfiguration.

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

Verschieben-konstruiert diese QHttpServerConfiguration aus other

[noexcept] QHttpServerConfiguration::~QHttpServerConfiguration()

Zerstörer.

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

Gibt die schwarze Liste der Subnetze zurück, denen der Zugriff durch QHttpServer verweigert wird.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setBlacklist().

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

Gibt den von QHttpServer verwendeten Keep-Alive-Timeout zurück.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setKeepAliveTimeout().

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

Gibt die maximale Größe des eingehenden Bodys zurück, der vom Server akzeptiert wird.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch setMaximumBodySize().

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

Gibt die maximale Anzahl der vom Server akzeptierten eingehenden Header-Felder zurück.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch setMaximumHeaderFieldCount().

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

Gibt die maximale Größe der eingehenden Header zurück, die vom Server akzeptiert werden.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch setMaximumHeaderFieldSize().

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

Gibt die maximale Größe der gesamten eingehenden Header zurück, die vom Server akzeptiert werden.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch setMaximumTotalHeaderSize().

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

Gibt die maximale Größe der vom Server akzeptierten URL zurück.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch setMaximumUrlSize().

quint32 QHttpServerConfiguration::rateLimitPerSecond() const

Gibt die maximale Anzahl der eingehenden Anfragen pro Sekunde pro IP zurück, die vom Server akzeptiert werden.

Siehe auch setRateLimitPerSecond().

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

Legt subnetList als schwarze Liste für Subnetze fest.

IP-Adressen in dieser Liste wird der Zugriff durch QHttpServer verweigert. Die Blacklist ist nur aktiv, wenn die Whitelist leer ist.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch blacklist(), setWhitelist(), und QHostAddress::parseSubnet().

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

Legt timeout als Keep-Alive-Timeout für QHttpServer fest.

Der Keep-alive-Timeout bestimmt, wie lange eine inaktive Verbindung offen gehalten wird, bevor sie geschlossen wird. Standardmäßig ist die Zeitüberschreitung auf 15 Sekunden eingestellt.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch keepAliveTimeout().

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

Legt maxSize als maximale Größe des Textkörpers fest, die der Server akzeptiert. Wird diese Grenze überschritten, antwortet QHttpServer mit dem Status 413 Inhalt zu groß. Wenn maxSize -1 ist, gibt es keine Begrenzung. Der Standardwert ist 32 MiB.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch maximumBodySize() und QHttpServerResponder::StatusCode.

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

Legt maxSize als die maximale Anzahl von Header-Feldern fest, die der Server akzeptiert. Wird das Limit überschritten, antwortet QHttpServer mit dem Status 431 Request Header Fields Too Large. Wenn maxSize -1 ist, gibt es keine Begrenzung. Der Standardwert ist 128.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch maximumHeaderFieldCount() und QHttpServerResponder::StatusCode.

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

Legt maxSize als die maximale Größe eines einzelnen Headers fest, die der Server akzeptiert. Wenn die Grenze überschritten wird, antwortet QHttpServer mit dem Status 431 Request Header Fields Too Large. Wenn maxSize -1 ist, gibt es keine Begrenzung. Der Standardwert ist 48 KiB.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch maximumHeaderFieldSize() und QHttpServerResponder::StatusCode.

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

Legt maxSize als die maximale Gesamtgröße der Kopfzeilen fest, die der Server akzeptiert. Wird das Limit überschritten, antwortet QHttpServer mit dem Status 431 Request Header Fields Too Large. Wenn maxSize -1 ist, gibt es keine Begrenzung. Der Standardwert ist 64 KiB.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch maximumTotalHeaderSize() und QHttpServerResponder::StatusCode.

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

Legt maxSize als maximale Größe der URL fest, die der Server akzeptiert. Wenn die Grenze überschritten wird, antwortet QHttpServer mit dem Status 414 Request-URI Too Long. Wenn maxSize -1 ist, gibt es keine Begrenzung. Der Standardwert ist 64 KiB.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch maximumUrlSize() und QHttpServerResponder::StatusCode.

void QHttpServerConfiguration::setRateLimitPerSecond(quint32 maxRequests)

Legt maxRequests als maximale Anzahl von eingehenden Anfragen pro Sekunde und IP fest, die von QHttpServer akzeptiert werden. Wenn das Limit überschritten wird, antwortet QHttpServer mit QHttpServerResponder::StatusCode::TooManyRequests.

Siehe auch rateLimitPerSecond() und QHttpServerResponder::StatusCode.

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

Legt subnetList als Whitelist der erlaubten Subnetze fest.

Wenn die Liste nicht leer ist, werden nur IP-Adressen in dieser Liste von QHttpServer zugelassen. Die Whitelist hat Vorrang vor der Blacklist.

Jedes Subnetz wird als Paar dargestellt, bestehend aus:

• Einer Basis-IP-Adresse vom Typ QHostAddress.
• Eine CIDR-Präfixlänge vom Typ int, die die Subnetzmaske definiert.

Um nur eine bestimmte IP-Adresse zuzulassen, verwenden Sie eine Präfixlänge von 32 für IPv4 (z.B. "192.168.1.100/32") oder 128 für IPv6 (z.B. "2001:db8::1/128").

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch whitelist(), setBlacklist(), und QHostAddress::parseSubnet().

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

Tauscht diese Konfiguration mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

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

Gibt die Whitelist der von QHttpServer erlaubten Subnetze zurück.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch setWhitelist().

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

Verschieben - ordnet other dieser QHttpServerConfiguration zu.

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

Kopiert other auf diese QHttpServerConfiguration.