下面的屬性位于_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對象的保留屬性名
- 用于分頁的保留屬性名
- 用于鏈接的保留屬性名
- 錯誤對象中的保留屬性名
- 屬性順序
- 示例
- 附錄