一 概述

1.1 什么是 JSON

JSON是JavaScript Object Notation的簡稱，中文含義為“JavaScript 對象表示法”，它是一種數據交換的文本格式，而不是一種編程語言。

JSON 是一種輕量級的數據交換格式，它基于 ECMAScript (w3c制定的js規范)的一個子集，采用完全獨立于編程語言的文本格式來存儲和表示數據。簡潔和清晰的層次結構使得 JSON 成為理想的數據交換語言。

JSON之所以受歡迎，主要是因為它仍然使用 JavaScript 語法來描述數據對象，并沒有改變開發人員的使用習慣，這更容易被開發人員接受。由于這種相似性，JavaScript 程序就無需解析器，便可以直接用 JSON 數據來生成原生的 JavaScript 對象。

1.2 JSON 的特點

JSON 主要具有以下特性，這些特性使它成為理想的數據交換語言：

• JSON 是輕量級的文本數據交換格式

• JSON 具有自我描述性，更易理解

• JSON 采用完全獨立于語言的文本格式：JSON 使用 JavaScript 語法來描述數據對象，但是 JSON 仍然獨立于語言和平臺。JSON 解析器和 JSON 庫支持許多不同的編程語言。目前常見的動態編程語言（PHP，JSP，.NET）都支持JSON。

• JSON 是存儲和交換文本信息的一種語法，它與XML具有相同的特性，是一種數據存儲格式，卻比 XML 更小、更快、 更易于人編寫和閱讀、更易于生成和解析。

類似于 XML 的特性：

• JSON 是純文本

• JSON 具有“自我描述性”（人類可讀）

• JSON 具有層級結構（值中存在值）

• JSON 可通過 JavaScript 進行解析

• JSON 數據可使用 AJAX 進行傳輸

相比 XML 的不同之處：

• 沒有結束標簽

• 更短

• 讀寫的速度更快

• 能夠使用內建的 JavaScript eval() 方法進行解析

• 使用數組

• 不使用保留字

二 JSON語法

在 JavaScript 語言中，一切皆對象。任何支持的類型，如字符串、數值、對象、數組等，都可以通過 JSON 來表示。

JSON 語法是 JavaScript 對象表示法的子集：

• 數據在鍵/值對中，鍵/值對可以嵌套

• 數據由逗號分隔

• 花括號保存對象，對象可以包含多個鍵/值對

• 方括號保存數組，數組可以包含多個對象

• JSON不是JavaScript語句，對象的末尾沒有分號，對象和數組的最后一個成員后面，也不能加逗號。

2.1 JSON 鍵/值對

JSON鍵/值對由鍵和值組成，鍵必須是字符串，值可以是字符串（string）、數值(number) 、對象（object）、數組（array）、true、false、 null。如圖所示：

在定義JSON鍵/值時，先是鍵名，后面寫一個冒號，然后是值。如：

"github": "https://github.com/leiqikui"

這就等價于這條 JavaScript 語句：

github = "https://github.com/leiqikui"

2.2 JSON 字符串

JSON 的字符串（string）跟C或者Java的字符串非常相似，是由雙引號包圍的任意數量Unicode字符的集合，使用反斜線轉義。如圖所示：

由于JSON 字符串不能使用單引號，因此一個字符（character）就是一個單獨的字符串（character string）。

2.3 JSON 數值

JSON 數值（number）與C或者Java的數值非常相似，支持整型、浮點型，浮點型也可以用指數表示。如圖所示：

JSON不支持八進制和十六進制， 數值必須以十進制表示，且不能使用NaN和Infinity。以下是合法的JSON數值：

{ "age": 30 }

2.4 JSON 對象

JSON 對象是一個無序的key/value對的集合。一個對象以 '{' 開始，以 '}' 結束；每個key 和 value 中使用冒號分隔；每個 key/value 對之間使用逗號分隔。如圖 14所示：

JSON 對象語法：

• 對象在大括號({})中書寫。

• 對象可以包含多個 key/value（鍵/值）對。

• key是字符串，必須放在雙引號里面。value 可以是合法的 JSON 數據類型（字符串, 數值, 對象, 數組, 布爾值或 null）。

• 一個 key/value 對內部，key 和 value使用冒號(:)分隔。

• key/value 對之間，使用逗號(,)分隔。

• 對象可以嵌套

2.5 JSON 數組

數組是值（value）的有序集合。一個數組以“[”（左中括號）開始，“]”（右中括號）結束。值之間使用“,”（逗號）分隔。如圖 15所示：

JSON 數組：

• 數組在中括號中書寫。

• 數組的值必須是合法的 JSON 數據類型（字符串, 數值, 對象, 數組, 布爾值或 null），也可以是 JavaScript 的表達式，包括函數、日期、undefined。

2.6 JSON 布爾值

JSON 布爾值可以是 true 或者 false。如：

{ "flag":true }

2.7 JSON null

JSON 可以設置 null 值。如：

{ "zhihu":null }

2.8 JSON 文件

JSON 文件的文件類型是 ".json"

JSON 文本的 MIME 類型是 "application/json"

三 JSON協議組件的使用

1 Gitee鏈接地址

組件位于amaziot_bloom_os_sdk\libraries\am\xtu\am_json.c

Gitee源碼地址：
https://gitee.com/ning./hongdou

Github源碼地址：
https://github.com/ayumid/hongdou