Contents

QCoapReply

class QCoapReply

The QCoapReply class holds the data of a CoAP reply.

Header: QCoapReply
CMake: find_package(Qt6 REQUIRED COMPONENTS Coap)
target_link_libraries(mytarget PRIVATE Qt6::Coap)
qmake: QT += coap
Inherited By: QCoapResourceDiscoveryReply

Public Functions

virtual ~QCoapReply() override
void abortRequest()
QtCoap::Error errorReceived() const
bool isAborted() const
bool isFinished() const
bool isRunning() const
bool isSuccessful() const
QCoapMessage message() const
QtCoap::Method method() const
QCoapRequest request() const
QtCoap::ResponseCode responseCode() const
QUrl url() const

Signals

void aborted(const QCoapToken &token)
void error(QCoapReply *reply, QtCoap::Error error)
void finished(QCoapReply *reply)
void notified(QCoapReply *reply, const QCoapMessage &message)

Detailed Description

The QCoapReply contains data related to a request sent with the QCoapClient.

The finished() signal is emitted when the response is fully received or when the request fails.

For Observe requests specifically, the notified() signal is emitted whenever a notification is received.

Member Function Documentation

[override virtual noexcept] QCoapReply::~QCoapReply()

Destroys the QCoapReply and aborts the request if its response has not yet been received.

void QCoapReply::abortRequest()

Aborts the request immediately and emits the aborted(const QCoapToken &token) signal if the request was not finished.

[signal] void QCoapReply::aborted(const QCoapToken &token)

This signal is emitted when the request is aborted or the reply is deleted. Its token parameter is the token of the exchange that has been aborted.

See also finished() and error().

[signal] void QCoapReply::error(QCoapReply *reply, QtCoap::Error error)

This signal is emitted whenever an error occurs and is followed by the finished() signal.

Its reply parameters is the QCoapReply itself for convenience, and the error parameter is the error received.

See also finished() and aborted().

QtCoap::Error QCoapReply::errorReceived() const

Returns the error of the reply or QCoapReply::NoError if there is no error.

[signal] void QCoapReply::finished(QCoapReply *reply)

This signal is emitted whenever the corresponding request finished, whether successfully or not. When a resource is observed, this signal will only be emitted once, when the observation ends.

The reply parameter is the QCoapReply itself for convenience.

See also QCoapClient::finished(), isFinished(), notified(), and aborted().

bool QCoapReply::isAborted() const

Returns true if the request has been aborted.

bool QCoapReply::isFinished() const

Returns true if the request is finished.

See also finished().

bool QCoapReply::isRunning() const

Returns true if the request is running.

bool QCoapReply::isSuccessful() const

Returns true if the request finished with no error.

QCoapMessage QCoapReply::message() const

Returns the contained message.

QtCoap::Method QCoapReply::method() const

Returns the method of the associated request.

[signal] void QCoapReply::notified(QCoapReply *reply, const QCoapMessage &message)

This signal is emitted whenever a notification is received from an observed resource.

Its message parameter is a QCoapMessage containing the payload and the message details. The reply parameter is the QCoapReply itself for convenience.

See also QCoapClient::finished(), isFinished(), finished(), and notified().

QCoapRequest QCoapReply::request() const

Returns the associated request.

QtCoap::ResponseCode QCoapReply::responseCode() const

Returns the response code of the request.

QUrl QCoapReply::url() const

Returns the target uri of the associated request.