JSON的使用
1.JSON通信协议的概念
2.JSON的语法
2.1JSON对象
2.2JSON数组
2.3JSON字符串
3.JSON的使用与解析
3.1JSON结构体
3.2JSON格式的使用
3.3JSON格式的解析
1.JSON通信协议的概念
JavaScript 对象表示法( JavaScript Object Notation) 。是一种轻量级的数据交换格式。 它基于ECMAScript的一个子集。 JSON采用完全独立于语言的文本格式, 但是也使用了类似于C语言家族的习惯( 包括C、 C++、 C#、 Java、 JavaScript、 Perl、 Python等) 。这些特性使JSON成为理想的数据交换语言。 易于人阅读和编写,同时也易于机器解析和生成(一般用于提升网络传输速率)。
JSON 解析器和 JSON 库支持许多不同的编程语言。 JSON 文本格式在语法上与创建 JavaScript 对象的代码相同。 由于这种相似性, 无需解析器, JavaScript 程序能够使用内建的 eval() 函数, 用 JSON 数据来生成原生的 JavaScript 对象。
JSON 是存储和交换文本信息的语法。 类似 XML。 JSON 比 XML 更小、 更快, 更易解析。JSON 具有自我描述性, 语法简洁, 易于理解。
2.JSON的语法
JSON建构于两种结构:
“名称/值”对的集合(A collection of name/value pairs)。不同的语言中,它被理解为对象(object),纪录(record),结构(struct),字典(dictionary),哈希表(hash table),有键列表(keyed list),或者关联数组 (associative array)。
值的有序列表(An ordered list of values)。在大部分语言中,它被理解为数组(array)。
这两种结构是常见的JSON数据结构,同时在不同的语言中也都是相通使用的。
JSON的语法JavaScript 语法的子集:
键/值对 key:value,用半角冒号分割。 比如 “Email”:“110”
数据由逗号分隔
大括号保存对象,也称为一个文档对象
中括号保存数组 ,数组成员可以是对象,值,也可以是数组(只要有意义)。 {“paly”: [“斗地主”,“王者”,“吃鸡”]}
2.1JSON对象
对象?你会想我一个单身狗哪里来的对象,哈哈!
当然,这和C++中的对象不太一样。
对象是一个无序的“‘名称/值’对”集合。一个对象以 {左括号 开始, }右括号 结束。每个“名称”后跟一个 :冒号 ;“‘名称/值’ 对”之间使用 ,逗号 分隔。
对象可以包含多个 key/value(键/值)对。其中key 必须是字符串,value 可以是合法的 JSON 数据类型(字符串, 数字, 对象, 数组, 布尔值或 null)。key 和 value 中使用冒号(:)分割。每个 key/value 对使用逗号(,)分割。
如下:
{ "play":"football" , "run": 10000 }
如果想要访问其中的内容可以使用"."访问:var x = play.football
2.2JSON数组
数组是值(value)的有序集合。一个数组以 [左中括号 开始, ]右中括号 结束。值之间使用 ,逗号 分隔。
数组可包含多个对象。这里数组就是大哥了,对象可以是它的小弟了
JSON 中数组值必须是合法的 JSON 数据类型(字符串, 数字, 对象, 数组, 布尔值或 null)。
如下:
{
"game":[
{ "name":"和平精英" , "user":"eveybody" },
{ "name":"王者荣耀", "user":"youngman"}
]
}
2.3JSON字符串
字符串(string)是由双引号包围的任意数量Unicode字符的集合,使用反斜线转义。一个字符(character)即一个单独的字符串(character string)。字符串(string)与C或者Java的字符串非常相似。盗图如下:
3.JSON的使用与解析
在我们使用JSON通信协议之前,有很多东西是不用我们自己写的,直接下载相应的cJSON.c文件和cJSON.h就可以使用了,在使用的时候只需要调用.c文件中相应的功能函数就可以了。
下载地址:https://gitee.com/sample_commander/G4-module-SMS-cat/tree/master/socket
CJSON 作为JSON格式的解析库,功能无外乎构建和解析JSON格式,采用CJSON的设备,以JSON的格式发送数据,收到JSON格式的数据,解析成可供应用识别的功能。
3.1JSON结构体
JSON结构体也是写在cJSON.c文件中的,但是这也是一个非常重要的结构体,必须了解才能使用。
/* The cJSON structure: */
typedef struct cJSON
{
/* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */
struct cJSON *next;
struct cJSON *prev;
/* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */
struct cJSON *child;
/* The type of the item, as above. */
int type;
/* The item's string, if type==cJSON_String and type == cJSON_Raw */
char *valuestring;
/* writing to valueint is DEPRECATED, use cJSON_SetNumberValue instead */
int valueint;
/* The item's number, if type==cJSON_Number */
double valuedouble;
/* The item's name string, if this item is the child of, or is in the list of subitems of an object. */
char *string;
} cJSON;
/* cJSON Types: */
#define cJSON_Invalid (0)
#define cJSON_False (1 << 0)
#define cJSON_True (1 << 1)
#define cJSON_NULL (1 << 2)
#define cJSON_Number (1 << 3)
#define cJSON_String (1 << 4)
#define cJSON_Array (1 << 5)
#define cJSON_Object (1 << 6)
#define cJSON_Raw (1 << 7)/* raw json */
cJOSN结构体为一个双向链表,并可通过child指针访问下一层。
.type :变量决定数据项类型(键的类型)
valuestring / valueint / valuedouble: 数据项 依次表示是字符串/是整形/浮点型
string : 节点名称,或理解为“键(key)”。
3.2JSON格式的使用
JSON格式的使用其实很简单,就算调用cJSON中的函数即可:
从缓冲区中解析出JSON结构:extern cJSON *cJSON_Parse(const char *value);
将传入的JSON结构转化为字符串:extern char *cJSON_Print(cJSON *item); 可用于输出到输出设备, 使用完之后free(char *) 。
将JSON结构所占用的数据空间释放:void cJSON_Delete(cJSON *c)
最简单的使用就是这三步就可以了,但是需要注意的是解析一块JSON数据返回cJSON结构,在使用完之后调用cJSON_Delete函数释放json对象结构。
创建一个值类型的数据:
extern cJSON *cJSON_CreateNumber(double num);
extern cJSON *cJSON_CreateString(const char *string);
extern cJSON *cJSON_CreateArray(void);
创建一个对象(文档) :extern cJSON *cJSON_CreateObject(void);
数组创建以及添加:
cJSON *cJSON_CreateIntArray(const int *numbers,int count);
void cJSON_AddItemToArray(cJSON *array, cJSON *item);
JSON嵌套:
【向对象中增加键值对】 cJSON_AddItemToObject(root, “rows”, 值类型数据相关函数());
【 向对象中增加数组】 cJSON_AddItemToObject(root, “rows”, cJSON_CreateArray());
【 向数组中增加对象】 cJSON_AddItemToArray(rows, cJSON_CreateObject());
在了解了这些基本的知识后,我们来看一个简单的实例,这里我把这个文件取名为pack_json.c,即打包:
#include
#include
#include
#include"cJSON.h"//这里包含一下cJSON.c的头文件,直接下载使用
int main(int argc, char **argv)
{
char *data;
cJSON *json;
char *json_data = NULL;
data = "{\"Mobile\":[\"13885761500\"],\"中文短信\":[\"你好\"], \"English_SMS\":[\"hello\"]}";
//从缓冲区中解析出JSON结构
json= cJSON_Parse(data);
//将传入的JSON结构转化为字符串 并打印
json_data = cJSON_Print(json);
printf("data:%s\n",json_data);
//将JSON结构所占用的数据空间释放
free(json_data);
cJSON_Delete(json);
return 0;
}
在我们的Linux下写好这个c文件之后我们就可以编译了,但是编译的时候得加上cJSON.c这个文件gcc pack_json.c cJSON.c
输出结果如下:
3.3JSON格式的解析
当我们接收到一个JSON格式的文件的时候我们需要解析出其中我们想要的数据,那么步骤如下:
根据键找json结点:extern cJSON *cJSON_GetObjectItem(cJSON *object,const char *string)
判断是否有key是string的项 如果有返回1 否则返回0 :extern int cJSON_HasObjectItem(cJSON *object,const char *string)
{ return cJSON_GetObjectItem(object,string)?1:0; }
返回数组结点array中成员的个数 :extern int cJSON_GetArraySize(cJSON *array);
根据数组下标index取array数组结点的第index个成员返回该成员节点 :extern cJSON *cJSON_GetArrayItem(cJSON *array,int index);
遍历数组:#define cJSON_ArrayForEach(pos, head) for(pos = (head)->child; pos != NULL; pos = pos->next)
那么现在我们假如接收到上面那个的数据,我们来解析一下,我取名为unpack_json.c,即解包:
#include
#include
#include
#include"cJSON.h"//同样的,这里需要包含这个头文件
int main(int argc, char **argv)
{
cJSON *tnode = NULL;
char *string = "{\"Mobile\":[\"18585761500\"], \"中文短信\":[\"你好\"], \"English_SMS\":[\"hello\"]}";
cJSON *json = cJSON_Parse(string);
cJSON *node = NULL;
node = cJSON_GetObjectItem(json,"Mobile"); //查找第一个节点
if(node == NULL)
{
printf("Mobile node == NULL\n");
return -1;
}
if(1 != cJSON_HasObjectItem(json,"Mobile"))
{
printf("not found Mobile node\n");
return -2;
}
cJSON_ArrayForEach(tnode,node)
{
if(tnode->type == cJSON_String)
{
printf("The mobile is:%s\n",tnode->valuestring);
}
else
{
printf("node's type is not string\n");
}
}
node = cJSON_GetObjectItem(json,"中文短信");
if(node == NULL)
{
printf("中文短信 node is NULL\n");
return -3;
}
if(1 != cJSON_HasObjectItem(json,"中文短信"))
{
printf("not found 中文短信 node\n");
return -4;
}
cJSON_ArrayForEach(tnode,node)
{
if(tnode->type == cJSON_String)
{
printf("The mobile is:%s\n",tnode->valuestring);
}
else
{
printf("node's type is not string\n");
}
}
node = cJSON_GetObjectItem(json,"English_SMS");
if(node == NULL)
{
printf("English_SMS node is NULL\n");
return -6;
}
if(1 != cJSON_HasObjectItem(json,"English_SMS"))
{
printf("not found English_SMS node\n");
return -7;
}
cJSON_ArrayForEach(tnode,node)
{
if(tnode->type == cJSON_String)
{
printf("The English_SMS is:%s\n",tnode->valuestring);
}
else
{
printf("node's type is not string\n");
return -1;
}
}
return 0;
}
写完程序后,编译的时候同样的要加入cJSON.c文件一起编译,结果如下: