QRestReply 类

成员函数文档

[显式] QRestReply::QRestReply(QNetworkReply *reply)

创建一个QRestReply并初始化包装的QNetworkReply为reply。

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

从other移动构造reply。

[noexcept] QRestReply::~QRestReply()

销毁此QRestReply对象。

QNetworkReply::NetworkError QRestReply::error() const

返回最后的错误，如果有。错误包括网络和协议错误，但不包括服务器成功以HTTP状态响应的情况。

另请参阅 httpStatus()、isSuccess()、hasError()和errorString()。

QString QRestReply::errorString() const

返回最后网络错误的文本描述。

另请参阅 httpStatus()、isSuccess()、hasError()和error()。

bool QRestReply::hasError() const

返回是否发生错误。这包括网络和协议错误，但不包括服务器成功以HTTP错误状态响应的情况（例如500 Internal Server Error）。使用httpStatus()或isHttpStatusSuccess()来获取HTTP状态信息。

另请参阅 httpStatus()、isSuccess()、error()和errorString()。

int QRestReply::httpStatus() const

返回服务器响应中的HTTP状态。如果不可用（尚未接收到状态行），值是0。

另请参阅 isSuccess()、hasError()和error()。

bool QRestReply::isHttpStatusSuccess() const

返回HTTP状态是否在200..299之间。

另请参阅 isSuccess()、httpStatus()、hasError()和error()。

bool QRestReply::isSuccess() const

返回HTTP状态码是否在200..299之间，并且在接收响应的过程中没有发生进一步错误（例如，接收主体数据时的突然断开）。此函数是一种方便的方式来检查响应是否被认为成功。

另请参阅 httpStatus()，hasError()，和error()。

QNetworkReply *QRestReply::networkReply() const

返回一个指向由此对象封装的底层数据QNetworkReply的指针。

QByteArray QRestReply::readBody()

以QByteArray 形式返回接收到的数据。

调用此函数会消耗到目前为止接收到的数据，并且在此之后进一步的请求将返回空数据，直到有新的数据接收。

另请参阅 readJson()，readText()，QNetworkReply::bytesAvailable()和QNetworkReply::readyRead()。

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

将接收到的数据返回为QJsonDocument。

返回值封装在std::optional中。如果从接收到的数据中转换失败（数据为空或JSON解析错误），则返回std::nullopt，并且error将被填充详细信息。

调用此函数会消耗接收到的数据，并且在此之后进一步的请求将返回空数据。

如果没有完成回复，此函数返回std::nullopt并不会消耗任何数据。如果传递error，它将被设置为QJsonParseError::NoError以区分这种情况和实际错误。

另请参阅 readBody()和readText()。

QString QRestReply::readText()

以QString 形式返回接收到的数据。

接收到的数据被解码成QString (UTF-16)。如果可用，解码使用Content-Type头部的charset参数来确定源编码。如果编码信息不可用或不被QStringConverter支持，则默认使用UTF-8。

调用此函数会消耗到目前为止接收到的数据。如果没有新的数据可用，或者解码不被QStringConverter支持，或者解码出现错误（例如无效字符），则返回默认构造的值。

另请参阅 readJson()，readBody()，和QNetworkReply::readyRead()。

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

移动赋值other并返回对此次回复的引用。