JSON

JSON

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

JSON结构

1. “名称/值”对的集合（A collection of name/value pairs）。
2. 值的有序列表（An ordered list of values）。

具体形式

1. 对象是一个无序的“‘名称/值’对”集合。一个对象以“{”开始，以“}”结束。每个“名称”后跟一个“:”，“‘名称/值’对”之间使用“，”分隔。
2. 数组是值（value）的有序集合。一个数组以“[”开始，“]”结束。值之间使用“，”分隔。
3. 值（value）可以是双引号括起来的字符串（String）、数值(number)、true、false、null、对象(object)或者数组(array)。这些结构可以嵌套。
4. 字符串（string）是由双引号包围的任意数量Unicode字符的集合，使用反斜体转义。一个字符(character)即一个单独的字符串(characeter string)。

例：

[{"CityId":18,"CityName":"西安","ProvinceId":27,"CityOrder":1},{"CityId":53,"CityName":"广州","ProvinceId":27,"CityOrder":1}]```

## 使用安卓原生类
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文本

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

使用JSONStringer来构建json文本

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);
}```

## 使用第三方工具包直接转换
使用google提供的gson工具包
- 创建

GsonBuilder builder = new GsonBuilder();
Gson gson = builder.create();
gson.toJson(obj);

- 使用@expose注释

//不转换没有@Expose注解的字段
builder.excludeFieldsWithoutExposeAnnotation();“`
- 使用TypeTaken,主要解决带有泛型的类

gson.toJson(userMap, new TypeToken<Map<String,User>>(){}.getType());```

- JSON解析

gson.fromJson(sUserString, User.class);
gson.toJson(userMap, new TypeToken