QHttpServerResponder Class
API para enviar respuestas desde un servidor HTTP. Más información...
| Encabezado: | #include <QHttpServerResponder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS HttpServer) target_link_libraries(mytarget PRIVATE Qt6::HttpServer) |
| qmake: | QT += httpserver |
| Desde: | Qt 6.4 |
Tipos públicos
| enum class | StatusCode { Continue, SwitchingProtocols, Processing, Ok, Created, …, NetworkConnectTimeoutError } |
Funciones públicas
| QHttpServerResponder(QHttpServerResponder &&other) | |
| ~QHttpServerResponder() | |
(since 6.11) bool | isResponseCanceled() const |
(since 6.5) void | sendResponse(const QHttpServerResponse &response) |
(since 6.8) void | swap(QHttpServerResponder &other) |
| void | write(QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QJsonDocument &document, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(QIODevice *data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QByteArray &data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QByteArray &data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
| void | write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeBeginChunked(const QHttpHeaders &headers, QList<QHttpHeaders::WellKnownHeader> trailers, QHttpServerResponder::StatusCode status = StatusCode::Ok) |
(since 6.8) void | writeChunk(const QByteArray &data) |
(since 6.8) void | writeEndChunked(const QByteArray &data) |
(since 6.8) void | writeEndChunked(const QByteArray &data, const QHttpHeaders &trailers) |
Descripción detallada
Proporciona funciones para enviar respuestas a un cliente HTTP con sobrecargas para serializar objetos JSON. También admite el envío de encabezados HTTP y códigos de estado.
Documentación sobre los tipos de miembros
enum class QHttpServerResponder::StatusCode
Códigos de estado HTTP
| Constante | Valor |
|---|---|
QHttpServerResponder::StatusCode::Continue | 100 |
QHttpServerResponder::StatusCode::SwitchingProtocols | 101 |
QHttpServerResponder::StatusCode::Processing | 102 |
QHttpServerResponder::StatusCode::Ok | 200 |
QHttpServerResponder::StatusCode::Created | 201 |
QHttpServerResponder::StatusCode::Accepted | 202 |
QHttpServerResponder::StatusCode::NonAuthoritativeInformation | 203 |
QHttpServerResponder::StatusCode::NoContent | 204 |
QHttpServerResponder::StatusCode::ResetContent | 205 |
QHttpServerResponder::StatusCode::PartialContent | 206 |
QHttpServerResponder::StatusCode::MultiStatus | 207 |
QHttpServerResponder::StatusCode::AlreadyReported | 208 |
QHttpServerResponder::StatusCode::IMUsed | 226 |
QHttpServerResponder::StatusCode::MultipleChoices | 300 |
QHttpServerResponder::StatusCode::MovedPermanently | 301 |
QHttpServerResponder::StatusCode::Found | 302 |
QHttpServerResponder::StatusCode::SeeOther | 303 |
QHttpServerResponder::StatusCode::NotModified | 304 |
QHttpServerResponder::StatusCode::UseProxy | 305 |
QHttpServerResponder::StatusCode::TemporaryRedirect | 307 |
QHttpServerResponder::StatusCode::PermanentRedirect | 308 |
QHttpServerResponder::StatusCode::BadRequest | 400 |
QHttpServerResponder::StatusCode::Unauthorized | 401 |
QHttpServerResponder::StatusCode::PaymentRequired | 402 |
QHttpServerResponder::StatusCode::Forbidden | 403 |
QHttpServerResponder::StatusCode::NotFound | 404 |
QHttpServerResponder::StatusCode::MethodNotAllowed | 405 |
QHttpServerResponder::StatusCode::NotAcceptable | 406 |
QHttpServerResponder::StatusCode::ProxyAuthenticationRequired | 407 |
QHttpServerResponder::StatusCode::RequestTimeout | 408 |
QHttpServerResponder::StatusCode::Conflict | 409 |
QHttpServerResponder::StatusCode::Gone | 410 |
QHttpServerResponder::StatusCode::LengthRequired | 411 |
QHttpServerResponder::StatusCode::PreconditionFailed | 412 |
QHttpServerResponder::StatusCode::PayloadTooLarge | 413 |
QHttpServerResponder::StatusCode::UriTooLong | 414 |
QHttpServerResponder::StatusCode::UnsupportedMediaType | 415 |
QHttpServerResponder::StatusCode::RequestRangeNotSatisfiable | 416 |
QHttpServerResponder::StatusCode::ExpectationFailed | 417 |
QHttpServerResponder::StatusCode::ImATeapot | 418 |
QHttpServerResponder::StatusCode::MisdirectedRequest | 421 |
QHttpServerResponder::StatusCode::UnprocessableEntity | 422 |
QHttpServerResponder::StatusCode::Locked | 423 |
QHttpServerResponder::StatusCode::FailedDependency | 424 |
QHttpServerResponder::StatusCode::UpgradeRequired | 426 |
QHttpServerResponder::StatusCode::PreconditionRequired | 428 |
QHttpServerResponder::StatusCode::TooManyRequests | 429 |
QHttpServerResponder::StatusCode::RequestHeaderFieldsTooLarge | 431 |
QHttpServerResponder::StatusCode::UnavailableForLegalReasons | 451 |
QHttpServerResponder::StatusCode::InternalServerError | 500 |
QHttpServerResponder::StatusCode::NotImplemented | 501 |
QHttpServerResponder::StatusCode::BadGateway | 502 |
QHttpServerResponder::StatusCode::ServiceUnavailable | 503 |
QHttpServerResponder::StatusCode::GatewayTimeout | 504 |
QHttpServerResponder::StatusCode::HttpVersionNotSupported | 505 |
QHttpServerResponder::StatusCode::VariantAlsoNegotiates | 506 |
QHttpServerResponder::StatusCode::InsufficientStorage | 507 |
QHttpServerResponder::StatusCode::LoopDetected | 508 |
QHttpServerResponder::StatusCode::NotExtended | 510 |
QHttpServerResponder::StatusCode::NetworkAuthenticationRequired | 511 |
QHttpServerResponder::StatusCode::NetworkConnectTimeoutError | 599 |
Documentación de funciones de miembro
[noexcept] QHttpServerResponder::QHttpServerResponder(QHttpServerResponder &&other)
Crea una instancia de `QHttpServerResponder`, haciendo que apunte al mismo objeto al que apuntaba ` other `.
[noexcept] QHttpServerResponder::~QHttpServerResponder()
Destruye un « QHttpServerResponder ».
[since 6.11] bool QHttpServerResponder::isResponseCanceled() const
Devuelve «true» si el cliente ha cancelado la respuesta. Se utiliza para permitir salir anticipadamente del controlador cuando se cancela la respuesta.
Esta función se introdujo en Qt 6.11.
[since 6.5] void QHttpServerResponder::sendResponse(const QHttpServerResponse &response)
Envía una solicitud HTTP de tipo « response » al cliente.
Esta función se introdujo en Qt 6.5.
[noexcept, since 6.8] void QHttpServerResponder::swap(QHttpServerResponder &other)
Cambia QHttpServerResponder other por este QHttpServerResponder. Esta operación es muy rápida y nunca falla.
Esta función se introdujo en Qt 6.8.
void QHttpServerResponder::write(QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP « status ».
Nota: Esta función establece el encabezado HTTP «Content-Type» como « "application/x-empty" ».
void QHttpServerResponder::write(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status y encabezados HTTP headers.
void QHttpServerResponder::write(const QJsonDocument &document, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP « status » y un documento JSON « document ».
Nota: Esta función establece el encabezado HTTP «Content-Type» como "application/json".
void QHttpServerResponder::write(QIODevice *data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status y un tipo MIME mimeType. El dispositivo de E/S data proporciona el cuerpo de la respuesta. Si data es secuencial, el cuerpo del mensaje se envía por fragmentos; en caso contrario, la función asume que todo el contenido está disponible y lo envía de una sola vez, aunque la lectura se realiza por fragmentos.
Nota: Esta función asume la propiedad de data.
void QHttpServerResponder::write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status y los encabezados HTTP headers. El dispositivo de E/S data proporciona el cuerpo de la respuesta. Si data es secuencial, el cuerpo del mensaje se envía por fragmentos; en caso contrario, la función asume que todo el contenido está disponible y lo envía de una sola vez, aunque la lectura se realiza por fragmentos.
Nota: Esta función asume la propiedad de data.
void QHttpServerResponder::write(const QByteArray &data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status, un tipo MIME mimeType y un cuerpo data.
void QHttpServerResponder::write(const QByteArray &data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status, encabezados HTTP headers y un cuerpo data.
Nota: Esta función establece el encabezado HTTP «Content-Length».
void QHttpServerResponder::write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una solicitud con un código de estado HTTP status, un documento JSON document y encabezados HTTP headers.
Nota: Esta función establece el encabezado HTTP «Content-Type» como "application/json".
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Empieza a enviar bloques de datos con el tipo MIME mimeType y el código de estado indicado status. A esta llamada debe seguirle un número arbitrario de llamadas repetidas a writeChunk y una única llamada a writeEndChunked.
Esta función se introdujo en Qt 6.8.
Véase también writeChunk y writeEndChunked.
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Empieza a enviar bloques de datos con ` headers ` y el código de estado ` status`. A esta llamada debe seguirle un número arbitrario de llamadas repetidas a ` writeChunk ` y una única llamada a ` writeEndChunked`.
Esta función se introdujo en Qt 6.8.
Véase también writeChunk y writeEndChunked.
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QHttpHeaders &headers, QList<QHttpHeaders::WellKnownHeader> trailers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Empieza a enviar fragmentos de datos con headers y el código de estado indicado en status. A esta llamada debe seguirle un número arbitrario de repeticiones de la llamada writeChunk y una única llamada a writeEndChunked con los mismos «trailers» indicados en trailers.
Esta función se introdujo en Qt 6.8.
Véase también writeChunk y writeEndChunked.
[since 6.8] void QHttpServerResponder::writeChunk(const QByteArray &data)
Envía « data » al cliente. Se invoca cuando hay datos disponibles para escribir. Se puede invocar varias veces, pero antes de hacerlo hay que llamar a « writeBeginChunked » y, después, a « writeEndChunked ».
Esta función se introdujo en Qt 6.8.
Véase también writeBeginChunked y writeEndChunked.
[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data)
Envía un ` data ` al cliente. Debe ir precedido de una llamada a ` writeBeginChunked`.
Esta función se introdujo en Qt 6.8.
Véase también writeBeginChunked y writeChunk.
[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data, const QHttpHeaders &trailers)
Envía un « data » al cliente utilizando el « trailers » anunciado en writeBeginChunked.
Esta función se introdujo en Qt 6.8.
Véase también writeBeginChunked y writeChunk.
© 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.