QRestReply Class

Documentación de las funciones miembro

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

Crea un QRestReply e inicializa el QNetworkReply envuelto a reply.

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

Mover-construye la respuesta desde other.

[noexcept] QRestReply::~QRestReply()

Destruye este objeto QRestReply.

QNetworkReply::NetworkError QRestReply::error() const

Devuelve el último error, si lo hay. Los errores incluyen errores como errores de red y de protocolo, pero excluyen los casos en los que el servidor respondió correctamente con un estado HTTP.

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

QString QRestReply::errorString() const

Devuelve una descripción legible por humanos 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 errores de red y de protocolo, pero excluye los casos en los que el servidor ha respondido correctamente con un estado de error HTTP (por ejemplo 500 Internal Server Error). Utilice httpStatus() o isHttpStatusSuccess() para obtener la información de estado HTTP.

Véase 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 (la línea de estado no se ha recibido, todavía).

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

bool QRestReply::isHttpStatusSuccess() const

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

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

bool QRestReply::isSuccess() const

Devuelve si el estado HTTP está entre 200..299 y no se han producido más errores mientras se recibía la respuesta (por ejemplo, desconexión abrupta mientras se recibían los datos del cuerpo). Esta función es una forma cómoda de comprobar si la respuesta se considera correcta.

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

QNetworkReply *QRestReply::networkReply() const

Devuelve un puntero al QNetworkReply subyacente envuelto por este objeto.

QByteArray QRestReply::readBody()

Devuelve los datos recibidos como QByteArray.

Llamar a esta función consume los datos recibidos hasta el momento, y cualquier otra llamada para obtener datos de respuesta devolverá vacío hasta que se hayan recibido más datos.

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

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

Devuelve los datos recibidos como QJsonDocument.

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

La llamada a esta función consume los datos recibidos, y cualquier llamada posterior para obtener datos de respuesta devolverá 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éase también readBody() y readText().

QString QRestReply::readText()

Devuelve los datos recibidos como QString.

Los datos recibidos se descodifican en QString (UTF-16). Si está disponible, la descodificación utiliza el parámetro charset de la cabecera 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 por defecto.

La llamada a esta función consume los datos recibidos hasta el momento. Devuelve un valor construido por defecto si no hay nuevos datos disponibles, o si la decodificación no está soportada por QStringConverter, o si la decodificación tiene errores (por ejemplo caracteres inválidos).

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

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

Move-asigna other y devuelve una referencia a esta respuesta.