标准化你的消息体

标准化你的消息体

KnotLink 支持三种数据格式，你可以根据场景选择。

1. 键值对格式（推荐）

使用 KLKVMap 工具类进行序列化和反序列化。

from knotlink import KLKVMap

# 构建消息
kv = KLKVMap()
kv["action"] = "query"
kv["course"] = "数学"
kv["teacher"] = "张老师"

# 序列化为字符串
message = kv.serialize()  # "action=query;course=数学;teacher=张老师"

# 发送消息
querier.query(message)

# 接收端反序列化
received = KLKVMap()
received.deserialize(message)
print(received.get("action"))  # "query"

2. JSON 格式

适用于更复杂的嵌套数据结构。

import json

# 构建消息
data = {
    "action": "query",
    "course": "数学",
    "teacher": "张老师",
    "students": ["张三", "李四", "王五"]
}

# 序列化为 JSON 字符串
message = json.dumps(data, ensure_ascii=False)

# 接收端解析
received = json.loads(message)
print(received["course"])  # "数学"

3. CLI格式