QHttpServerResponder Class
API para enviar respuestas desde un servidor HTTP. Más...
| Cabecera: | #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 escribir de vuelta a un cliente HTTP con sobrecargas para serializar objetos JSON. También tiene soporte para escribir cabeceras HTTP y código de estado.
Documentación de 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 la función miembro
[noexcept] QHttpServerResponder::QHttpServerResponder(QHttpServerResponder &&other)
Move-construye 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 posibilitar la salida anticipada del manejador 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 un mensaje HTTP response al cliente.
Esta función se introdujo en Qt 6.5.
[noexcept, since 6.8] void QHttpServerResponder::swap(QHttpServerResponder &other)
Intercambia QHttpServerResponder other con 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 petición 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 petición con un código de estado HTTP status y cabeceras HTTP headers.
void QHttpServerResponder::write(const QJsonDocument &document, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una petición 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 petición 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 en trozos: en caso contrario, la función asume que todo el contenido está disponible y lo envía de una vez, pero la lectura se realiza en trozos.
Nota: Esta función toma la propiedad de data.
void QHttpServerResponder::write(QIODevice *data, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una petición con un código de estado HTTP status y cabeceras 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 en trozos: en caso contrario, la función asume que todo el contenido está disponible y lo envía de una vez, pero la lectura se realiza en trozos.
Nota: Esta función toma la propiedad de data.
void QHttpServerResponder::write(const QByteArray &data, const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una petición 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 petición con un código de estado HTTP status, cabeceras HTTP headers y un cuerpo data.
Nota: Esta función establece la cabecera HTTP Content-Length.
void QHttpServerResponder::write(const QJsonDocument &document, const QHttpHeaders &headers, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Responde a una petición con un código de estado HTTP status, un documento JSON document y cabeceras HTTP headers.
Nota: Esta función establece la cabecera HTTP Content-Type como "application/json".
[since 6.8] void QHttpServerResponder::writeBeginChunked(const QByteArray &mimeType, QHttpServerResponder::StatusCode status = StatusCode::Ok)
Inicia el envío de trozos de datos con el tipo mime mimeType y y el código de estado dado status. Esta llamada debe ir seguida de un número arbitrario de llamadas repetidas a writeChunk y 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)
Inicia el envío de trozos de datos con headers y y el código de estado status. Esta llamada debe ir seguida de un número arbitrario de llamadas repetidas a writeChunk y 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)
Comienza a enviar trozos de datos con headers y y el código de estado dado status. Esta llamada debe ir seguida de un número arbitrario de llamadas repetidas a writeChunk y y una única llamada a writeEndChunked con los mismos trailers dados 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)
Escribe data de vuelta al cliente. Debe llamarse cuando hay datos disponibles para escribir. Esto puede ser llamado varias veces, pero antes de llamar a este writeBeginChunked debe ser llamado, y después writeEndChunked debe ser llamado.
Esta función fue introducida en Qt 6.8.
Ver también writeBeginChunked y writeEndChunked.
[since 6.8] void QHttpServerResponder::writeEndChunked(const QByteArray &data)
Escribe data de vuelta al cliente. Debe ir precedida 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)
Escribe data de vuelta al cliente con 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.