一般準(zhǔn)則

2018-02-24 15:12 更新

注釋

JSON對象中不包含注釋。

JSON對象中不應(yīng)該包含注釋。該指南中的某些示例含有注釋。但這僅僅是為了說明示例。

{
  // 你可能在下面的示例中看到注釋,
  // 但不要在你的JSON數(shù)據(jù)中加入注釋.
  "propertyName": "propertyValue"
}

雙引號

使用雙引號

如果(某個)屬性需要引號,則必須使用雙引號。所有的屬性名必須在雙引號內(nèi)。字符類型的屬性值必須使用雙引號。其它類型值(如布爾或數(shù)字)不應(yīng)該使用雙引號。

扁平化數(shù)據(jù) VS 結(jié)構(gòu)層次

不能為了方便而將數(shù)據(jù)任意分組

JSON中的數(shù)據(jù)元素應(yīng)以_扁平化_方式呈現(xiàn)。不能為了方便而將數(shù)據(jù)任意分組。

在某些情況下,比如描述單一結(jié)構(gòu)的一批屬性,因為它被用來保持結(jié)構(gòu)層次,因而是有意義的。但是遇到這些情況還是應(yīng)當(dāng)慎重考慮,記住只有語義上有意義的時候才使用它。例如,一個地址可以有表示兩種方式,但結(jié)構(gòu)化的方式對開發(fā)人員來講可能更有意義:

扁平化地址:

{
  "company": "Google",
  "website": "http://www.google.com/",
  "addressLine1": "111 8th Ave",
  "addressLine2": "4th Floor",
  "state": "NY",
  "city": "New York",
  "zip": "10011"
}

結(jié)構(gòu)化地址:

{
  "company": "Google",
  "website": "http://www.google.com/",
  "address": {
    "line1": "111 8th Ave",
    "line2": "4th Floor",
    "state": "NY",
    "city": "New York",
    "zip": "10011"
  }
}
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號