最近用 C 语言处理 JSON ，感觉很麻烦，就写了这个可以生成 JSON 处理代码的程序。

json-gen-c 通过读取结构体 (struct) 定义文件，生成对应的 JSON 处理代码。这些代码包括 struct 结构体定义，结构体初始化和清理函数，结构体 JSON 编码和解码函数。

编译

使用下列命令构建并安装：

make
sudo make install

使用示范

编辑 struct.json-gen-c 文件，内容如下

// 结构体定义文件

// 定义结构体 A
struct A {
    // 定义成员变量
    int int_val1;
    int int_val2;
    long long_val;
    double double_val;
    float float_val;
    sstr_t sstr_val;
    // 还可以定义数组
    int int_val_array[];
    // 定义别的结构体类型的变量
    B b_val;
};

// 定义结构体 B
struct B {
    int id;
};

构建 json.gen.c 和 json.gen.h

使用下列命令创建 json 处理代码：

json-gen-c -in struct.json-gen-c -out .

命令创建了 json.gen.c 和 json.gen.h 文件，其中包含了 json 处理代码。同时创建了他们依赖的 sstr.h 和 sstr.c，这是用于字符串处理的代码，程序中大量地方使用了他们。

使用 json 处理代码例如要解析 JSON 字符串到结构体 A：

// const char *p_str = "{this is a json string}";
// sstr_t json_str = sstr(pstr);

struct A a;
A_init(&a);
json_unmarshal_A(json_str, &a); // 注意 json_str 是 sstr_t 类型的
// ...
A_clear(&a);

要解析 JSON 字符串到结构体 A 的数组 A a[]:

// const char *p_str = "this is a json string";
// sstr_t json_str = sstr(pstr);

struct A *a = NULL;
int len = 0;
json_unmarshal_array_A(&a, &len, json_str); // 注意 json_str 是 sstr_t 类型的
// ...
int i;
for (i = 0; i < len; ++i) {
    A_clear(&a[i]);
}
free(a);

要将结构体 A 序列化成 JSON 字符串:

struct A a;
A_init(&a);
// set values to a ...
// ...
sstr_t json_str = sstr_new();
json_marshal_A(&a, json_str);

printf("marshal a to json> %s\n", sstr_cstr(json_str));

sstr_free(json_str);
A_clear(&a);

要将结构体数组 A a[] 序列化成 JSON 字符串：

struct A a[3];
for (i = 0; i < 3; ++i) {
    A_init(&a[i]);
    // set values to a[i] ...
}

sstr_t json_str = sstr_new();
json_marshal_array_A(a, 3, json_str);

printf("marshal a[] to json> %s\n", sstr_cstr(json_str));

for (i = 0; i < 3; ++i) {
    A_clear(&a[i]);
}

结构定义文件格式

结构定义格式如下:

struct <struct_name> {
    <field_type> <field_name> []?;
    <field_type> <field_name> []?;
    ...
};

<field_type> 可以是下列内容之一：

int
long
float
double
sstr_t
a struct name

如果是成员变量是一个数组，就在变量名后面加 []。name.

API

// initialize a struct
// always return 0
int <struct_name>_init(struct <struct_name> *obj);

// uninitialize a struct
// always return 0
int <struct_name>_clear(struct <struct_name> *obj);

// marshal a struct to json string.
// return 0 if success.
int json_marshal_<struct_name>(struct <struct_name>*obj, sstr_t out);

// marshal an array of struct to json string.
// return 0 if success.
int json_marshal_array<struct_name>(struct <struct_name>*obj, int len, sstr_t out);

// unmarshal a json string to a struct.
// return 0 if success.
int json_unmarshal_<struct_name>(sstr_t in, struct <struct_name>*obj);

// unmarshal a json string to array of struct
// return 0 if success.
int json_unmarshal_<struct_name>(sstr_t in, struct <struct_name>**obj, int *len);

参考 protobuf 的想法，写了个 C 语言的 JSON 处理库，可以方便完成 C struct 到 JSON 之间的转换

编译

使用示范

结构定义文件格式

API