JSON 风格指南
该风格指南是对在Google创建JSON APIs而提供的指导性准则和建议。总体来讲,JSON APIs应遵循JSON.org上的规范。这份风格指南澄清和标准化了特定情况,从而使Google的JSON APIs有一种标准的外观和感觉。这些指南适用于基于RPC和基于REST风格的API的JSON请求和响应。
定义
为了更好地实现这份风格指南的目的,下面几项需要说明:
- 属性(property) - JSON对象内的键值对(name/value pair)
- 属性名(property name) - 属性的名称(或键)
- 属性值(property value) - 分配给属性的值
示例:
{
// 一组键值对称作一个 "属性".
"propertyName": "propertyValue"
}
Javascript的数字(number)包含所有的浮点数,这是一个宽泛的指定。在这份指南中,数字(number)指代Javascript中的数字(number)类型,而整型(integer)则指代整型。
致谢
内容撰写:https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md英文版:http://google-styleguide.googlecode.com/svn/trunk/jsoncstyleguide.xml
更新日期 | 更新内容 |
---|---|
2015-05-26 | JSON 风格指南 |
下一篇: 一般准则