QHttpServerRequest Class

封装 HTTP 请求。更多

头文件: #include <QHttpServerRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS HttpServer)
target_link_libraries(mytarget PRIVATE Qt6::HttpServer)
qmake: QT += httpserver
Qt 6.4

公共类型

enum class Method { Unknown, Get, Put, Delete, Post, …, AnyKnown }
flags Methods

公共函数

~QHttpServerRequest()
QByteArray body() const
QHttpHeaders headers() &&
const QHttpHeaders &headers() const &
(since 6.5) QHostAddress localAddress() const
(since 6.5) quint16 localPort() const
QHttpServerRequest::Method method() const
QUrlQuery query() const
QHostAddress remoteAddress() const
(since 6.5) quint16 remotePort() const
(since 6.7) QSslConfiguration sslConfiguration() const
QUrl url() const
QByteArray value(const QByteArray &key) const
QDebug operator<<(QDebug debug, const QHttpServerRequest &request)

详细说明

用于访问传入请求的不同参数的 API。

成员类型文档

枚举类 QHttpServerRequest::Method
flags QHttpServerRequest::Methods

该枚举类型指定 HTTP 请求方法:

常量描述
QHttpServerRequest::Method::Unknown0x0000未知方法。
QHttpServerRequest::Method::Get0x0001HTTP GET 方法。
QHttpServerRequest::Method::Put0x0002HTTP PUT 方法。
QHttpServerRequest::Method::Delete0x0004HTTP DELETE 方法。
QHttpServerRequest::Method::Post0x0008HTTP POST 方法。
QHttpServerRequest::Method::Head0x0010HTTP HEAD 方法。
QHttpServerRequest::Method::Options0x0020HTTP OPTIONS 方法。
QHttpServerRequest::Method::Patch0x0040HTTP PATCH 方法(RFC 5789)。
QHttpServerRequest::Method::Connect0x0080HTTP CONNECT 方法。
QHttpServerRequest::Method::Trace0x0100HTTP TRACE 方法。
QHttpServerRequest::Method::AnyKnownGet | Put | Delete | Post | Head | Options | Patch | Connect | Trace所有已知方法的组合。

Methods 类型是QFlags<Method> 的类型定义。它存储方法值的 OR 组合。

成员函数文档

QHttpHeaders QHttpServerRequest::headers() &&

const QHttpHeaders &QHttpServerRequest::headers() const &

返回所有请求标头。

[noexcept] QHttpServerRequest::~QHttpServerRequest()

摧毁一个QHttpServerRequest

QByteArray QHttpServerRequest::body() const

返回请求正文。

[since 6.5] QHostAddress QHttpServerRequest::localAddress() const

返回接收请求的本地套接字的主机地址。

此函数在 Qt 6.5 中引入。

[since 6.5] quint16 QHttpServerRequest::localPort() const

返回接收请求的本地套接字的端口。

此函数在 Qt 6.5 中引入。

QHttpServerRequest::Method QHttpServerRequest::method() const

返回请求的方法。

QUrlQuery QHttpServerRequest::query() const

返回请求中的查询。

QHostAddress QHttpServerRequest::remoteAddress() const

返回请求源主机的地址。

[since 6.5] quint16 QHttpServerRequest::remotePort() const

返回请求源主机的端口。

此函数在 Qt 6.5 中引入。

[since 6.7] QSslConfiguration QHttpServerRequest::sslConfiguration() const

返回已建立的 TLS 连接的配置。如果连接未使用 TLS,则配置将在 isNull() 时返回 true。

此函数在 Qt 6.7 中引入。

QUrl QHttpServerRequest::url() const

返回请求请求的 URL。

QByteArray QHttpServerRequest::value(const QByteArray &key) const

返回指定key 的所有标头的合并值。

相关非会员

QDebug operator<<(QDebug debug, const QHttpServerRequest &request)

将有关request 的信息写入debug 流。

另请参阅 QDebug

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