下面的属性位于_data_对象中,用来表示对其他资源的引用。有两种形式的链接属性:1)对象,它可以包含任何种类的引用(比如JSON-RPC对象),2)URL字符串,表示资源的URIs(后缀总为'Link')。
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataself--dataselflink)data.self / data.selfLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
自身链接可以用于取回条目数据。比如,在用户的Picasa相册中,条目中的每个相册对象都会包含一个_selfLink_用于检索这个相册的相关数据。
示例:
~~~
{
"data": {
"self": { },
"selfLink": "http://www.google.com/feeds/album/1234"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataedit--dataeditlink)data.edit / data.editLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
编辑链接表明用户可以发送更新或删除请求。这对于REST风格的APIs很有用。该链接仅在用户能够更新和删除该条目时提供。
示例:
~~~
{
"data": {
"edit": { },
"editLink": "http://www.google.com/feeds/album/1234/edit"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#datanext--datanextlink)data.next / data.nextLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
该下一页链接标明如何取得更多数据。它指明载入下一组数据的位置。它可以同_itemsPerPage_,_startIndex_ 和 _totalItems_属性一起使用用于分页数据。
示例:
~~~
{
"data": {
"next": { },
"nextLink": "http://www.google.com/feeds/album/1234/next"
}
}
~~~
### [](https://github.com/darcyliu/google-styleguide/blob/master/JSONStyleGuide.md#dataprevious--datapreviouslink)data.previous / data.previousLink
~~~
属性值类型: 对象(object)/字符串(string)
父节点: data
~~~
该上一页链接标明如何取得更多数据。它指明载入上一组数据的位置。它可以连同_itemsPerPage_,_startIndex_ 和 _totalItems_属性用于分页数据。
示例:
~~~
{
"data": {
"previous": { },
"previousLink": "http://www.google.com/feeds/album/1234/next"
}
}
~~~
- Google 开源项目风格指南 (中文版)
- C++ 风格指南
- 0. 扉页
- 1. 头文件
- 2. 作用域
- 3. 类
- 4. 来自 Google 的奇技
- 5. 其他 C++ 特性
- 6. 命名约定
- 7. 注释
- 8. 格式
- 9. 规则特例
- 10. 结束语
- Objective-C 风格指南
- Google Objective-C Style Guide 中文版
- 留白和格式
- 命名
- 注释
- Cocoa 和 Objective-C 特性
- Cocoa 模式
- Python 风格指南
- Google Python 风格指南 - 中文版
- 背景
- Python语言规范
- Python风格规范
- 临别赠言
- JSON 风格指南
- 简介
- 定义
- 一般准则
- 属性名准则
- 属性值准则
- 属性值数据类型
- JSON结构和保留属性名
- 顶级保留属性名称
- data对象的保留属性名
- 用于分页的保留属性名
- 用于链接的保留属性名
- 错误对象中的保留属性名
- 属性顺序
- 示例
- 附录