Android 基础总结：（二十二）JSON详解（上）

本文链接：https://blog.youkuaiyun.com/wenwins/article/details/51611423

Android Json 基础

1、JSON(JavaScript Object Notation) 定义：

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

2、JSON的结构：

(1) Name/Value Pairs（无序的）：类似所熟知的Keyed list、 Hash table、Disctionary和Associative array。在Android平台中同时存在另外一个类"Bundle"，某种程度上具有相似的行为。

(2) Array（有序的）：一组有序的数据列表。

对象

对象是一个无序的Name/Value Pairs集合。{ name:value, name:value, name:value .... }

例子：{ "name":"小猪","age":20 }

Array

Array是值（value）的有序集合。[ value , value , value ...... ] 值（value）可以是双引号括起来的字符串（string）、数值(number)、true、false、 null、对象（object）或者数组（array）。这些结构可以嵌套。

字符串（string）是由双引号包围的任意数量Unicode字符的集合，使用反斜线转义。一个字符（character）即一个单独的字符串（character string）。例如：\ + " \ / b f n r t u 进行转义。

例子1： Array里面包含对象(object)

[ {"id":1,"name":"小猪" ,"age”:22} , {"id":2,"name":"小猫","age”:23} , .......]

例子2：同样对象(object)中可以包含Array

（1）一个对象包含1个数组，2个子对象

[java]view plaincopy 
    
print?
 {"root":[{"id":"001","name":"С??"},{"id":"002","name":"Сè"},{"id":"003","name":"С??"}],  
 "total":3,  
 "success":true  
 }  

（2）也可以对象嵌套子对象，子对象再嵌套数组

[java]view plaincopy 
    
print?
 {"calendar":   
     {"calendarlist":  
             [  
             {"id":"001","name":"С??"},  
             {"id":"002","name":"Сè"}  
             ]  
     }   
 }  

总之，格式多种多样，可以互相嵌套。

在Android中包含四个与JSON相关的类和一个Exceptions：

JSONArray

JSONObject

JSONStringer

JSONTokener

JSONException

（1）JSONObject:

这是系统中有关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。

有两个不同的取值方法：

get(): 在确定数值存在的条件下使用，否则当无法检索到相关Key时，将会抛出一个Exception信息。

opt(): 这个方法相对比较灵活，当无法获取所指定数值时，将会返回一个默认数值，并不会抛出异常。

（2）JSONArray:

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

同样这个类的value类型可以包括：Boolean、JSONArray、JSONObject、Number、String或者默认值JSONObject.NULL object。

（3）JSONStringer:

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

根据下边的实例来了解其它相关信息：

[java]view plaincopy 
    
print?
 String myString = new JSONStringer().object().key("name").value("小猪").endObject().toString();  

结果是一组标准格式的JSON text：{"name" : "小猪"}

其中的.object()和.endObject()必须同时使用，是为了按照Object标准给数值添加边界。同样，针对数组也有一组标准的方法来生成边界.array()和.endArray()。

（4）JSONTokener:

这个是系统为JSONObject和JSONArray构造器解析JSON source string的类，它可以从source string中提取数值信息。

JSONException:是JSON.org类抛出的异常信息。

下面引用一个完整的应用实例：

应用JSONObject存储Map类型数值：

[java]view plaincopy 
    
print?
 public static JSONObject getJSON(Map map) {  
     Iterator iter = map.entrySet().iterator();  
     JSONObject holder = new JSONObject();  
     while (iter.hasNext()) {  
         Map.Entry pairs = (Map.Entry) iter.next();  
         String key = (String) pairs.getKey();  
         Map m = (Map) pairs.getValue();  
         JSONObject data = new JSONObject();  
         try {  
             Iterator iter2 = m.entrySet().iterator();  
             while (iter2.hasNext()) {  
                 Map.Entry pairs2 = (Map.Entry) iter2.next();  
                 data.put((String) pairs2.getKey(),  
                         (String) pairs2.getValue());  
             }  
             holder.put(key, data);  
         } catch (JSONException e) {  
             Log.e("Transforming", "There was an error packaging JSON", e);  
         }  
     }  
     return holder;  
 }  
 public static JSONObject getJSON(Map map) {  
     Iterator iter = map.entrySet().iterator();  
     JSONObject holder = new JSONObject();  
     while (iter.hasNext()) {  
         Map.Entry pairs = (Map.Entry) iter.next();  
         String key = (String) pairs.getKey();  
         Map m = (Map) pairs.getValue();  
         JSONObject data = new JSONObject();  
         try {  
             Iterator iter2 = m.entrySet().iterator();  
             while (iter2.hasNext()) {  
                 Map.Entry pairs2 = (Map.Entry) iter2.next();  
                 data.put((String) pairs2.getKey(),  
                         (String) pairs2.getValue());  
             }  
             holder.put(key, data);  
         } catch (JSONException e) {  
             Log.e("Transforming", "There was an error packaging JSON", e);  
         }  
     }  
     return holder;  
 }  

Json写入类-JsonWriter

在Android中新增了一个JSON写入类android.util.JsonWriter，使用JsonWriter可以轻松的生成JSON格式的数据，比如下面的JSON数据为：

[java]view plaincopy 
     
print?
 {  
 　　"id": 912345678901,  
 　　"text": "How do I write JSON on Android?",  
 　　"geo": null,  
 　　"user": {  
     　　"name": "android_newb",  
     　　"followers_count": 41  
 　　},  
 　　{  
     　　"id": 912345678902,  
     　　"text": "@android_newb just use android.util.JsonWriter!",  
     　　"geo": [50.454722, -104.606667],  
     　　"user": {  
         　　"name": "jesse",  
         　　"followers_count": 2  
     　　}  
 　　}  
 }  

上面的JSON数据在Android honeycomb上的写入代码为

[java]view plaincopy 
     
print?
 public void writeJsonStream(OutputStream out, List messages)  
         throws IOException {  
     JsonWriter writer = new JsonWriter(new OutputStreamWriter(out, "UTF-8"));  
     // Android开发网提示这是UTF-8编码  
     writer.setIndent(" ");  
     writeMessagesArray(writer, messages);  
     writer.close();  
 }  
 public void writeMessagesArray(JsonWriter writer, List messages)  
         throws IOException {  
     writer.beginArray();  
     for (Message message : messages) {  
         writeMessage(writer, message);  
     }  
     writer.endArray();  
 }  
 public void writeMessage(JsonWriter writer, Message message)  
         throws IOException {  
     writer.beginObject();  
     writer.name("id").value(message.getId());  
     writer.name("text").value(message.getText());  
     if (message.getGeo() != null) {  
         writer.name("geo");  
         writeDoublesArray(writer, message.getGeo());  
     } else {  
         writer.name("geo").nullValue();  
     }  
     writer.name("user");  
     writeUser(writer, message.getUser());  
     writer.endObject();  
 }  
 {  
     writer.beginObject();  
     writer.name("name").value(user.getName());  
     writer.name("followers_count").value(user.getFollowersCount());  
     writer.endObject();  
 }  
 public void writeDoublesArray(JsonWriter writer, List doubles)  
         throws IOException {  
     writer.beginArray();  
     for (Double value : doubles) {  
         writer.value(value);  
     }  
     writer.endArray();  
 }  