android2.3提供的json解析類
android的json解析部分都在包org.json下,主要有以下幾個類:
JSONObject:可以看作是一個json對象,這是系統中有關JSON定義的基本單元,其包含一對兒(Key/Value)數值。它對外部(External: 應用toString()方法輸出的數值)調用的響應體現為一個標準的字符串(例如:{"JSON": "Hello, World"},最外被大括號包裹,其中的Key和Value被冒號":"分隔)。其對於內部(Internal)行為的操作格式略微,例如:初始化一個JSONObject實例,引用內部的put()方法添加數值:new JSONObject().put("JSON", "Hello, World!"),在Key和Value之間是以逗號","分隔。Value的類型包括:Boolean、JSONArray、JSONObject、Number、String或者默認值JSONObject.NULL object 。
JSONStringer:json文本構建類 ,根據官方的解釋,這個類可以幫助快速和便捷的創建JSON text。其最大的優點在於可以減少由於 格式的錯誤導致程序異常,引用這個類可以自動嚴格按照JSON語法規則(syntax rules)創建JSON text。每個JSONStringer實體隻能對應創建一個JSON text。。其最大的優點在於可以減少由於格式的錯誤導致程序異常,引用這個類可以自動嚴格按照JSON語法規則(syntax rules)創建JSON text。每個JSONStringer實體隻能對應創建一個JSON text。
JSONArray:它代表一組有序的數值。將其轉換為String輸出(toString)所表現的形式是用方括號包裹,數值以逗號”,”分隔(例如: [value1,value2,value3],大傢可以親自利用簡短的代碼更加直觀的瞭解其格式)。這個類的內部同樣具有查詢行為, get()和opt()兩種方法都可以通過index索引返回指定的數值,put()方法用來添加或者替換數值。同樣這個類的value類型可以包括:Boolean、JSONArray、JSONObject、Number、String或者默認值JSONObject.NULL object。
JSONTokener:json解析類
JSONException:json中用到的異常
JSONObject, JSONArray來構建json文本
代碼
// 假設現在要創建這樣一個json文本
// {
// "phone" : ["12345678", "87654321"], // 數組
// "name" : "yuanzhifei89", // 字符串
// "age" : 100, // 數值
// "address" : { "country" : "china", "province" : "jiangsu" }, // 對象
// "married" : false // 佈爾值
// }
try {
// 首先最外層是{},是創建一個對象
JSONObject person = new JSONObject();
// 第一個鍵phone的值是數組,所以需要創建數組對象
JSONArray phone = new JSONArray();
phone.put("12345678").put("87654321");
person.put("phone", phone);
person.put("name", "yuanzhifei89");
person.put("age", 100);
// 鍵address的值是對象,所以又要創建一個對象
JSONObject address = new JSONObject();
address.put("country", "china");
address.put("province", "jiangsu");
person.put("address", address);
person.put("married", false);
} catch (JSONException ex) {
// 鍵為null或使用json不支持的數字格式(NaN, infinities)
throw new RuntimeException(ex);
}
getType和optType api的使用
getType可以將要獲取的鍵的值轉換為指定的類型,如果無法轉換或沒有值則拋出JSONException
optType也是將要獲取的鍵的值轉換為指定的類型,無法轉換或沒有值時返回用戶提供或這默認提供的值
代碼 try {
// 所有使用的對象都是用上面創建的對象
// 將第一個電話號碼轉換為數值和將名字轉換為數值
phone.getLong(0);
person.getLong("name"); // 會拋異常,因為名字無法轉換為long
phone.optLong(0); // 代碼內置的默認值
phone.optLong(0, 1000); // 用戶提供的默認值
person.optLong("name");
person.optLong("name", 1000); // 不像上面那樣拋異常,而是返回1000
} catch (JSONException ex) {
// 異常處理代碼
}
除瞭上面的兩個類,還可以使用JSONStringer來構建json文本
Java代碼 try {
JSONStringer jsonText = new JSONStringer();
// 首先是{,對象開始。object和endObject必須配對使用
jsonText.object();
jsonText.key("phone");
// 鍵phone的值是數組。array和endArray必須配對使用
jsonText.array();
jsonText.value("12345678").value("87654321");
jsonText.endArray();
jsonText.key("name");
jsonText.value("yuanzhifei89");
jsonText.key("age");
jsonText.value(100);
jsonText.key("address");
// 鍵address的值是對象
jsonText.object();
jsonText.key("country");
jsonText.value("china");
jsonText.key("province");
jsonText.value("jiangsu");
jsonText.endObject();
jsonText.key("married");
jsonText.value(false);
// },對象結束
jsonText.endObject();
} catch (JSONException ex) {
throw new RuntimeException(ex);
}
json文本解析類JSONTokener
按照RFC4627規范將json文本解析為相應的對象。
對於將json文本解析為對象,隻需要用到該類的兩個api:
構造函數
public Object nextValue();
代碼 // {
// "phone" : ["12345678", "87654321"], // 數組
// "name" : "yuanzhifei89", // 字符串
// "age" : 100, // 數值
// "address" : { "country" : "china", "province" : "jiangsu" }, // 對象
// "married" : false // 佈爾值
// }
private static final String JSON =
"{" +
" \"phone\" : [\"12345678\", \"87654321\"]," +
" \"name\" : \"yuanzhifei89\"," +
" \"age\" : 100," +
" \"address\" : { \"country\" : \"china\", \"province\" : \"jiangsu\" }," +
" \"married\" : false," +
"}";
try {
JSONTokener jsonParser = new JSONTokener(JSON);
// 此時還未讀取任何json文本,直接讀取就是一個JSONObject對象。
// 如果此時的讀取位置在"name" : 瞭,那麼nextValue就是"yuanzhifei89"(String)
JSONObject person = (JSONObject) jsonParser.nextValue();
// 接下來的就是JSON對象的操作瞭
person.getJSONArray("phone");
person.getString("name");
person.getInt("age");
person.getJSONObject("address");
person.getBoolean("married");
} catch (JSONException ex) {
// 異常處理代碼
}
其它的api基本就是用來查看json文本中的文本的
代碼 try {
JSONTokener jsonParser = new JSONTokener(JSON);
// 繼續向下讀8個json文本中的字符。此時剛開始,即在{處
jsonParser.next(8); //{ "phone。tab算一個字符
// 繼續向下讀1個json文本中的字符
jsonParser.next(); //"
// 繼續向下讀取一個json文本中的字符。該字符不是空白、同時也不是註視中的字符
jsonParser.nextClean(); //:
// 返回當前的讀取位置到第一次遇到'a'之間的字符串(不包括a)。
jsonParser.nextString('a'); // ["12345678", "87654321"], "n(前面有兩個空格)
// 返回當前讀取位置到第一次遇到字符串中(如"0089")任意字符之間的字符串,同時該字符是trimmed的。(此處就是第一次遇到瞭89)
jsonParser.nextTo("0089"); //me" : "yuanzhifei
// 讀取位置撤銷一個
jsonParser.back();
jsonParser.next(); //i
// 讀取位置前進到指定字符串處(包括字符串)
jsonParser.skipPast("address");
jsonParser.next(8); //" : { "c
// 讀取位置前進到執行字符處(不包括字符)
jsonParser.skipTo('m');
jsonParser.next(8); //married"
} catch (JSONException ex) {
// 異常處理代碼
}
以下是一個標準的JSON請求實現過程:
查看源碼 打印?01 HttpPost request = new HttpPost(url);
02 // 先封裝一個 JSON 對象
03 JSONObject param = new JSONObject();
04 param.put("name", "rarnu");
05 param.put("password", "123456");
06 // 綁定到請求 Entry
07 StringEntity se = new StringEntity(param.toString());
08 request.setEntity(se);
09 // 發送請求
10 HttpResponse httpResponse = new DefaultHttpClient().execute(request);
11 // 得到應答的字符串,這也是一個 JSON 格式保存的數據
12 String retSrc = EntityUtils.toString(httpResponse.getEntity());
13 // 生成 JSON 對象
14 JSONObject result = new JSONObject( retSrc);
15 String token = result.get("token");