QHttpServerResponse Class
封装了一个 HTTP 响应。更多...
| 头文件： | #include <QHttpServerResponse> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS HttpServer) target_link_libraries(mytarget PRIVATE Qt6::HttpServer) |
| qmake： | QT += httpserver |
| 自： | Qt 6.4 |
公共类型
公共函数
| QHttpServerResponse(QHttpServerResponse::StatusCode statusCode) | |
| QHttpServerResponse(QByteArray &&data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QByteArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QJsonArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QJsonObject &data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QString &data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const char *data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QByteArray &mimeType, QByteArray &&data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(const QByteArray &mimeType, const QByteArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok) | |
| QHttpServerResponse(QHttpServerResponse &&other) | |
| ~QHttpServerResponse() | |
| QByteArray | data() const |
(since 6.8) QHttpHeaders | headers() const |
| QByteArray | mimeType() const |
(since 6.8) void | setHeaders(QHttpHeaders &&newHeaders) |
(since 6.8) void | setHeaders(const QHttpHeaders &newHeaders) |
| QHttpServerResponse::StatusCode | statusCode() const |
| void | swap(QHttpServerResponse &other) |
| QHttpServerResponse & | operator=(QHttpServerResponse &&other) |
静态公共成员
| QHttpServerResponse | fromFile(const QString &fileName) |
详细说明
用于创建、读取和修改来自HTTP服务器的响应，并将响应内容写入QHttpServerResponder 的API。它具有多个构造函数，以及static 函数fromFile ，用于根据文件内容构建响应。此外，还提供用于设置、获取和删除头部，以及获取数据、状态码和MIME类型的函数。
成员函数文档
QHttpServerResponse::QHttpServerResponse(QHttpServerResponse::StatusCode statusCode)
创建一个状态码为statusCode 的QHttpServerResponse对象。
QHttpServerResponse::QHttpServerResponse(QByteArray &&data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
通过 Move 构造一个 QHttpServerResponse，其正文将包含给定的data ，状态码为status 。
QHttpServerResponse::QHttpServerResponse(const QByteArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
根据data 创建一个QHttpServerResponse对象，其状态码为status 。
QHttpServerResponse::QHttpServerResponse(const QJsonArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
根据data 创建一个QHttpServerResponse对象，状态码为status 。
QHttpServerResponse::QHttpServerResponse(const QJsonObject &data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
根据data 创建一个QHttpServerResponse对象，其状态码为status 。
QHttpServerResponse::QHttpServerResponse(const QString &data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
根据data 创建一个QHttpServerResponse对象，其状态码为status 。
QHttpServerResponse::QHttpServerResponse(const char *data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
根据data 创建一个QHttpServerResponse对象，其状态码为status 。
QHttpServerResponse::QHttpServerResponse(const QByteArray &mimeType, QByteArray &&data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
QHttpServerResponse::QHttpServerResponse(const QByteArray &mimeType, const QByteArray &data, QHttpServerResponse::StatusCode status = StatusCode::Ok)
生成一个QHttpServer 响应。
该响应将使用给定的status 状态码，并返回data 作为其正文，同时包含一个ContentType 标头，将其描述为MIME类型mimeType 。
[noexcept] QHttpServerResponse::QHttpServerResponse(QHttpServerResponse &&other)
从other 移动构造一个新的 QHttpServerResponse。
[noexcept] QHttpServerResponse::~QHttpServerResponse()
销毁一个 `QHttpServerResponse ` 对象。
QByteArray QHttpServerResponse::data() const
返回响应正文。
[static] QHttpServerResponse QHttpServerResponse::fromFile(const QString &fileName)
根据文件fileName 的内容返回一个 `QHttpServerResponse ` 对象。
调用方有责任对文件名进行有效性检查，并制定明确的策略来规定服务器将请求哪些文件。
[since 6.8] QHttpHeaders QHttpServerResponse::headers() const
返回当前设置的 HTTP 头。
该函数于 Qt 6.8 中引入。
另请参阅 setHeaders()。
QByteArray QHttpServerResponse::mimeType() const
返回 HTTP"Content-Type" 标头的值。
注意：默认 值为"text/html" 。
[since 6.8] void QHttpServerResponse::setHeaders(QHttpHeaders &&newHeaders)
将newHeaders 设置为HTTP头，并覆盖之前设置的任何头。
该函数于 Qt 6.8 版本中引入。
另请参阅 headers()。
[since 6.8] void QHttpServerResponse::setHeaders(const QHttpHeaders &newHeaders)
这是一个重载函数。
该函数在 Qt 6.8 中引入。
QHttpServerResponse::StatusCode QHttpServerResponse::statusCode() const
返回状态码。
[noexcept] void QHttpServerResponse::swap(QHttpServerResponse &other)
将此链接QHttpServerResponse 替换为other 。此操作非常快速，且从未失败。
[noexcept] QHttpServerResponse &QHttpServerResponse::operator=(QHttpServerResponse &&other)
将 `other ` 通过 `move-assign` 赋值给此 `QHttpServerResponse ` 实例。
© 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.
