cJSON源码阅读笔记

前言

点击这里可以看到cJSON的介绍和使用(这是我之前的一篇博客)
今天将cJOSN的源码阅读了一遍，下面是在阅读过程的一些代码的简要介绍

---

内存管理

在c语言中内存的释放和申请一般是通过malloc和free完成的，为了方便让用户自由地管理内存，cJOSN使用hook技术来让使用者自定义内存管理函数。
下面是具体实现方式，默认是使用系统的malloc和free函数，使用cJSON_InitHooks 函数可以替换成用户自定义的 malloc 和 free 函数。

typedef struct cJSON_Hooks {
      void *(*malloc_fn)(size_t sz);
      void (*free_fn)(void *ptr);
} cJSON_Hooks;
static void *(*cJSON_malloc)(size_t sz) = malloc;
static void (*cJSON_free)(void *ptr) = free;
void cJSON_InitHooks(cJSON_Hooks* hooks) {
    if (!hooks) { /* Reset hooks */
        cJSON_malloc = malloc;
        cJSON_free = free;
        return;
    }
    cJSON_malloc = (hooks->malloc_fn)?hooks->malloc_fn:malloc;
    cJSON_free = (hooks->free_fn)?hooks->free_fn:free;
}

---

删除cJSON树

如果是object和array则先删除儿子，再删除自己，对于字符串则先释放字符串的内存再释放自己，对于其他节点则直接释放自己的内存，cJSON使用了一个递归函数调用删除object和array节点的儿子，下面是具体函数实现：

void cJSON_Delete(cJSON *c) {
    cJSON *next;
    while (c) {
        next=c->next;
        if (!(c->type&cJSON_IsReference) && c->child) cJSON_Delete(c->child);
        if (!(c->type&cJSON_IsReference) && c->valuestring) cJSON_free(c->valuestring);
        if (c->string) cJSON_free(c->string);
        cJSON_free(c);
        c=next;
    }
}

---

删除儿子节点

cJSON将删除object和array的儿子节点封装成了两个函数，一个函数先将节点从cJSON树中删除但不释放内存（这样就可以在合适的时候添加到其他对象中， 合适的时候释放内存），另一个函数则调用cJSON_Delete函数释放节点内存，下面是具体实现

void   cJSON_DeleteItemFromArray(cJSON *array,int which) {
    cJSON_Delete(cJSON_DetachItemFromArray(array,which));
}
void   cJSON_DeleteItemFromObject(cJSON *object,const char *string) {
    cJSON_Delete(cJSON_DetachItemFromObject(object,string));
}

cJSON *cJSON_DetachItemFromArray(cJSON *array,int which) {
    cJSON *c=array->child;
    while (c && which>0) c=c->next,which--;
    if (!c) return 0;
    if (c->prev) c->prev->next=c->next;
    if (c->next) c->next->prev=c->prev;
    if (c==array->child) array->child=c->next;
    c->prev=c->next=0;
    return c;
}
cJSON *cJSON_DetachItemFromObject(cJSON *object,const char *string) {
    int i=0;
    cJSON *c=object->child;
    while (c && cJSON_strcasecmp(c->string,string)) i++,c=c->next;
    if (c) return cJSON_DetachItemFromArray(object,i);
    return 0;
}

---

JSON的解析部分

cJSON解析json字符串主要部分是parse_value()函数，根据前几个字符判断类型，如果为null，false或true类型则设置类型并返回偏移后的指针，其他的则进入对应函数，下面是具体实现：

static const char *parse_value(cJSON *item,const char *value) {
    if (!value)return 0;/* Fail on null. */
    if (!strncmp(value,"null",4)) {
        item->type=cJSON_NULL;
        return value+4;
    }
    if (!strncmp(value,"false",5)) {
        item->type=cJSON_False;
        return value+5;
    }
    if (!strncmp(value,"true",4)) {
        item->type=cJSON_True;
        item->valueint=1;
        return value+4;
    }
    if (*value=='\"') {
        return parse_string(item,value);
    }
    if (*value=='-' || (*value>='0' && *value<='9')) {
        return parse_number(item,value);
    }
    if (*value=='[') {
        return parse_array(item,value);
    }
    if (*value=='{') {
        return parse_object(item,value);
    }
    ep=value;
    return 0;/* failure. */
}

---

总结

cJSON库中使用了很多函数的递归调用使得代码十分得简洁易懂，有错误处理机制，在字符串处理时考虑到了utf-8编码的字符串。

---

学习资料
http://ju.outofmemory.cn/entry/105377

---

人生十分孤独。
没有一个人能读懂另一个人，
每一个人都很孤独。
——赫尔曼·黑塞

---

给我点十个赞我就买杯可乐庆祝下

---