最近一个 C/C++ 项目要用到 JSON, 所以选用了 json-c 库. C 语言不像 PHP/Python 等动态语言, 可以无缝地将 JSON 数据结构转为自身的数据结构, 所以操作起来会有些麻烦.

首先是数据结构. 在 json-c 里, 所有的 JSON 数据结构都是 json_object 类型, 然后这个 json_object 结构有一个 type 字段, 表明当前的对象是什么类型, 比如整数, 数组, 字符串等等. 没错, 大多数动态语言都是用类似的方法处理动态类型.

json-c 有自己的引用计数的内存管理机制, json_object_get() 函数用于手动地增加对象的引用计数, 相对地, json_object_put() 用于手动地减少引用计数. 要使用 json-c 必须非常明白每一个函数, 是否会增加或者减少对象的引用计数, 以避免内存泄露.

比较特殊的是, 将某个通过 xxx_new_xxx 方法创建的新对象加到另一个对象(对象容器)中(作为另一个对象的一个字段的值, 或者另一个数组的一个元素), 都不会增加新对象的引用计数. 所以, 虽然你 "new" 了一个对象, 但这时, 你却不能把它 "delete" 掉. 当你 "delete" 掉那个对象容器时, 它会自动的减少自己子节点的引用计数.

为了方便操作, 我写了一些辅助方法. 如, 通过点号(或者斜杠)分隔的路径获取属性:

json_object *json_util_get(json_object *obj, const char *path);

路径可以用数字来表示数组的下标. 比如 json_util_get(obj, "result.0.name"), 或者获取 obj 对象的 result 字段, 而 result 是一个数组, 读取该数组的下标为 0 的元素, 这个元素又是一个对象, 最终返回该对象的 name 属性. 因为有时候, 我们并不需要一级一级地关心中间的路径是否存在, 而只关心我们想要的最终结果是否存在. 这个方法非常有用.

另外, 就是数字和表示数字的字符串的问题. 在 PHP 等动态语言中, 表示数字的字符串很多情况下就是数字, 所以很难假设对方会严格地按要求且不会疏忽地把应该是 string 对象当作 int 对象传过来, 所以要在 C 语言里把这两者都当作是 int. 这又是另一个方法:

int json_util_get_int(json_object *obj, const char *path, int defval);

如果指定的字段不是整数而是字符串, 则是尝试把它转为整数返回来.

Related posts: