极简代码,搞定JSON序列化与反序列化

环贸财神 2026-02-24 4032人围观

JSONJavaScript Object Notation)是一种轻量级的数据交换格式,易于人类阅读和编写,同时也易于机器解析和生成。LuatOS提供了json核心库——无需额外依赖,即可快速实现JSON数据的生成(序列化)与解析(反序列化)。

目前json库已全面支持LuatOS开发系列产品,开发者可根据项目实际需求,灵活选用并进行快速集成与开发。

一、JSON基础要点

在LuatOS开发中,使用以下两个函数高效处理JSON数据。

1.1 两个关键函数

1)json.encode(obj,t)

功能是将Lua对象序列化为符合JSON格式的字符串。

注意事项:

obj参数仅支持字符串、数字、布尔值、表、nil类型作为输入,不支持函数、用户数据、线程和非空轻量级用户数据。

序列化成功示例:

wKgZPGmcWI6AYxIQAAMaL_-_hz8829.png

序列化失败示例:

2)json.decode(str)

功能是将符合JSON格式的字符串反序列化为Lua对象。

注意事项:

输入字符串必须是合法的JSON文本,否则会解析失败;成功时返回反序列化结果和状态码1,失败时返回nil、状态码false和错误信息。

反序列化成功示例:

wKgZPGmcWL6ABElmAAN_DLsvKQE423.png

反序列化失败示例:

1.2 JSON常用场景

JSON因其简洁、通用且灵活的特性,被广泛应用于配置文件、网络通信和数据存储等场景。

1)配置文件:

用于应用程序的配置设置。许多工具和框架都直接使用.json文件来管理配置,因为它结构清晰、易于编辑。

2)网络通信:

用于客户端与服务器之间的数据交换。在前后端分离的开发中,JSON是API接口请求和响应的标准数据格式。

3)数据存储:

用于存储简单的数据结构。对于一些结构简单的数据,直接将其存储为JSON文件,或在数据库中使用JSON类型字段,都是非常方便的做法。

二、JSON应用示例demo

丰富的应用示例与实操教程,系统演示JSON序列化与反序列化的各项功能,帮助开发者快速上手。

Air780EGH核心板为例:

wKgZPGmcWdWAT_s7ABgzHmU0f2o291.png

2.1 序列化示例

将Lua对象转为JSON字符串,涵盖以下核心要点:

示例一:Lua string转为JSON string;

示例二:Lua number转为JSON string;

示例三:Lua boolean转为JSON string;

示例四:Lua table转为JSON string;

示例五:Lua nil转为JSON string;

序列化失败示例和指定浮点数示例。

核心代码如下图示,完整demo详见源码仓库最新文件:

wKgZPGmcWS6AI9cpAAmJ8EO051U911.png

2.2 反序列化示例

将JSON字符串转为Lua对象,涵盖以下核心要点:

示例一:JSON string转为Lua string;

示例二:JSON number转为Lua number;

示例三:JSON boolean转为Lua boolean;

示例四:JSON table转为Lua table;

示例五:JSON nil转为Lua nil;

反序列化失败示例;

空表(empty table)转换为JSON时的说明;

字符串中包含控制字符(如 rn)的JSON序列化与反序列化说明;

json.null 的语义与比较行为说明。

核心代码如下图示,完整demo详见源码仓库最新文件:

wKgZO2mcWVyAOYaGAAlXFTDSyzA323.png

今天的内容就分享到这里了

审核编辑 黄宇

Powered By Z-BlogPHP