你该知道的json解析

JSON的定义：

       一种轻量级的数据交换格式，具有良好的可读和便于快速编写的特性。业内主流技术为其提供了完整的解决方案（有点类似于正则表达式 ，获得了当今大部分语言的支持），从而可以在不同平台间进行数据交换。JSON采用兼容性很高的文本格式，同时也具备类似于C语言体系的行为。

android2.3提供的json解析类 

android的json解析部分都在包org.json下，主要有以下几个类： 

JSONObject：可以看作是一个json对象,这是系统中有关JSON定义的基本单元，以 { 开头 } 结尾，其包含一对儿(Key/Value)数值。它对外部调用的响应体现为一个标准的字符串（例如：{"JSON": "Hello, World"}，最外被大括号 { } 包裹，其中的Key和Value被冒号":"分隔）。其对于内部行为的操作格式略微，例如：初始化一个JSONObject实例，引用内部的put()方法添加数值：JSONObject jSONObject = new JSONObject()；jSONObject.put("JSON", "Hello, World!")，在Key和Value之间是以逗号","分隔。Value的类型包括：Boolean、JSONArray、JSONObject、Number、String或者默认值JSONObject.NULL object 。

JSONArray：它代表一组有序的数值。将其转换为String输出(toString)所表现的形式是用方括号 [ ] 包裹，数值以逗号”,”分隔（例如：     [value1,value2,value3]或者[{"key1":"value2"},{"key2","value2"}]，大家可以亲自利用简短的代码更加直观的了解其格式）。这个类的内部同样具有查询行为，getType()和optType()两种方法都可以通过index索引返回指定的数值，putType()方法用来添加或者替换数值。同样这个类的Type类型可以包括：Boolean、JSONArray、JSONObject、Number、String或者默认值JSONObject.NULL object。

getType可以将要获取的键的值转换为指定的类型，如果无法转换或没有值则抛出JSONException 

optType也是将要获取的键的值转换为指定的类型，无法转换或没有值时返回用户提供或这默认提供的值 

JSONStringer：json文本构建类 ，根据官方的解释，这个类可以帮助快速和便捷的创建JSON text。其最大的优点在于可以减少由于 格式的错误导致程序异常，引用这个类可以自动严格按照JSON语法规则（syntax rules）创建JSON text。每个JSONStringer实体只能对应创建一个JSON text。。其最大的优点在于可以减少由于格式的错误导致程序异常，引用这个类可以自动严格按照JSON语法规则（syntax rules）创建JSON text。每个JSONStringer实体只能对应创建一个JSON text。

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

 // 假设现在要创建这样一个json文本
 //  {
 //      "phone" : ["12345678", "87654321"], // 数组
 //      "name" : "yuanzhifei89", // 字符串
 //      "age" : 100, // 数值
 //      "address" : { "country" : "china", "province" : "jiangsu" }, // 对象
 //      "married" : false // 布尔值
 //  }
 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) {
     // 异常处理代码
 }