JSON用法小結(jié)

Android入行多年,用起JSON依然是捉襟見肘,無法手到擒來的感覺實(shí)在是讓自己汗顏。于是決定把JSON從頭到尾總結(jié)一遍。這里很多是根據(jù)網(wǎng)絡(luò)上現(xiàn)有的資料進(jìn)行的總結(jié)。

什么是JSON

JavaScrip Object Notation,JS對(duì)象標(biāo)記,簡(jiǎn)寫成JSON。

網(wǎng)絡(luò)上無法直接傳遞結(jié)構(gòu)復(fù)雜的數(shù)據(jù),需要把這些復(fù)雜的結(jié)構(gòu)轉(zhuǎn)換為簡(jiǎn)單結(jié)構(gòu)。JSON就是一套簡(jiǎn)單的格式規(guī)范,把復(fù)雜的數(shù)據(jù)結(jié)構(gòu)轉(zhuǎn)換成最簡(jiǎn)單的字符串。

在JSON之前,網(wǎng)絡(luò)上大家使用XML的格式來傳遞數(shù)據(jù)。但是XML格式比較復(fù)雜,后來就出現(xiàn)了輕量化的JSON替代了XML。

JSON的字符集必須是utf-8。所以不存在跨平臺(tái)的問題。

JSON只有6種數(shù)據(jù)類型:

  • number: 數(shù)值,包括整型、浮點(diǎn)型
  • string: 字符串
  • boolean: 布爾值,true和false
  • null: 等同于Java的null
  • array: 數(shù)組
  • object: JSON對(duì)象,它是以上五種類型的組合

JSON的構(gòu)成規(guī)則:

  • 數(shù)據(jù)在鍵值對(duì)中
  • 數(shù)據(jù)用逗號(hào)隔開
  • 花括號(hào)表示對(duì)象
  • 方括號(hào)表示數(shù)組
  • 雙引號(hào)表示字符
  • 鍵值對(duì)里的key用雙引號(hào)包含
  • 6種基本類型可以任意組合

JSON實(shí)例

{
    "name" : "xiaoming",
    "age" : 18,
    "marriage" : false,

    "nickname" : [  // 字符串?dāng)?shù)組
        "ming",
        "dong",
        "zhuzi"
    ],

    "bookList": [  // 對(duì)象數(shù)組
        {"title" : "Pride and Prejudice",   "price" : 20},
        {"title" : "History of the America",   "price" : 40}
    ]        
}

數(shù)組里的值,可以是基本類型中的任意一種。bookList里是JSON object的列表(數(shù)組)。

Map在JSON里長(zhǎng)什么樣呢?不是array,是一個(gè)普通的object

{
    "mapExample": {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3",
   }
}

經(jīng)典的狀態(tài)機(jī)表示法

JSON object

JSON array

JSON string

JSON number

如何使用JSON

JSON的形態(tài)

JSON本質(zhì)上是一串utf-8編碼的符合Json格式的字符。『JSON』這個(gè)詞,廣義上是指這串字符及其用法;狹義上就是指這串字符。JSON的形態(tài),描述的是狹義上,也就是JSON字符串的形態(tài)。對(duì)于我們這些需要去處理它的人來說,它存在兩種狀態(tài):

  1. 靜態(tài)的字符串
  2. 格式化后對(duì)應(yīng)的數(shù)據(jù)結(jié)構(gòu)

我們經(jīng)常需要在這兩種狀態(tài)之間進(jìn)行轉(zhuǎn)換。比如,將某個(gè)數(shù)據(jù)結(jié)構(gòu)轉(zhuǎn)成JSON字符串;或者從某個(gè)JSON字符串中讀取某個(gè)字段。從1到2的過程,稱之為『進(jìn)』;從2到1,稱之為『出』。JSON的用法,就是圍繞著這兩個(gè)狀態(tài)展開說明。

下面只介紹Java類庫的JSON包和Google的Gson。

Java上的JSON包

org.json包,有以下幾個(gè)主要類:

  • JSONObject:它能夠從JSON字符串中解析出里面的元數(shù)據(jù);或者把元數(shù)據(jù)組裝成JSON字符串。
  • JSONArray:它是JSONObject的一個(gè)子集,只處理JSON array相關(guān)的數(shù)據(jù)。
  • JSONTokener:
  • JSONPointer
  • JSONString
  • JSONStringer
  • JSONWriter

最常用的是JSONObject和JSONArray,它們能滿足日常需求。這兩者本身就是格式化后的數(shù)據(jù)結(jié)構(gòu)的代表,存儲(chǔ)的是格式化后的數(shù)據(jù)。下面只介紹這兩個(gè)的用法,其它的以后有時(shí)間再展開。

JSONObject的進(jìn)

JSONObject就是JSON基本里的Object,它只支持以花括號(hào)({})開頭和結(jié)尾的字符串。它包含其它類型以及自己。它的『進(jìn)』有兩種方式:

  1. JSONObject的構(gòu)造函數(shù)
  2. JSONObject的put方法

構(gòu)造函數(shù)里傳入符合JSON格式的字符串,得到格式化后的數(shù)據(jù),例如:

new JSONObject(jsonStr);

put方法用來增加數(shù)據(jù)。它增加基本類型很直觀,直接放進(jìn)去就好了。Object類型需要注意。放進(jìn)去的值是Object.toString后的值。所以如果是一個(gè)普通的Java的Object,那么值就是這個(gè)對(duì)象的類名(除非重寫toString方法)。如果傳入的是JSONObject或者JSONArray類型的Object,這兩者的toString得到的值就是JSON字符串。

JSONObject的put方法

通過構(gòu)造函數(shù)生成JSONObject后,還可以繼續(xù)用put方法增加數(shù)據(jù)(新字段)和修改數(shù)據(jù)(原有字段)。

JSONObject是格式化后的結(jié)構(gòu),因此可以方便地取出其中的數(shù)據(jù)。

  • get方法
  • opt方法

兩者的區(qū)別是,get方法會(huì)拋出異常,opt方法不會(huì),并且可以使用默認(rèn)值。

JSONObject的get方法
JSONObject的opt方法

JSONObject的出

轉(zhuǎn)換成靜態(tài)的Json字符串,直接使用toString方法即可。

JSONArray的進(jìn)和出

它支持各種基礎(chǔ)類型。和JSONObject類似,每個(gè)接口多index參數(shù),表示數(shù)組的位置。


JSONArray的put接口
JSONArray的get接口
JSONArray的opt接口

Android上的Gson包

Gson是Google的Json處理工具。它提供了比Java的Json工具包更強(qiáng)大和方便的功能。它的基本使用,都集中在Gson.java這個(gè)類。為了不把兩者混淆,后面用gson來表示Gson這個(gè)類。

Gson的適用性比JSONObject大,后者只支持標(biāo)準(zhǔn)格式的Json字符串。Gson可以支持單獨(dú)的Json數(shù)據(jù)類型,比如:

int intValue = gson.fromJson("128", Integer.class);  // intValue=128
Integer[] intArray = gson.fromJson("[1, 2, 4, 8, 16]", Integer[].class);  // intArray=[1, 2, 4, 8, 16]

Gson的常規(guī)用法非常簡(jiǎn)單,所有的接口都集中在gson里。gson為一個(gè)入口,非常簡(jiǎn)潔,基本上只提供了兩類方法,也就是『進(jìn)』fromJson()和『出』toJson()。

gson的『進(jìn)』

fromJson接口,從各種類型的源中直接生成所需要的數(shù)據(jù)結(jié)構(gòu)。對(duì)比JSONObject,gson更方便。前者只是做了格式化,后者不但格式化,而且生成對(duì)應(yīng)的數(shù)據(jù)結(jié)構(gòu)對(duì)象(某個(gè)具體的數(shù)據(jù)對(duì)象)。

fromJson接口

gson的『出』

toJson接口,從各種類型的格式化數(shù)據(jù)源,生成對(duì)應(yīng)的JSON字符串。同樣,對(duì)比JSONObject,gson可以直接將數(shù)據(jù)結(jié)構(gòu)對(duì)象轉(zhuǎn)成JSON字符串。前者只能手動(dòng)從數(shù)據(jù)對(duì)象中一個(gè)字段一個(gè)字段地轉(zhuǎn)成JSONObject,然后再轉(zhuǎn)成JSON字符串。


toJson接口

Gson的數(shù)據(jù)類型

Gson把JSON的六種基本數(shù)據(jù)類型進(jìn)行了封裝。基類是JsonElement。string、number和boolean這三種基本類型統(tǒng)一為JsonPrimitive。還有JsonObject、JsonArray和JsonNull。
這部分的詳細(xì)說明,后續(xù)再細(xì)化,本文會(huì)持續(xù)更新。


JsonElement結(jié)構(gòu)圖

Gson的高級(jí)用法

Gson還有很多高級(jí)的用法,比如可添加adapter,用的比較少,以后另外看一篇介紹。

參考

廖雪峰 JavaScrip教程

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容