JSON数据格式以及GSON的使用

前言

   作为一个Android开发者来说，Json数据是经常接触到的一种数据结构，并且现在越来越多的项目和开发插件等默认都会支持和使用Json数据格式,本文我们就来浅谈下Json数据结构以及Gson库的使用。

JSON数据结构

JSON的定义

   什么是Json？

1. JSON指的是 JavaScript 对象表示法（JavaScript Object Notation）；
2. JSON是轻量级的文本数据交换格式；
3. JSON独立于编程语言与平台；
4. JSON具有自我描述性，更易理解;
5. JSON 解析器和 JSON 库支持许多不同的编程语言。

JSON的两种结构

   1. “名称/值”对的集合（A collection of name/value pairs）。不同的语言中，它被理解为对象（object），记录（record），结构（struct），字典（dictionary），哈希表（hash table），有键列表（keyed list），或者关联数组 （associative array）。

   2. 值的有序列表（An ordered list of values）。在大部分语言中，它被理解为数组（array）。

   JSON具有以下这些形式：

   对象是一个无序的“‘名称/值’对”集合。一个对象以“{”（左括号）开始，“}”（右括号）结束。每个“名称”后跟一个“:”（冒号）；“‘名称/值’ 对”之间使用“,”（逗号）分隔。

   数组是值（value）的有序集合。一个数组以“[”（左中括号）开始，“]”（右中括号）结束。值之间使用“,”（逗号）分隔。

JSON实例

   简单的JSON对象如下所示：

{
"category":"普通", 
"time":"2017-05-09#17:18:55",
"content":"主楼502病人突发状况"
}

   该对象有三个属性，分别为categor、time、content，属性后面紧接着是属性的值。

   简单的JSON数组如下所示：

{
"employees":[
    {"firstName":"John", "lastName":"Doe"}, 
    {"firstName":"Anna", "lastName":"Smith"}, 
    {"firstName":"Peter", "lastName":"Jones"}
]
}

   在以上实例中，对象”employees”是一个数组。包含了三个对象，每个为个对象为员工的记录（姓和名）。

JSON与XML比较

   1. 可读性

   JSON和XML的可读性可谓不相上下，一边是简易的语法，一边是规范的标签形式，很难分出胜负。

   2. 可扩展性

   XML天生有很好的扩展性，JSON当然也有，没有什么是XML可以扩展而JSON却不能扩展的。不过JSON在Javascript主场作战，可以存储Javascript复合对象，有着XML不可比拟的优势。

   3. 工具对比

   XML有丰富的工具，比如Dom4j、JDom等，JSON也有提供的工具，如FastJson，Gson等。

   4. 两者实例对比

   用XML表示中国部分省市数据如下：

<?xml version="1.0" encoding="utf-8"?>
<country>
    <name>中国</name>
    <province>
        <name>福建</name>
        <cities>
            <city>福州</city>
            <city>厦门</city>
        </cities>
    </province>
    <province>
        <name>广东</name>
        <cities>
            <city>广州</city>
            <city>深圳</city>
            <city>珠海</city>
        </cities>
    </province>
    <province>
        <name>台湾</name>
        <cities>
            <city>台北</city>
            <city>高雄</city>
        </cities>
    </province>
</country>

   用JSON表示如下：

{
    "name": "中国",
    "province": [{
        "name": "福建",
        "cities": {
            "city": ["福州", "厦门"]
        }
    }, {
        "name": "广东",
        "cities": {
            "city": ["广州", "深圳", "珠海"]
        }
    }, {
        "name": "台湾",
        "cities": {
            "city": ["台北", "高雄"]
        }
    }]
}

GSON的使用

   通常在安卓开发中，我们常用的两种方式：一种是JSON原生的方法，即用org.json包来解析；另一种是使用谷歌提供的GSON工具来解析。下面笔者将介绍下二者的使用，例子如下所示。

{
"person":[
{"name":"zhangsan","age":20},
{"name":"lisi","age":21},
{"name":"wangwu","age":32}]
}

   对应的JavaBean如下：

public class Person {  
        private String name;  
        private int age;  

        public Person(String name, int age) {  
            super();  
            this.name = name;  
            this.age = age;  
        }  

        public String getName() {  
            return name;  
        }  

        public void setName(String name) {  
            this.name = name;  
        }  

        public int getAge() {  
            return age;  
        }  

        public void setAge(int age) {  
            this.age = age;  
        }  

        @Override  
        public String toString() {  
            return "Person [name=" + name + ", age=" + age + "]";  
        }  

    }  

使用JSON（org.json）包解析

public class JSONDEMO {  
    public static void main(String[] args) throws JSONException {  
        String str = "{person:[{name:'zhangsan',age:20},{name:'lisi',age:2},{name:'wangwu',age:3}]}";  
        List<Person> l = new ArrayList<>(); 
    //创建JSONObject对象 
        JSONObject ob = new JSONObject(str);  
    //获取JSONObject对象的值，该值是一个JSON数组
        JSONArray array = ob.getJSONArray("person");  
        for (int i = 0; i < array.length(); i++) { 
    //获得JSON数组中的每一个JSONObject对象 
            JSONObject o = array.getJSONObject(i);  
    //获得每一个JSONObject对象中的键所对应的值
            String name = o.getString("name");  
            int age = o.getInt("age");  
    //将解析出来的属性值存入Person对象
            Person p = new Person(name, age);  
     //将解析出来的每一个Person对象添加到List中
            l.add(p);  
        }  
        for (Person person : l) {  
            System.out.println(person);  
        }  

    }  
}  

   输出结果如下：

Person[name=zhangsan,age=20]
Person[name=lisi,age=22]
Person[name=wangwu,age=32]

   使用这种方法解析JSON，看注释，没什么好说的，总结一句话就是：遇到{}用JSONObject，遇到[]用JSONArray，这样你就可以说你精通org.json解析JSON了。

使用GSON解析

public class GSONDEMO {  
    public static void main(String[] args) throws JSONException {  
        String str = "{person:[{name:'zhangsan',age:20},{name:'lisi',age:2},{name:'wangwu',age:3}]}";  
    //创建Gson对象
    Gson gson = new Gson();
    //将JSON转化成Person对象集合
        List<Person> ps = gson.fromJson(str, new TypeToken<List<Person>>(){}.getType());
    //输出
        for (Person person : ps) {  
            System.out.println(person);  
        }  

    }  
}  

   输出结果如下：

Person[name=zhangsan,age=20]
Person[name=lisi,age=22]
Person[name=wangwu,age=32]

   可以从上面的例子看出，使用GSON工具来解析JSON比原生方法简单的多，所以一般在开发过程中，推荐使用GSON来解析网络数据JSON。

Gson的常见用法

   1. JSON转化成对象

   这种用法通过创建GSON对象，调用fromJson（）方法来将JSON数据转化成对应对象，用法如下：

// 使用new方法,创建对象
Gson gson = new Gson();

// fromJson 将json字符串转为bean对象
Person person= gson.fromJson(jsonStr, Person.class);

// **反序列化成List时需要使用到TypeToken getType()**
List<Person> retList = gson.fromJson(jsonStr2,new TypeToken<List<Person>>(){}.getType());

   2. 对象转化成JSON

   这种用法通过创建GSON对象，调用toJson（）方法来将对象化转化成对应JSON数据，用法如下：

// 使用new方法,创建对象
Gson gson = new Gson();

// toJson 将bean对象转换为json字符串
String jsonStr = gson.toJson(person, Person.class);

// **序列化List**
String jsonStr2 = gson.toJson(list);