Класс QMqttPublishProperties
Класс QMqttPublishProperties представляет параметры конфигурации для отправки или получения сообщения. Подробнее...
| Заголовок: | #include <QMqttPublishProperties> |
| qmake: | QT += mqtt |
| С момента: | Qt 5.12 |
Типы публичного интерфейса
| Перечисление | PublishPropertyDetail { None, PayloadFormatIndicator, MessageExpiryInterval, TopicAlias, ResponseTopic, …, ContentType } |
| Флаги | PublishPropertyDetails |
Функции публичного интерфейса
| QMqttPublishProperties::PublishPropertyDetails | availableProperties() const |
| QString | contentType() const |
| QByteArray | correlationData() const |
| quint32 | messageExpiryInterval() const |
| QMqtt::PayloadFormatIndicator | payloadFormatIndicator() const |
| QString | responseTopic() const |
| void | setContentType(const QString &type) |
| void | setCorrelationData(const QByteArray &correlation) |
| void | setMessageExpiryInterval(quint32 interval) |
| void | setPayloadFormatIndicator(QMqtt::PayloadFormatIndicator indicator) |
| void | setResponseTopic(const QString &topic) |
| void | setSubscriptionIdentifiers(const QList<quint32> &ids) |
| void | setTopicAlias(quint16 alias) |
| void | setUserProperties(const QMqttUserProperties &properties) |
| QList<quint32> | subscriptionIdentifiers() const |
| quint16 | topicAlias() const |
| QMqttUserProperties | userProperties() const |
Подробное описание
Вызов QMqttClient::publish() для отправки сообщения на брокер может включать QMqttPublishProperties для предоставления дополнительных аргументов о том, как сообщение должно обрабатываться на брокером.
Кроме того, получение сообщения подписчиком может содержать свойства публикации, которые были перенаправлены или адаптированы сервером.
Примечание: Свойства публикации являются частью спецификации MQTT 5.0 и не могут быть использованы при подключении к более низкому уровню протокола. Подробнее см. QMqttClient::ProtocolVersion.
Документация по типам членов
Перечисление QMqttPublishProperties::PublishPropertyDetailФлаги QMqttPublishProperties::PublishPropertyDetails
Этот тип перечисления определяет доступные свойства, задаваемые сервером или клиентом при создании сообщения.
| Константа | Значение | Описание |
|---|---|---|
QMqttPublishProperties::None |
0x00000000 |
Свойство не задано. |
QMqttPublishProperties::PayloadFormatIndicator |
0x00000001 |
Тип содержимого сообщения. |
QMqttPublishProperties::MessageExpiryInterval |
0x00000002 |
Срок действия сообщения. |
QMqttPublishProperties::TopicAlias |
0x00000004 |
Псевдоним темы для этого сообщения. |
QMqttPublishProperties::ResponseTopic |
0x00000008 |
Тема, по которой получатель должен ответить. |
QMqttPublishProperties::CorrelationData |
0x00000010 |
Идентификатор ответного сообщения. |
QMqttPublishProperties::UserProperty |
0x00000020 |
Дополнительные свойства, заданные пользователем. |
QMqttPublishProperties::SubscriptionIdentifier |
0x00000040 |
Идентификаторы подписок, соответствующие публикации. |
QMqttPublishProperties::ContentType |
0x00000080 |
Описание содержимого сообщения. |
Тип PublishPropertyDetails является псевдонимом для QFlags<PublishPropertyDetail>. Он хранит логическое ИЛИ комбинацию значений PublishPropertyDetail.
Документация по функциям-членам
QMqttPublishProperties::PublishPropertyDetails QMqttPublishProperties::availableProperties() const
Возвращает доступные свойства, указанные в этом экземпляре. При создании сообщения не требуется включать все свойства. Эта функция служит показателем тех свойств, которые были явно заданы.
QString QMqttPublishProperties::contentType() const
Возвращает тип содержимого сообщения.
См. также setContentType().
QByteArray QMqttPublishProperties::correlationData() const
Возвращает данные корреляции.
См. также setCorrelationData().
quint32 QMqttPublishProperties::messageExpiryInterval() const
Возвращает интервал срока действия сообщения. Это значение указывает количество секунд, в течение которого серверу разрешается пересылать сообщение. Если интервал истекает, сервер должен удалить сообщение и прервать публикацию.
См. также setMessageExpiryInterval().
QMqtt::PayloadFormatIndicator QMqttPublishProperties::payloadFormatIndicator() const
Возвращает индикатор формата полезной нагрузки.
См. также setPayloadFormatIndicator().
QString QMqttPublishProperties::responseTopic() const
Возвращает тему ответа, которую пользователь должен использовать в качестве продолжения запроса.
См. также setResponseTopic().
void QMqttPublishProperties::setContentType(const QString &type)
Устанавливает тип содержимого сообщения на type.
См. также contentType().
void QMqttPublishProperties::setCorrelationData(const QByteArray &correlation)
Устанавливает данные корреляции на correlation.
См. также correlationData().
void QMqttPublishProperties::setMessageExpiryInterval(quint32 interval)
Устанавливает интервал срока действия сообщения на interval.
См. также messageExpiryInterval().
void QMqttPublishProperties::setPayloadFormatIndicator(QMqtt::PayloadFormatIndicator indicator)
Устанавливает индикатор формата полезной нагрузки на indicator.
См. также payloadFormatIndicator().
void QMqttPublishProperties::setResponseTopic(const QString &topic)
Устанавливает ответный топик на topic.
См. также responseTopic().
void QMqttPublishProperties::setSubscriptionIdentifiers(const QList<quint32> &ids)
Устанавливает идентификаторы подписок на ids.
См. также subscriptionIdentifiers().
void QMqttPublishProperties::setTopicAlias(quint16 alias)
Устанавливает псевдоним топика для публикации сообщения на alias. Значение псевдонима топика должно быть больше нуля и меньше максимального значения псевдонима топика, указанного сервером.
См. также topicAlias() и QMqttServerConnectionProperties::maximumTopicAlias().
void QMqttPublishProperties::setUserProperties(const QMqttUserProperties &properties)
Устанавливает пользовательские свойства сообщения на properties.
См. также userProperties().
QList<quint32> QMqttPublishProperties::subscriptionIdentifiers() const
Возвращает идентификаторы подписок, соответствующие фильтру топика сообщения.
См. также setSubscriptionIdentifiers().
quint16 QMqttPublishProperties::topicAlias() const
Возвращает псевдоним топика, используемый для публикации сообщения.
См. также setTopicAlias().
QMqttUserProperties QMqttPublishProperties::userProperties() const
Возвращает пользовательские свойства сообщения.
См. также setUserProperties().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qmqttpublishproperties.html