struct2json <a href="https://github.com/armink/struct2json#%E5%A3%B0%E6%98%8E%E7%BB%93%E6%9E%84%E4%BD%93"></a>声明结构体<a href="https://github.com/armink/struct2json#%E5%B0%86-json-%E5%AF%B9 介绍
struct2json 是一个开源的C结构体与 JSON
快速互转库,它可以快速实现 结构体对象 与 JSON 对象 之间序列化及反序列化要求。快速、简洁的 API 设计,大大降低直接使用 JSON
解析库来实现此类功能的代码复杂度。
起源
把面向对象设计应用到C语言中,是当下很流行的设计思想。由于C语言中没有类,所以一般使用结构体struct
充当类,那么结构体变量就是对象。有了对象之后,很多时候需要考虑对象的序列化及反序列化问题。C语言不像很多高级语言拥有反射等机制,使得对象序列化及反序列化被原生的支持。
对于C语言来说,序列化为 JSON 字符串是个不错的选择,所以就得使用
cJSON 这类 JSON
解析库,但是使用后的代码冗余且逻辑性差,所以萌生对cJSON库进行二次封装,实现一个 struct 与 JSON 之间快速互转的库。 struct2json
就诞生于此。下面是 struct2json 主要使用场景:
- 持久化 :结构体对象序列化为 JSON 对象后,可直接保存至文件、Flash,实现对结构体对象的掉电存储;
- 通信 :高级语言对JSON支持的很友好,例如: Javascript、Groovy 就对 JSON 具有原生的支持,所以 JSON 也可作为C语言与其他语言软件之间的通信协议格式及对象传递格式;
- 可视化 :序列化为 JSON 后的对象,可以更加直观的展示到控制台或者 UI 上,可用于产品调试、产品二次开发等场景;
如何使用
声明结构体
如下声明了两个结构体,结构体 Hometown 是结构体 Student 的子结构体
/* 籍贯 */ typedef struct { char name[16]; } Hometown; /* 学生 */ typedef struct { uint8_t id; uint8_t score[8]; char name[10]; double weight; Hometown hometown; } Student;
将结构体对象序列化为 JSON 对象
使用前([源文件](https://github.com/armink/struct2json/blob/master/docs/zh/assets/not_use_struct2json.c)) | 使用后([源文件](https://github.com/armink/struct2json/blob/master/docs/zh/assets/used_struct2json.c)) |
---|---|
[](https://camo.githubusercontent.com/5321683ad6412bfeb4df52d86734ab402bcef1de/68747470733a2f2f6769742e6f736368696e612e6e65742f41726d696e6b2f737472756374326a736f6e2f7261772f6d61737465722f646f63732f7a682f696d616765732f6e6f745f7573655f737472756374326a736f6e2e706e67)[![](/static/assets/osapp/images/1826b1bbb1b39a88781e39f0dfce2f9e.png)](https://git.oschina.net/Armink/struct2json/raw/master/docs/zh/images/not_use_struct2json.png) | [](https://camo.githubusercontent.com/956928fcabed58d80b56a6e6f25aa3ed2ff0477b/68747470733a2f2f6769742e6f736368696e612e6e65742f41726d696e6b2f737472756374326a736f6e2f7261772f6d61737465722f646f63732f7a682f696d616765732f757365645f737472756374326a736f6e2e706e67)[![](/static/assets/osapp/images/a4c8ad6ef5f014ff97df3986de870a49.png)](https://git.oschina.net/Armink/struct2json/raw/master/docs/zh/images/used_struct2json.png) |
将 JSON
对象反序列化为结构体对象
使用前([源文件](https://github.com/armink/struct2json/blob/master/docs/zh/assets/not_use_struct2json_for_json.c)) | 使用后([源文件](https://github.com/armink/struct2json/blob/master/docs/zh/assets/used_struct2json_for_json.c)) |
---|---|
[](https://camo.githubusercontent.com/c4d46597fe0b07d322bff8d278c91c29af8409a4/68747470733a2f2f6769742e6f736368696e612e6e65742f41726d696e6b2f737472756374326a736f6e2f7261772f6d61737465722f646f63732f7a682f696d616765732f6e6f745f7573655f737472756374326a736f6e5f666f725f6a736f6e2e706e67)[![](/static/assets/osapp/images/bb8c8c41592701407111cdc79675a8a7.png)](https://git.oschina.net/Armink/struct2json/raw/master/docs/zh/images/not_use_struct2json_for_json.png) | [](https://camo.githubusercontent.com/e48bc6e757bde80efd084d8bc599a460a909000a/68747470733a2f2f6769742e6f736368696e612e6e65742f41726d696e6b2f737472756374326a736f6e2f7261772f6d61737465722f646f63732f7a682f696d616765732f757365645f737472756374326a736f6e5f666f725f6a736f6e2e706e67)[![](/static/assets/osapp/images/af15fa4cf34b8c7652031d943b5e4aec.png)](https://git.oschina.net/Armink/struct2json/raw/master/docs/zh/images/used_struct2json_for_json.png) |
欢迎大家 fork and pull request
(Github|OSChina)
。如果觉得这个开源项目很赞,可以点击项目主页 右上角的 Star
,同时把它推荐给更多有需要的朋友。
文档
具体内容参考[\docs\zh](https://github.com/armink/struct2json/tree/master/docs/zh)下的文件。务必保证在
阅读文档 后再使用。
许可
MIT Copyright (c) armink.ztl@gmail.com
struct2json <a href="https://github.com/armink/struct2json#%E5%A3%B0%E6%98%8E%E7%BB%93%E6%9E%84%E4%BD%93"></a>声明结构体<a href="https://github.com/armink/struct2json#%E5%B0%86-json-%E5%AF%B9 官网
http://git.oschina.net/Armink/struct2json
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。