JSON 学习笔记

JSON 学习笔记

@Author: YiHua Lee @Address: Guangdong province, China

JSON 简介

JSON 指的是 JavaScript 对象表示法(JavaScript Object Notation)

JSON 是轻量级的文本数据交换格式

JSON 独立于语言:JSON 使用 Javascript语法来描述数据对象,但是 JSON 仍然独立于语言和平台。JSON 解析器和 JSON 库支持许多不同的编程语言。 目前非常多的动态(PHP,JSP,.NET)编程语言都支持JSON。

JSON 具有自我描述性,更易理解

JSON 文件的文件类型是 “.json”。

JSON 文本的 MIME 类型是 “application/json”。


JSON - 转换为 JavaScript 对象

JSON 文本格式在语法上与创建 JavaScript 对象的代码相同。

由于这种相似性,无需解析器,JavaScript 程序能够使用内建的 eval() 函数,用 JSON 数据来生成原生的 JavaScript 对象。


示例引入

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>JavaScript 创建 JSON 对象</title>
</head>
<body>
<h2>JavaScript 创建 JSON 对象</h2>
<p>
网站名称:<span id="name"></span><br />
网站地址:<span id="site"></span><br />
网站 slogan: <span id="slogan"></span><br />
</p>

<script>
var JSONObject = {
"name": "LeeHua",
"url": "www.stringbug.com",
"slogan": "世间美好,与你环环相扣!"
};
document.getElementById("name").innerHTML = JSONObject.name
document.getElementById("site").innerHTML = JSONObject.url
document.getElementById("slogan").innerHTML = JSONObject.slogan
</script>
</body>
</html>

20200711224629

JSON 与 XML 区别

JSON 实例

1
2
3
4
5
6
7
{
"sites": [
{ "name": "菜鸟教程" , "url": "www.runoob.com" },
{ "name": "google" , "url": "www.google.com" },
{ "name": "微博" , "url": "www.weibo.com" }
]
}

XML 实例

1
2
3
4
5
6
7
8
9
10
11
<sites>
<site>
<name>菜鸟教程</name> <url>www.runoob.com</url>
</site>
<site>
<name>google</name> <url>www.google.com</url>
</site>
<site>
<name>微博</name> <url>www.weibo.com</url>
</site>
</sites>

JSON与 XML 相同之处

  • JSON 和 XML 数据都是 “自我描述” ,都易于理解。
  • JSON 和 XML 数据都是有层次的结构
  • JSON 具有层级结构(值中存在值)
  • JSON 和 XML 数据可以被大多数编程语言使用

JSON与 XML 不同之处

  • JSON 不需要结束标签
  • JSON 更加简短
  • 能够使用内建的 JavaScript eval() 方法进行解析
  • JSON 可以使用数组

最大的不同是:XML 需要使用 XML 解析器来解析,JSON 可以使用标准的 JavaScript 函数来解析。

JSON.parse(): 将一个 JSON 字符串转换为 JavaScript 对象。

JSON.stringify(): 于将 JavaScript 值转换为 JSON 字符串。


JSON 语法

JSON 语法规则

JSON 语法是 JavaScript 对象表示语法的子集。

  • 数据在名称/值对中
  • 数据由逗号分隔
  • 大括号保存对象
  • 中括号保存数组

JSON 名称/值对

JSON 数据的书写格式是:名称/值对。

名称/值对包括字段名称(在双引号中)

JSON 值可以是数字(整数或浮点数)、字符串(在双引号中)、逻辑值(true 或 false)、数组(在中括号中)、对象(在大括号中)、null


JSON 使用 JavaScript 语法

因为 JSON 使用 JavaScript 语法,所以无需额外的软件就能处理 JavaScript 中的 JSON。

通过 JavaScript,您可以创建一个对象数组,如:

1
2
3
4
5
var sites = [
{ "name":"youtube" , "url":"www.youtube.com" },
{ "name":"google" , "url":"www.google.com" },
{ "name":"微博" , "url":"www.weibo.com" }
];
  • 访问 JavaScript 对象数组中的第一项(索引从 0 开始)

    1
    sites[0].name;
  • 修改数据

    1
    sites[0].name="StringBug";

JSON 对象

实例:{ "name": "runoob", "alexa": 10000, "site": null }

  • JSON 对象使用在大括号 {} 中书写。
  • 对象可以包含多个 key/value(键/值)对。
  • key 必须是字符串,value 可以是合法的 JSON 数据类型。
  • key 和 value 中使用冒号 : 分割。
  • 每个 key/value 对使用逗号 , 分割。

访问对象值

  1. 方式1:对象.key 访问对象值

    1
    2
    3
    var myObj, x;
    myObj = { "name":"runoob", "alexa":10000, "site":null };
    x = myObj.name;
  1. 方式2:对象[key] 访问对象值

    1
    2
    3
    var myObj, x;
    myObj = { "name":"runoob", "alexa":10000, "site":null };
    x = myObj["name"];

循环对象

  1. 可以使用 for-in 来循环对象的属性

    1
    2
    3
    4
    var myObj = { "name":"runoob", "alexa":10000, "site":null };
    for (x in myObj) {
    document.getElementById("demo").innerHTML += x + "<br>";
    }
  1. 在 for-in 循环对象的属性时,使用中括号 [] 来访问属性的值

    1
    2
    3
    4
    var myObj = { "name":"runoob", "alexa":10000, "site":null };
    for (x in myObj) {
    document.getElementById("demo").innerHTML += myObj[x] + "<br>";
    }

嵌套 JSON 对象

JSON 对象中可以包含另外一个 JSON 对象:

1
2
3
4
5
6
7
8
9
myObj = {
"name":"runoob",
"alexa":10000,
"sites": {
"site1":"www.runoob.com",
"site2":"m.runoob.com",
"site3":"c.runoob.com"
}
}

可以使用点号 . 或者中括号 [] 来访问嵌套的 JSON 对象。如:

1
2
x = myObj.sites.site1;
x = myObj.sites["site1"];

修改值

  • 可以使用点号 . 来修改 JSON 对象的值

    1
    myObj.sites.site1 = "www.google.com";
  • 使用中括号 [] 来修改 JSON 对象的值

    1
    myObj.sites["site1"] = "www.google.com";

删除对象属性

  • 使用 delete 关键字来删除 JSON 对象的属性

    1
    delete myObj.sites.site1;
  • 使用中括号 [] 来删除 JSON 对象的属性

    1
    delete myObj.sites["site1"]

JSON 数组

JSON 对象中的数组

对象属性的值可以是一个数组

1
2
3
4
5
{
"name": "网站",
"num": 3,
"sites": [ "Google", "Runoob", "Taobao" ]
}

可以使用索引值来访问数组:x = myObj.sites[0];


嵌套 JSON 对象中的数组

JSON 对象中数组可以包含另外一个数组,或者另外一个 JSON 对象

实例:

1
2
3
4
5
6
7
8
9
myObj = {
"name":"网站",
"num":3,
"sites": [
{ "name":"Google", "info":[ "Android", "Google 搜索", "Google 翻译" ] },
{ "name":"Runoob", "info":[ "菜鸟教程", "菜鸟工具", "菜鸟微信" ] },
{ "name":"Taobao", "info":[ "淘宝", "网购" ] }
]
}

使用 for-in 来循环访问每个数组:

1
2
3
4
5
6
for (i in myObj.sites) {
x += "<h1>" + myObj.sites[i].name + "</h1>";
for (j in myObj.sites[i].info) {
x += myObj.sites[i].info[j] + "<br>";
}
}

代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>嵌套 JSON 对象中的数组</title>
</head>
<body>
<p>循环内嵌数组:</p>
<p id="demo"></p>
<script>
var myObj, i, j, x = "";
myObj = {
"name":"网站",
"num":3,
"sites": [
{ "name":"Google", "info":[ "Android", "Google 搜索", "Google 翻译" ] },
{ "name":"Runoob", "info":[ "菜鸟教程", "菜鸟工具", "菜鸟微信" ] },
{ "name":"Taobao", "info":[ "淘宝", "网购" ] }
]
}
// myObj.sites
for (i in myObj.sites) {
// myObj.sites --- name
x += "<h1>" + myObj.sites[i].name + "</h1>";
// myObj.sites --- info
for (j in myObj.sites[i].info) {
x += myObj.sites[i].info[j] + "<br>";
}
}
document.getElementById("demo").innerHTML = x;
</script>
</body>
</html>

修改数组值

可以使用索引值来修改数组值:myObj.sites[1] = "Github";


删除数组元素

可以使用 delete 关键字来删除数组元素:delete myObj.sites[1];


JSON.parse()

JSON 通常用于与服务端交换数据。在接收服务器数据时一般是字符串。我们可以使用 JSON.parse() 方法将数据转换为 JavaScript 对象。

语法:

1
JSON.parse(text[, reviver])
  • text:必需, 一个有效的 JSON 字符串。
  • reviver: 可选,一个转换结果的函数, 将为对象的每个成员调用此函数。

JSON 解析实例

  • 例如我们从服务器接收了以下数据:

    1
    { "name":"LeeHua", "site":"www.stringbug.com" }
  • 使用 JSON.parse() 方法处理以上数据,将其转换为 JavaScript 对象:

    1
    var obj = JSON.parse('{ "name":"LeeHua", "site":"www.stringbug.com" }');

    解析前要确保数据是标准的 JSON 格式,否则会解析出错。

  • 解析完成后,我们就可以在网页上使用 JSON 数据了:

    1
    2
    3
    4
    5
    6
    7
    8
    <body>
    <h2>从 JSON 对象中创建 JavaScript 对象</h2>
    <p id="demo"></p>
    <script>
    var obj = JSON.parse('{ "name":"LeeHua", "site":"www.stringbug.com" }');
    document.getElementById("demo").innerHTML = obj.name + ":" + obj.site;
    </script>
    </body>

    结果如下:

    20200712103643

从服务端接收 JSON 数据

可以使用 Ajax 从服务器请求 JSON 数据,并解析为 JavaScript 对象。

  • 服务器端游如下一个文件:json_demo.txt

    1
    2
    3
    4
    5
    6
    7
    8
    9
    {
    "name": "网站",
    "num": 3,
    "sites": [
    { "name": "Google", "info": [ "Android", "Google 搜索", "Google 翻译" ] },
    { "name": "Runoob", "info": [ "菜鸟教程", "菜鸟工具", "菜鸟微信" ] },
    { "name": "Taobao", "info": [ "淘宝", "网购" ] }
    ]
    }
  • 使用 XMLHttpRequest 来获取文件内容

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    <body>
    <h2>使用 XMLHttpRequest 来获取文件内容</h2>
    <p>文件内容是标准的 JSON 格式,可以使用 JSON.parse 方法将其转换为 JavaScript 对象。</p>
    <p id="demo"></p>
    <script>
    // 创建 XMLHttpRequest 对象
    var xmlhttp = new XMLHttpRequest();
    // 执行一些基于响应的任务
    xmlhttp.onreadystatechange = function() {
    // readyState 等于 4 且状态为 200 ,响应已就绪
    if (this.readyState == 4 && this.status == 200) {
    // 将服务器发送来的响应文本(JSON)解析为 JavaScript 对象
    myObj = JSON.parse(this.responseText);
    // 文本插入到 id="demo" 的标签体内
    document.getElementById("demo").innerHTML = myObj.name;
    }
    };
    // 规定请求的类型、URL 以及是否异步处理请求
    xmlhttp.open("GET", "json_demo.txt", true);
    // 将请求从浏览器发送到服务器
    xmlhttp.send();
    </script>
    <p>查看 JSON 文件数据 <a href="json_demo.txt" target="_blank">json_demo.txt</a></p>
    </body>
  • 结果如下:

    20200712110832

    点击 json_demo.txt,跳转

    20200712110953

    这里出现了乱码的情况,是没有规定解析格式导致的。


从服务端接收数组的 JSON 数据

如果从服务端接收的是数组的 JSON 数据,则 JSON.parse 会将其转换为 JavaScript 数组:

1
2
3
4
5
6
7
8
9
var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {
myArr = JSON.parse(this.responseText);
document.getElementById("demo").innerHTML = myArr[1];
}
};
xmlhttp.open("GET", "json_demo_array.txt", true);
xmlhttp.send();

异常

JSON 不能存储 Date 对象。如果需要存储 Date 对象,需要将其转换为字符串,之后再将字符串转换为 Date 对象。

1
2
3
4
var text = '{ "name": "LeeHua", "initDate": "2013-12-14", "site": "www.stringbug.com"}';
var obj = JSON.parse(text);
obj.initDate = new Date(obj.initDate);
document.getElementById("demo").innerHTML = obj.name + "创建日期: " + obj.initDate;

可以启用 JSON.parse 的第二个参数 reviver,一个转换结果的函数,对象的每个成员调用此函数

1
2
3
4
5
6
7
8
var text = '{ "name": "LeeHua", "initDate": "2013-12-14", "site": "www.stringbug.com"}';
var obj = JSON.parse(text, function (key, value) {
if (key == "initDate") {
return new Date(value);
} else {
return value;
}});
document.getElementById("demo").innerHTML = obj.name + "创建日期:" + obj.initDate;

解析函数

JSON 不允许包含函数,但可以将函数作为字符串存储,之后再将字符串转换为函数。

1
2
3
4
var text = '{ "name": "LeeHua", "site": "function () { return "www.stringbug.com"; }" }';
var obj = JSON.parse(text);
obj.site = eval("(" + obj.site + ")");
document.getElementById("demo").innerHTML = obj.name + " 的网站:" + obj.site();

不建议在 JSON 中使用函数。


JSON.stringify()

JSON 通常用于与服务端交换数据。在向服务器发送数据时一般是字符串。我们可以使用 JSON.stringify() 方法将 JavaScript 对象转换为字符串。

1
JSON.stringify(value[, replacer[, space]])

参数说明

1
JSON.stringify(value[, replacer[, space]])
  • value:

    必需, 要转换的 JavaScript 值(通常为对象或数组)。

  • replacer:

    可选。用于转换结果的函数或数组。

    如果 replacer 为函数,则 JSON.stringify 将调用该函数,并传入每个成员的键和值。使用返回值而不是原始值。如果此函数返回 undefined,则排除成员。根对象的键是一个空字符串:””。

    如果 replacer 是一个数组,则仅转换该数组中具有键值的成员。成员的转换顺序与键在数组中的顺序一样。当 value 参数也为数组时,将忽略 replacer 数组。

  • space:

    可选,文本添加缩进、空格和换行符,如果 space 是一个数字,则返回值文本在每个级别缩进指定数目的空格,如果 space 大于 10,则文本缩进 10 个空格。space 也可以使用非数字,如:\t。


JavaScript 对象转换

例如我们向服务器发送以下数据:

1
var obj = { "name":"runoob", "alexa":10000, "site":"www.runoob.com"};

我们使用 JSON.stringify() 方法处理以上数据,将其转换为字符串:

1
var myJSON = JSON.stringify(obj);

myJSON 为字符串。我们可以将 myJSON 发送到服务器:

1
2
3
var obj = { "name":"runoob", "alexa":10000, "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

JavaScript 数组转换

我们也可以将 JavaScript 数组转换为 JSON 字符串:

1
2
var arr = [ "Google", "Runoob", "Taobao", "Facebook" ];
var myJSON = JSON.stringify(arr);

异常

JSON 不能存储 Date 对象。JSON.stringify() 会将所有日期转换为字符串。

1
2
3
var obj = { "name":"Runoob", "initDate":new Date(), "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

之后可以再将字符串转换为 Date 对象。


解析函数

JSON 不允许包含函数,JSON.stringify() 会删除 JavaScript 对象的函数,包括 key 和 value。

1
2
3
var obj = { "name":"Runoob", "alexa":function () {return 10000;}, "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

我们可以在执行 JSON.stringify() 函数前将函数转换为字符串来避免以上问题的发生:

1
2
3
4
var obj = { "name":"Runoob", "alexa":function () {return 10000;}, "site":"www.runoob.com"};
obj.alexa = obj.alexa.toString();
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

JSON 使用

把 JSON 文本转换为 JavaScript 对象

JSON 最常见的用法之一,是从 web 服务器上读取 JSON 数据(作为文件或作为 HttpRequest),将 JSON 数据转换为 JavaScript 对象,然后在网页中使用该数据。


JSON 实例 - 来自字符串的对象

  • 创建包含 JSON 语法的 JavaScript 字符串:

    1
    2
    3
    4
    var txt = '{ "sites" : [' +
    '{ "name":"菜鸟教程" , "url":"www.runoob.com" },' +
    '{ "name":"google" , "url":"www.google.com" },' +
    '{ "name":"微博" , "url":"www.weibo.com" } ]}';
  • 由于 JSON 语法是 JavaScript 语法的子集,JavaScript 函数 eval() 可用于将 JSON 文本转换为 JavaScript 对象。

    eval() 函数使用的是 JavaScript 编译器,可解析 JSON 文本,然后生成 JavaScript 对象。必须把文本包围在括号中,这样才能避免语法错误: var obj = eval ("(" + txt + ")");

在网页中使用 JavaScript 对象:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<body>
<h2>从 JSON 字符串中创建对象</h2>
<p>
网站名: <span id="name"></span><br />
网站地址: <span id="url"></span><br>
</p>
<script>
var txt = '{ "sites" : [' +
'{ "name":"百度" , "url":"www.baidu.com" },' +
'{ "name":"google" , "url":"www.google.com" },' +
'{ "name":"微博" , "url":"www.weibo.com" } ]}';

var obj = eval ("(" + txt + ")");

document.getElementById("name").innerHTML = obj.sites[0].name
document.getElementById("url").innerHTML = obj.sites[0].url
</script>
</body>
20200712115643

参考文献

  1. JSON 教程| 菜鸟教程
评论