Android json解析及简单例子
JSON的定义:
一 种轻量级的数据交换格式,具有良好的可读和便于快速编写的特性。业内主流技术为其提供了完整的解决方案(有点类似于正则表达式 ,获得了当今大部分语言的 支持),从而可以在不同平台间进行数据交换。JSON采用兼容性很高的文本格式,同时也具备类似于C语言体系的行为。 – Json.org
JSON Vs XML
1.JSON和XML的数据可读性基本相同
2.JSON和XML同样拥有丰富的解析手段
3.JSON相对于XML来讲,数据的体积小
4.JSON与JavaScript的交互更加方便
5.JSON对数据的描述性比XML较差
6.JSON的速度要远远快于XML
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文本
代码:
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 person.put("married", false); 26 } catch (JSONException ex) { 27 // 键为null或使用json不支持的数字格式(NaN, infinities) 28 throw new RuntimeException(ex); 29 }
getType和optType api的使用
getType可以将要获取的键的值转换为指定的类型,如果无法转换或没有值则抛出JSONException
optType也是将要获取的键的值转换为指定的类型,无法转换或没有值时返回用户提供或这默认提供的值
1 try { 2 // 所有使用的对象都是用上面创建的对象 3 // 将第一个电话号码转换为数值和将名字转换为数值 4 phone.getLong(0); 5 person.getLong("name"); // 会抛异常,因为名字无法转换为long 6 phone.optLong(0); // 代码内置的默认值 7 phone.optLong(0, 1000); // 用户提供的默认值 8 person.optLong("name"); 9 person.optLong("name", 1000); // 不像上面那样抛异常,而是返回1000 10 } catch (JSONException ex) { 11 // 异常处理代码 12 }
除了上面的两个类,还可以使用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 }
json文本解析类JSONTokener
按照RFC4627规范将json文本解析为相应的对象。
对于将json文本解析为对象,只需要用到该类的两个api:
构造函数
public Object nextValue();
代码
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 }
其它的api基本就是用来查看json文本中的文本的
代码
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 }
-----------------分割线------------------------------------------------------------
源代码:https://github.com/douglascrockford/JSON-java
json 的 API 很容易理解,很容易使用。这得益于 json 的数据组织形式,更得益于API代码的简洁!
如同《Clean Code》里写得一样,阅读简洁的代码会让你感觉在阅读一首诗歌!
我只是粗略浏览了源代码,很是赞叹代码的优雅,吾当学习之!
要写出简洁的代码先从阅读简洁的代码开始!