En esta página

QRestReply Class

QRestReply es una herramienta de uso sencillo que sirve de envoltura para QNetworkReply. Más...

Encabezado: #include <QRestReply>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Desde: Qt 6.7

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QRestReply(QNetworkReply *reply)
QRestReply(QRestReply &&other)
~QRestReply()
QNetworkReply::NetworkError error() const
QString errorString() const
bool hasError() const
int httpStatus() const
bool isHttpStatusSuccess() const
bool isSuccess() const
QNetworkReply *networkReply() const
QByteArray readBody()
std::optional<QJsonDocument> readJson(QJsonParseError *error = nullptr)
QString readText()
QRestReply &operator=(QRestReply &&other)
QDebug operator<<(QDebug debug, const QRestReply &reply)

Descripción detallada

QRestReply envuelve un objeto ` QNetworkReply ` y proporciona métodos prácticos para la gestión de datos y del estado. Estos métodos facilitan el trabajo a las aplicaciones cliente RESTful típicas.

QRestReply no asume la propiedad del objeto ` QNetworkReply` encapsulado, y el ciclo de vida y la propiedad de la respuesta se rigen por lo definido en la documentación de « QNetworkAccessManager ».

El objeto QRestReply no se puede copiar, pero sí se puede mover.

Véase también QRestAccessManager, QNetworkReply, QNetworkAccessManager y QNetworkAccessManager::setAutoDeleteReplies().

Documentación de las funciones miembro

[explicit] QRestReply::QRestReply(QNetworkReply *reply)

Crea un objeto `QRestReply` e inicializa el objeto ` QNetworkReply ` envuelto con el valor ` reply`.

[noexcept] QRestReply::QRestReply(QRestReply &&other)

Reconstruye la respuesta a partir de other.

Nota: El objeto del que se ha extraído la información, other, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

[noexcept] QRestReply::~QRestReply()

Elimina este objeto de tipo « QRestReply ».

QNetworkReply::NetworkError QRestReply::error() const

Devuelve el último error, si lo hay. Entre los errores se incluyen, por ejemplo, los relacionados con la red y el protocolo, pero se excluyen los casos en los que el servidor ha respondido correctamente con un estado HTTP.

Véanse también httpStatus(), isSuccess(), hasError() y errorString().

QString QRestReply::errorString() const

Devuelve una descripción comprensible para el usuario del último error de red.

Véase también httpStatus(), isSuccess(), hasError() y error().

bool QRestReply::hasError() const

Devuelve si se ha producido un error. Esto incluye errores como los de red y de protocolo, pero excluye los casos en los que el servidor ha respondido correctamente con un código de estado HTTP de error (por ejemplo, 500 Internal Server Error). Utiliza httpStatus() o isHttpStatusSuccess() para obtener la información sobre el estado HTTP.

Véanse también httpStatus(), isSuccess(), error() y errorString().

int QRestReply::httpStatus() const

Devuelve el estado HTTP recibido en la respuesta del servidor. El valor es 0 si no está disponible (aún no se ha recibido la línea de estado).

Nota: El estado HTTP se indica tal y como figura en la respuesta HTTP recibida. Puede producirse un error « error » () tras recibir el estado, por ejemplo, debido a una desconexión de red mientras se recibe una respuesta larga. Estos posibles errores posteriores no quedan reflejados en el estado HTTP indicado.

Véase también isSuccess(), hasError() y error().

bool QRestReply::isHttpStatusSuccess() const

Devuelve si el estado HTTP está comprendido entre 200 y 299.

Véase también isSuccess(), httpStatus(), hasError() y error().

bool QRestReply::isSuccess() const

Devuelve si el estado HTTP está comprendido entre 200 y 299 y no se han producido más errores durante la recepción de la respuesta (por ejemplo, una desconexión repentina mientras se recibían los datos del cuerpo). Esta función es una forma práctica de comprobar si la respuesta se considera satisfactoria.

Véase también httpStatus(), hasError() y error().

QNetworkReply *QRestReply::networkReply() const

Devuelve un puntero al objeto ` QNetworkReply ` subyacente envuelto por este objeto.

QByteArray QRestReply::readBody()

Devuelve los datos recibidos como un objeto « QByteArray ».

Al llamar a esta función se consumen los datos recibidos hasta ese momento, y cualquier llamada posterior para obtener datos de respuesta devolverá un valor vacío hasta que se hayan recibido más datos.

Véanse también readJson(), readText(), QNetworkReply::bytesAvailable() y QNetworkReply::readyRead().

std::optional<QJsonDocument> QRestReply::readJson(QJsonParseError *error = nullptr)

Devuelve los datos recibidos como un objeto ` QJsonDocument`.

El valor devuelto se envuelve en un objeto ` std::optional`. Si falla la conversión de los datos recibidos (datos vacíos o error de análisis de JSON), se devuelve ` std::nullopt ` y se rellena ` error ` con los detalles.

La llamada a esta función consume los datos recibidos, y cualquier llamada posterior para obtener datos de respuesta devolverá un valor vacío.

Esta función devuelve ` std::nullopt ` y no consumirá ningún dato si la respuesta no ha finalizado. Si se pasa ` error `, se establecerá en ` QJsonParseError::NoError ` para distinguir este caso de un error real.

Véanse también readBody() y readText().

QString QRestReply::readText()

Devuelve los datos recibidos como un « QString ».

Los datos recibidos se decodifican en un ` QString ` (UTF-16). Si está disponible, la decodificación utiliza el parámetro `charset` del encabezado `Content-Type` para determinar la codificación de origen. Si la información de codificación no está disponible o no es compatible con ` QStringConverter`, se utiliza UTF-8 de forma predeterminada.

Al llamar a esta función se consumen los datos recibidos hasta ese momento. Devuelve un valor construido por defecto si no hay nuevos datos disponibles, si QStringConverter no admite la decodificación o si la decodificación presenta errores (por ejemplo, caracteres no válidos).

Véanse también readJson(), readBody() y QNetworkReply::readyRead().

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

La operación «move-assign» asigna other y devuelve una referencia a esta respuesta.

Nota: El objeto del que se ha realizado el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.

Elementos no miembros relacionados

QDebug operator<<(QDebug debug, const QRestReply &reply)

Escribe el objeto ` reply ` en el objeto ` debug ` con fines de depuración.

Véase también «Técnicas de depuración».

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