Json對象是Name Value對(即子元素)的無序集合，相當于一個Map對象。JsonObject類是bantouyan-json庫對Json對象的抽象，提供操縱Json對象的各種方法。本文就介紹如何操縱JsonObject類。

一、創建JsonObject實例

創建JsonObject實例有兩類方法，一是利用超類Json的靜態方法parseJsonText、parseJsonReader與parseJavaMap獲取JsonObject實例，二是直接利用JsonObject類的構造方法創建JsonObject實例。

根據傳入的參數不同，parseJsonText返回一個JsonObject實例或JsonArray實例，利用parseJsonText方法的示例代碼如下：

Java代碼

String jsonText = "{'name1': 'value1', 'name2': 'value2'}";     
JsonObject jobj = (JsonObject)Json.parseJsonText(jsonText);    

parseJsonText返回的是一個Json類變量，所以要使用強制類型轉換。

parseJsonReader負責從Reader類型參數內讀取Json文本流，然后轉換為Json實例，與parseJsonText一樣，返回值需要強制類型轉換。

方法parseJavaMap直接返回JsonObject變量，不用類型轉換，示例代碼如下：

Java代碼

HashMap map = new HashMap();     
map.put("nameA", "valueA");      
map.put("nameB", "valueB");      
JsonObject jobj = Json.parseJavaMap(map);   

如果Map內有復雜的對象需要解析，可以用parseJavaMap的重載版本parseJavaMap(Map, JsonParser)來處理(JsonParser的使用參考解析Json——Json類的靜態方法的第五部分)。

JsonObject類的構造函數有四個重載版本：JsonObject()、JsonObject(int)、JsonObject(Map)與JsonObject(Map, JsonParser)。不帶參數與帶整型參數的重載版本都構造一個空的JsonObject實例，所不同的是帶整型參數的重載版本能夠指定JsonObject初始容量的大小，以避免不必要的重新分配內存。重載版本JsonObject(Map)與JsonObject(Map, JsonParser)的使用類似于Json類的靜態方法parseJavaMap。

二、給JsonObject添加子元素

給JsonObject實例添加子元素調用方法add或addAll。bantouyan-json庫規定，方法add與addAll都不能添加Name為null的子元素，也不能添加與已有子元素Name相同的子元素，否則會拋出異常。

方法add有七種重載版本，方法addAll有三種重載版本，分別使用于不同的情況。

三、變更JsonObject子元素的Value

要改變JsonObject子元素的Value可以調用方法set與setAll。這兩個方法都忽略Name為null的子元素，如果存在Name相同的子元素，則更改這個子元素的Value，否則添加一個新的子元素。

方法set也有七種重載版本，addAll有三種重載版本，分別適用于不同的情況。

四、獲取與檢測JsonObject子元素

JsonObject的每個子元素的Value都是一個Json實例，可以用方法get(String)獲取這個實例。至于這個實例的類型，除可以調用方法getType()獲得外，還可以通過JsonObject對方法getType的重載版本getType(String)獲取(String為子元素的Name)。

利用方法getString(String)可以獲取指定Name的子元素Value的字符串值，如果子元素的Value是JsonPrimitive實例，則返回這個實例值對應的字符串(不帶引號與轉義符)，否則返回對應的標準Json文本。

如果想獲取子元素的Value所對應的boolean、double、long、JsonArray與JsonObject類型的值，則可以分別調用方法getBoolean(String)、getDouble(String)、getLong(String)、getJsonArray(String)與getJsonObject(String)。與getString方法不一樣的是當子元素的Value無法轉換為相應的類型時會拋出異常。方法canToBoolean(String)、canToDouble(String)、canToLong(String)、canToJsonArray(String)與canToJsonObject(String)可以檢測是否可以轉換為對應的類型。

以特定的類型獲取子元素的Value時，方法canToXXX返回true并不表明子元素的Value就是所測試的類型。根據bantouyan-json庫設計，如果子元素的Value的類型是INTEGER，則可以得到對應的double類型的值，如果類型時String，對于部分Value，可以得到對應的boolean、long、double類型的值。

五、確定JsonObject子元素是否存在

在獲取子元素前可能無法確定JsonObject是否包含指定Name的子元素，要確定子元素存在，請調用方法containsName(String)。

六、刪除JsonObject子元素

刪除JsonObject的子元素調用方法remove(String)，參數為要刪除的子元素的Name。

七、獲取JsonObject子元素相關的集合

與Map一樣，JsonObject也是由無序的Name Value對構成，為此，JsonObject實現了三個方法用于獲取子元素相關的集合。

entrySet()，返回由子元素的Name Value對構成的集合。

nameSet()，返回由子元素的Name構成的集合。

values()，返回由子元素的Value構成的集合。

【編輯推薦】

1. JSON數據在J2ME下的構造和解析
2. 深入了解J2ME Polish+Eclipse配置過程
3. 探究J2ME中cookie庫的管理
4. 術語匯編 J2ME 3D技術簡介
5. 解析Linux下如何用eclipse搭建J2ME開發環境