关于JSON你想知道的都在这了
语法
JSON语法可以表示以下三种类型的值:
- 简单值:可以在JSON中表示字符串、数值、布尔值和null。但JSON不支持JavaScript中的特殊值undefined。
- 对象
- 数组
JSON不支持变量、函数或对象实例,它就是一种表示结构化数据的格式。
简单值
数值:5
字符串:"Hello World!"
JS字符串与JSON字符串最大的区别在于,JSON字符串必须使用双引号
对象
JavaScript中创建对象字面量的标准方式:
var person = {
name:"John",
age:29
};
JSON对象要求给属性加引号:
{
"name":"John",
"age":29
}
与JS中的对象字面量相比,JSON对象有两个不一样的地方:
- 没有声明变量
- 末尾没有分号
数组
JSON数组采用的就是JS中数组字面量形式。
var values = [25,"hi",true];
解析与序列化
JSON流行的原因是可以把JSON数据结构解析为有用的JS对象。
JSON对象
JSON对象有两个方法:
- stringify():把JS对象序列化为JSON字符串,默认情况下JSON.stringify()输出的JSON字符串不包含任何空格字符或缩进。
var book = {
title:"Professional JavaScript",
authors:[
"Nicholas C. Zakas"
],
edition:3,
year:2011
};
var jsonText = JSON.stringify(book);
// 输出:{"title":"Professional JavaScript","authors":[ "Nicholas C. Zakas"],"edition":3,"year":2011}
在序列化JS对象时,所有函数及原型成员都会被有意忽略,不体现在结果中。此外,值为undefined的任何属性也会被跳过。
- parse():把JSON字符串解析为原生JS值
将JSON字符串直接传递给JSON.parse()就可以得到相应的JS值。例如:
var bookCopy = JSON.parse(jsonText);
如果传给JSON.parse()的字符串不是有效的JSON,该方法会抛出错误。
序列化选项
JSON.stringify()除了要序列化的JS对象外,还可以接收另外两个参数,这两个参数用于指定以不同的方式序列化JS对象。第一个参数是个过滤器,可以是一个数组,也可以是一个函数;第二个参数是一个选项,表示是否在JSON字符串中保留缩进。单独或组合使用这两个参数,可以更全面深入地控制JSON序列化。
- 过滤结果
如果过滤器参数是数组,那么JSON.stringify()的结果中,就会只包含数组中列出的属性:
var book = {
title:"Professional JavaScript",
authors:[
"Nicholas C. Zakas"
],
edition:3,
year:2011
};
var jsonText = JSON.stringify(book,["title","edition"]);
// 输出:{"title":"Professional JavaScript","edition":3}
如果第二个参数是函数,行为会稍有不同
var book = {
title:"Professional JavaScript",
authors:[
"Nicholas C. Zakas"
],
edition:3,
year:2011
};
var jsonText = JSON.stringify(book,function(key,value){
switch(key){
case "authors":
return value.join(",")
case "year":
return 5000;
case "edition":
return undefined;
default:
return value;
}
});
//输出 {"title":"Professional JavaScript","authors": "Nicholas C. Zakas","year":2011}
2.字符串缩进
JSON.stringify()方法的第三个参数用于控制结果中的缩进和空白符。如果这个参数是一个数值,那它表示的是每个级别缩进的空格数。例如,要在每个级别缩进4个空格,可以这样写代码:
var book = {
"title": "Professional JavaScript",
"authors": ["Nicholas C. Zakas"],
edition: 3,
year: 2011
};
var jsonText = JSON.stringify(book, null, 4);
保存在jsonText中的字符串如下所示:
{
"title": "Professional JavaScript",
"authors": ["Nicholas C. Zakas"],
"edition": 3,
"year": 2011
}
JSON.stringify()也在结果字符串中插入换行符以提高可读性。只要传入有效的控制缩进的参数值,结果字符串就会包含换行符。最大缩进空格数为10,所有大于10的值会自动转换为10。
如果缩进参数是一个字符串而非数值,则这个字符串将在JSON字符串中被用作缩进字符。在使用字符串的情况下,可以将缩进字符设置为制表符,或者两个短划线之类的任意字符。
var jsonText = JSON.stringify(book, null, " -- ");
这样,jsonText中的字符串将变成如下所示:
{
--"title": "Professional JavaScript",
--"authors": [----"Nicholas C. Zakas"--],
--"edition": 3,
--"year": 2011
}
缩进字符串最长不能超过10个字符长。如果字符串长度超过了10个,结果中只出现10个字符。
3.toJSON()方法
有时候,JSON.stringify()还是不能满足对某些对象进行自定义序列化的需求。在这些情况下,可以通过对象上调用toJSON()方 法,返回其自身的JSON数据格式。原生Date对象有一个toJSON()方法,能够将JavaScript的Date对象自动转换成ISO8601日期字符串(与在Date对象上调用toISOString()的结果完全一样)。
可以为任何对象添加toJSON()方法,比如:
var book = {
"title": "Professional JavaScript",
"authors": ["Nicholas C. Zakas"],
edition: 3,
year: 2011,
toJSON: function () {
return this.title;
}
};
var jsonText = JSON.stringify(book);
以上代码在book对象上定义了一个toJSON()方法,该方法返回图书的书名。与Date对象类似,这个对象也将被序列化为一个简单的字符串而非对象。可以让toJSON()方法返回任何序列化的值,它都能正常工作。也可以让这个方法返回undefined,此时如果包含它的对象嵌入在另一个对 象中,会导致该对象的值变成null,而如果包含它的对象是顶级对象,结果就是undefined。
toJSON()可以作为函数过滤器的补充,因此理解序列化的内部顺序十分重要。假设把一个对象传入JSON.stringify(),序列化该对象的顺序如下:
- 如果存在toJSON()方法而且能通过它取得有效的值,则调用该方法。否则,按默认顺序执行序列化。
- 如果提供了第二个参数,应用这个函数过滤器。传入函数过滤器的值是第(1)步返回的值。
- 对第(2)步返回的每个值进行相应的序列化。
- 如果提供了第三个参数,执行相应的格式化。
无论是考虑定义toJSON()方法,还是考虑使用函数过滤器,亦或需要同时使用两者,理解这个顺序都是至关重要的。
JSON解析选项
JSON.parse()方法也可以接收另一个参数,该参数是一个函数,将在每个键值对儿上调用。为了区别JSON.stringify()接收的替换(过滤)函数,这个函数被称为还原函数(reviver),但实际上这两个函数的签名是相同的——它们都接收两个参数,一个键和一个值,而且都需要返回一个值。
如果还原函数返回undefined,则表示要从结果中删除相应的键;如果返回其它值,则将该值插入到结果中。在将日期字符串转换为Date对象时,经常要用到还原函数。例如:
var book = {
"title": "Professional JavaScript",
"authors": ["Nicholas C. Zakas"],
edition: 3,
year: 2011,
releaseDate: new Date(2011, 11, 1)
};
var jsonText = JSON.stringify(book);
var bookCopy = JSON.parse(jsonText, function (key, value) {
if (key == "releaseDate") {
return new Date(value);
} else {
return value;
}
});
alert(bookCopy.releaseDate.getFullYear());
以上代码先是为book对象新增了一个releaseDate属性,该属性保存着一个Date对象。这个对象在经过序列化之后变成了有效的JSON 字符串,然后经过解析又在bookCopy中还原为一个Date对象。还原函数在遇到”releaseDate”键时,会基于相应的值创建一个新的 Date对象。结果就是bookCopy.releaseDate属性中会保存一个Date对象。正是因为如此,才能基于这个对象调用 getFullYear()方法。