MQTTX 1.10.0 发布：CLI 高级文件管理与配置功能升级

MQTTX 1.10.0 版本现已发布！
在本次更新中，CLI 版本在文件管理和配置功能方面进行了显著增强。主要更新包括：支持从文件中读取和写入消息、高级配置选项、文本输出模式、以及改进的日志记录。此外，桌面版本现在支持数据库重建，以防止文件损坏引起的问题，并且能更好地处理大数据的展示。这些更新希望为所有 MQTTX 用户提供更加强大和用户友好的体验。

下载最新版本：https://mqttx.app/zh/downloads

MQTTX 1.10.0 在 CLI 中引入了强大的文件读写功能。此功能可以无缝处理文件输入和输出的消息负载，从而在数据工作流中提供集成和自动化。

文件读取

注意：由于 MQTT 协议的限制，消息的载荷大小不得超过 256MB。在传输前，请验证你的 MQTT broker 的载荷大小限制。

使用 pub
 命令

使用以下命令从文件读取消息：

mqttx pub -t topic --file-read path/to/file

 --file-read
选项允许你直接从文件读取内容作为发布的载荷。这对于使用预定义的测试数据进行各种发布场景非常方便。

使用 bench pub
 命令

 --file-read
 命令从文件中读取消息体，类似于简单的 pub
  命令：

mqttx bench pub -c 10 -t topic --file-read path/to/file

利用 bench
 命令的内置强大功能，您可以通过使用 --split
 选项将文件内容分割到单独的消息中，以便发送不同的数据段。默认字符是 \n
。

例如，有一个包含以下内容的文件：

hello
world

您可以使用：

mqttx bench pub -c 10 -t topic --file-read path/to/file --split

如果文件是用逗号分隔的，将 --split
 改为 ,
：

mqttx bench pub -c 10 -t topic --file-read path/to/file --split ','

最后还可以设置 -im
 来定义发布消息的时间间隔。

文件写入

如果要将收到的消息写入到文件中，可以使用以下命令：

mqttx sub -t topic --file-write path/to/file

--file-write
 选项会将每条消息追加到文件中，每条消息默认使用换行符 \n
分隔，这非常适合用于日志记录或累积文本数据。对于需要维持连续接收消息日志的应用程序来说，这个功能非常方便。

如果要更改分隔符，可以使用  --delimiter
 选项。例如：

mqttx sub -t topic --file-write path/to/file --delimiter ','

文件保存

若要将每条单独的消息保存为一份单独的文件，请使用：

mqttx sub -t topic --file-save path/to/file

--file-save
 选项将每条传入的消息保存为一个单独的文件。已有的文件将自动重新编号并保存，以防止覆盖。此功能对于需要存储单个消息以进行进一步处理或分析的应用程序非常方便。

例如，要将传入的消息保存到指定的目录：

mqttx sub -t topic --file-save path/to/directory/message.txt

如果 /path/to/directory/message.txt
 已经存在，新的消息将被保存为  message(1).txt
  、  message(2).txt
 等。这样可以防止由于覆盖现有文件而导致的任何数据丢失。

请勿同时使用 --file-write 和 --file-save。

类型格式

文件传输也支持指定对应的文件格式来格式化消息。如果未指定，默认为纯文本（UTF-8）格式。可以使用 --format
 选项对消息内容进行格式化以处理不同的数据格式：

mqttx pub -t topic --file-read path/to/file --format type
mqttx sub -t topic --file-save path/to/file --format type

支持输出到文件的数据格式包括 JSON
， base64
， hex
， binary
 和 cbor
。

为此，该版本还引入了一个新的 binary
 格式来处理更常见的文件传输场景。通过指定二进制格式，MQTTX 收发时将处理和生成相应的二进制文件。

如果文件有以下扩展名，它将自动识别文件格式为二进制：

mqttx pub -t topic --file-read path/to/file --format binary
mqttx sub -t topic --file-save path/to/file --format binary

mqttx init
? Select MQTTX CLI output mode Text
? Enter the default MQTT broker host broker.emqx.io
? Enter the default MQTT port 1883
? Enter the maximum reconnect times for MQTT connection 5
? Enter the default username for MQTT connection authentication admin
? Enter the default password for MQTT connection authentication ******
Configuration file created/updated at Users/.mqttx-cli/config

[default]
output = text
[mqtt]
host = broker.emqx.io
port = 1883
max_reconnect_times = 5
username = admin
password = public

mqttx conn
✔ Connected

mqttx conn
[5/24/2024] [11:26:17 AM] › …  Connecting...
[5/24/2024] [11:26:17 AM] › ✔  Connected