android json详细解析

• 博客分类：
• android

json android

json相关参考
json规范rfc4627： http://www.ietf.org/rfc/rfc4627.txt
json介绍： http://www.json.org/json-zh.html
json入门参考： http://www.cnblogs.com/Truly/archive/2006/12/31/608896.html

android2.3提供的json解析类
android的json解析部分都在包org.json下，主要有以下几个类：
JSONObject：可以看作是一个json对象
JSONStringer：json文本构建类
JSONArray：可以看作是json的数组
JSONTokener：json解析类
JSONException：json中用到的异常

JSONObject, JSONArray来构建json文本

Java代码  

1. // 假设现在要创建这样一个json文本   
2. //  {   
3. //      "phone" : ["12345678", "87654321"], // 数组   
4. //      "name" : "yuanzhifei89", // 字符串   
5. //      "age" : 100, // 数值   
6. //      "address" : { "country" : "china", "province" : "jiangsu" }, // 对象   
7. //      "married" : false // 布尔值   
8. //  }   
9.   
10. try {   
11.     // 首先最外层是{}，是创建一个对象   
12.     JSONObject person = new JSONObject();   
13.     // 第一个键phone的值是数组，所以需要创建数组对象   
14.     JSONArray phone = new JSONArray();   
15.     phone.put("12345678").put("87654321");   
16.     person.put("phone", phone);   
17.   
18.     person.put("name", "yuanzhifei89");   
19.     person.put("age", 100);   
20.     // 键address的值是对象，所以又要创建一个对象   
21.     JSONObject address = new JSONObject();   
22.     address.put("country", "china");   
23.     address.put("province", "jiangsu");   
24.     person.put("address", address);   
25.   
26.     person.put("married", false);   
27. } catch (JSONException ex) {   
28.     // 键为null或使用json不支持的数字格式(NaN, infinities)   
29.     throw new RuntimeException(ex);   
30. }  

// 假设现在要创建这样一个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也是将要获取的键的值转换为指定的类型，无法转换或没有值时返回用户提供或这默认提供的值

Java代码  

1. try {   
2.     // 所有使用的对象都是用上面创建的对象   
3.     // 将第一个电话号码转换为数值和将名字转换为数值   
4.     phone.getLong(0);   
5.     person.getLong("name"); // 会抛异常，因为名字无法转换为long   
6.        
7.     phone.optLong(0); // 代码内置的默认值   
8.     phone.optLong(0, 1000); // 用户提供的默认值   
9.     person.optLong("name");   
10.     person.optLong("name", 1000); // 不像上面那样抛异常，而是返回1000   
11. } catch (JSONException ex) {   
12.     // 异常处理代码   
13. }  

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代码  

1. try {   
2.     JSONStringer jsonText = new JSONStringer();   
3.     // 首先是{，对象开始。object和endObject必须配对使用   
4.     jsonText.object();   
5.        
6.     jsonText.key("phone");   
7.     // 键phone的值是数组。array和endArray必须配对使用   
8.     jsonText.array();   
9.     jsonText.value("12345678").value("87654321");   
10.     jsonText.endArray();   
11.        
12.     jsonText.key("name");   
13.     jsonText.value("yuanzhifei89");   
14.     jsonText.key("age");   
15.     jsonText.value(100);   
16.        
17.     jsonText.key("address");   
18.     // 键address的值是对象   
19.     jsonText.object();   
20.     jsonText.key("country");   
21.     jsonText.value("china");   
22.     jsonText.key("province");   
23.     jsonText.value("jiangsu");   
24.     jsonText.endObject();   
25.        
26.     jsonText.key("married");   
27.     jsonText.value(false);   
28.        
29.     // }，对象结束   
30.     jsonText.endObject();   
31. } catch (JSONException ex) {   
32.     throw new RuntimeException(ex);   
33. }  

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();

Java代码  

1. //  {   
2. //      "phone" : ["12345678", "87654321"], // 数组   
3. //      "name" : "yuanzhifei89", // 字符串   
4. //      "age" : 100, // 数值   
5. //      "address" : { "country" : "china", "province" : "jiangsu" }, // 对象   
6. //      "married" : false // 布尔值   
7. //  }   
8.   
9. private static final String JSON =    
10. "{" +   
11.     "   \"phone\" : [\"12345678\", \"87654321\"]," +   
12.     "   \"name\" : \"yuanzhifei89\"," +   
13.     "   \"age\" : 100," +   
14.     "   \"address\" : { \"country\" : \"china\", \"province\" : \"jiangsu\" }," +   
15.     "   \"married\" : false," +   
16. "}";   
17.   
18. try {   
19.     JSONTokener jsonParser = new JSONTokener(JSON);   
20.     // 此时还未读取任何json文本，直接读取就是一个JSONObject对象。   
21.     // 如果此时的读取位置在"name" : 了，那么nextValue就是"yuanzhifei89"（String）   
22.     JSONObject person = (JSONObject) jsonParser.nextValue();   
23.     // 接下来的就是JSON对象的操作了   
24.     person.getJSONArray("phone");   
25.     person.getString("name");   
26.     person.getInt("age");   
27.     person.getJSONObject("address");   
28.     person.getBoolean("married");   
29. } catch (JSONException ex) {   
30.     // 异常处理代码   
31. }  

//	{
//		"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文本中的文本的

Java代码  

1. try {   
2.     JSONTokener jsonParser = new JSONTokener(JSON);   
3.     // 继续向下读8个json文本中的字符。此时刚开始，即在{处   
4.     jsonParser.next(8); //{    "phone。tab算一个字符   
5.        
6.     // 继续向下读1个json文本中的字符   
7.     jsonParser.next(); //"   
8.        
9.     // 继续向下读取一个json文本中的字符。该字符不是空白、同时也不是注视中的字符   
10.     jsonParser.nextClean(); //:   
11.        
12.     // 返回当前的读取位置到第一次遇到'a'之间的字符串（不包括a）。   
13.     jsonParser.nextString('a'); //  ["12345678", "87654321"],    "n（前面有两个空格）   
14.        
15.     // 返回当前读取位置到第一次遇到字符串中(如"0089")任意字符之间的字符串，同时该字符是trimmed的。（此处就是第一次遇到了89）   
16.     jsonParser.nextTo("0089"); //me" : "yuanzhifei   
17.        
18.     // 读取位置撤销一个   
19.     jsonParser.back();   
20.     jsonParser.next(); //i   
21.        
22.     // 读取位置前进到指定字符串处（包括字符串）   
23.     jsonParser.skipPast("address");   
24.     jsonParser.next(8); //" : { "c   
25.        
26.     // 读取位置前进到执行字符处（不包括字符）   
27.     jsonParser.skipTo('m');   
28.     jsonParser.next(8); //married"   
29. } catch (JSONException ex) {   
30.     // 异常处理代码   
31. }  

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中的null和java中的null注意：

Java代码  

1. // json对象的成员为null可能有两种情况：   
2. // 1: 不出现该成员的名称（对应java中的null）   
3. // 2: 成员值为null。（对应java中的JSONObject.NULL）   
4.   
5. // 完整的Json   
6. //  {     
7. //      "phone" : ["12345678", "87654321"], // 数组     
8. //      "name" : "yuanzhifei89", // 字符串     
9. //      "age" : 100, // 数值     
10. //      "address" : { "country" : "china", "province" : "jiangsu" }, // 对象     
11. //      "married" : false // 布尔值     
12. //  }     
13.   
14. // 第一种情况：不出现某成员的名称(address)   
15. String jsonText = "{" +     
16.     "   \"phone\" : [\"12345678\", \"87654321\"]," +     
17.     "   \"name\" : \"yuanzhifei89\"," +     
18.     "   \"age\" : 100," +     
19.     "   \"married\" : false," +     
20. "}";    
21.   
22. try {   
23.     JSONTokener t = new JSONTokener(jsonText);   
24.     JSONObject obj = (JSONObject) t.nextValue();   
25.     if (obj.optJSONObject("address") == null || obj.isNull("address")) {   
26.     }   
27. } catch (JSONException ex) {   
28.     ex.printStackTrace();   
29. }   
30.   
31. // 第二种情况：成员值为null(address为null)   
32. String jsonText = "{" +     
33.     "   \"phone\" : [\"12345678\", \"87654321\"]," +     
34.     "   \"name\" : \"yuanzhifei89\"," +     
35.     "   \"age\" : 100," +     
36.     "   \"address\" : null," +     
37.     "   \"married\" : false," +     
38. "}";    
39. try {   
40.     JSONTokener t = new JSONTokener(jsonText);   
41.     JSONObject obj = (JSONObject) t.nextValue();   
42.        
43.     // 应该这样判断json是否为null   
44.     if (obj.get("address") == JSONObject.NULL || obj.isNull("address")) {   
45.     }   
46. } catch (JSONException ex) {   
47.     ex.printStackTrace();   
48. }  

// json对象的成员为null可能有两种情况：
// 1: 不出现该成员的名称（对应java中的null）
// 2: 成员值为null。（对应java中的JSONObject.NULL）

// 完整的Json
//  {  
//      "phone" : ["12345678", "87654321"], // 数组  
//      "name" : "yuanzhifei89", // 字符串  
//      "age" : 100, // 数值  
//      "address" : { "country" : "china", "province" : "jiangsu" }, // 对象  
//      "married" : false // 布尔值  
//  }  

// 第一种情况：不出现某成员的名称(address)
String jsonText = "{" +  
    "   \"phone\" : [\"12345678\", \"87654321\"]," +  
    "   \"name\" : \"yuanzhifei89\"," +  
    "   \"age\" : 100," +  
    "   \"married\" : false," +  
"}"; 

try {
    JSONTokener t = new JSONTokener(jsonText);
    JSONObject obj = (JSONObject) t.nextValue();
    if (obj.optJSONObject("address") == null || obj.isNull("address")) {
    }
} catch (JSONException ex) {
    ex.printStackTrace();
}

// 第二种情况：成员值为null(address为null)
String jsonText = "{" +  
    "   \"phone\" : [\"12345678\", \"87654321\"]," +  
    "   \"name\" : \"yuanzhifei89\"," +  
    "   \"age\" : 100," +  
    "   \"address\" : null," +  
    "   \"married\" : false," +  
"}"; 
try {
    JSONTokener t = new JSONTokener(jsonText);
    JSONObject obj = (JSONObject) t.nextValue();
    
    // 应该这样判断json是否为null
    if (obj.get("address") == JSONObject.NULL || obj.isNull("address")) {
    }
} catch (JSONException ex) {
    ex.printStackTrace();
}

json中的对象不存在和java中的对应关系

Java代码  

1. json中的null对应java中的JSONObject.NULL，所以jsonObj.put("key", JSONObject.NULL) 相当于{"key" : null}   
2.   
3. json中的不出现某成员对应Java中的null，所以jsonObj.put("key", null)相当于删除该成员，即：{}