读写 XML/JSON/INI 和 UBJSON 等格式的数据文件的统一接口

将抽象放进代码，细节放进元数据。

开发应用程序，会经常使用各种数据文件（如配置数据和元数据），常见的数据文件格式有 INI、XML、JSON 和 UBJSON，对一个复杂的应用程序，其中可能会同时使用多种不同格式的数据文件。

通常，操作这些数据文件的函数各不相同，对于程序员来说即是学习负担，也是记忆负担。AWTK 提供了一套统一的接口函数，同一套接口函数，可以操作不同的格式的数据文件。

加载数据文件成功后得到一个 object 的实例，可以用 object 的函数对其进行增加、修改、删除和查询。如果熟悉 object 的用法，那就非常简单了。

下面的函数可以读取任意基本类型的数据。

ret_t tk_object_get_prop(tk_object_t* obj, const char* name, value_t* v);

为了方便使用，也提供了常见数据类型的包装函数。如：

const char* tk_object_get_prop_str(tk_object_t* obj, const char* name);

下面的函数可以增加/修改任意基本类型的数据。

ret_t tk_object_set_prop(tk_object_t* obj, const char* name, const value_t* value);

为了方便使用，也提供了常见数据类型的包装函数。如：

ret_t tk_object_set_prop_str(tk_object_t* obj, const char* name, const char* value);

ret_t tk_object_remove_prop(tk_object_t* obj, const char* name);

• 配置信息通常都是层次结构的，为了能访问所有数据，path 也必须是多级的，各级的名称之间用“.”分隔。

“.”不能作为名称的一部分，如果出现，需要用其它字符代替。

{
    "network" : { 
        "eth0" : { 
            "ip" : "192.169.0.100",
            "gateway" : "192.169.0.1",
            "mask" : "255.255.255.0"
        }   
    }   
}

在这个例子中，要访问 ip 的这个配置，可以用"network.eth0.ip":

• 按索引访问

在访问时，每一级的名称，可以用索引代替，格式为：[+索引+]，比如 [0] 表示第一项，[2] 表示第三项。这对于不清楚名称的情况，或遍历
全部配置，很有帮助。

• 用 #size 获取子节点个数

示例：

[wifi]
  on = 1
  name = awtk
[server]
  port = 8080
  timeout = 1.000000

在上面的例子中，"#size"获取分组的个数为 2，"wifi.#size"获取 wifi 下的子项数为 2。

• 用 #name 获取项的名称。

示例：

[wifi]
  on = 1
  name = awtk
[server]
  port = 8080
  timeout = 1.000000

在上面的例子中，“[0].#name” 获取第一个分组的名称为"wifi"，“wifi.[0].#name” 获取 wifi 下第一项的名称为 “on”。

• 用 #index 获取配置项在兄弟节点中的序数。

[wifi]
  on = 1
  name = awtk
[server]
  port = 8080
  timeout = 1.000000

在上面的例子中，“wifi.#index” 获取 wifi 的序数为 0，“server.#index” 获取 server 的序数为 1。

上面的函数使用简单，但是在数据量大的时候，不如直接去操作 node 效率更高，如果有此需求可以查看 src/conf_io/conf_node.h 中函数，以及单元测试中的用法，这里不再赘述。

此时需要使用具体格式的函数

• 打开

tk_object_t* conf_json_load(const char* url, bool_t create_if_not_exist);

• 保存

ret_t conf_json_save_as(tk_object_t* obj, const char* url);

• 打开

tk_object_t* conf_xml_load(const char* url, bool_t create_if_not_exist);

• 保存

ret_t conf_xml_save_as(tk_object_t* obj, const char* url);

• 打开

tk_object_t* conf_ini_load(const char* url, bool_t create_if_not_exist);

• 保存

ret_t conf_ini_save_as(tk_object_t* obj, const char* url);

• 3.4 UBJSON 格式

• 打开

tk_object_t* conf_ubjson_load(const char* url, bool_t create_if_not_exist);

* 保存

```c

ret_t conf_ubjson_save_as(tk_object_t* obj, const char* url);

#include "conf_io/conf_json.h"

void demo_conf_json(c) {
  tk_object_t* doc = conf_json_load("./test.json", TRUE);
  tk_object_set_prop_str(doc, "name", "awtk");
  tk_object_set_prop_int(doc, "age", 100);
  conf_json_save_as(doc, "./test.json");
  TK_OBJECT_UNREF(doc);
  
  doc = conf_json_load("./test.json", TRUE);

  log_debug("name:%sn", tk_object_get_prop_str(doc, "name"));
  log_debug("age:%dn", tk_object_get_prop_int(doc, "age", 0));
  TK_OBJECT_UNREF(doc);
}

对应的数据文件为：

{
    "name" : "awtk",
    "age" : 100 
}