Json是一种数据格式，便于数据传输、存储、交换；
Gson是一种组件库，可以把java对象数据转换成json数据格式。
gson.jar的下载地址：http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22gson%22
一、Json数据样式
为了便于理解我们先来看看Json的数据样式：
1. 单个数据对象
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38" }
2. 多组数据
这是一组Json数据，可以看到就像数组一样，一组数据是用[]围起来的，内部{}围起来的就是单个的数据对象
[{ "id": 100, "body": "It is my post1", "number": 0.13, "created_at": "2014-05-20 19:12:38" }, { "id": 101, "body": "It is my post2", "number": 0.14, "created_at": "2014-05-22 19:12:38" }]
3. 嵌套数据
这段数据是用{}围起来的所以是单个数据对象，我们又能发现其内部又是一个数据对象，名字叫foo2.这就是嵌套的Json数据
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38", "foo2": { "id": 200, "name": "haha" } }
二、通过JsonReader解析Json数据
2.1 数据
String jsonData = "[{"username":"name01","userId":001},{"username":"name02","userId":002}]";
一般的Json都是从网上获取的，这里为了简单将Json数据直接用String定义。因为该数据中有各种标点符号，所以要用转译。
2.2 解析
/** * @description 通过JsonReader解析Json对象 * * @web http://codego.net/480737/ */ private void jsonReaderTest() { // 这里的Json放到string中，所以加上了转译 String jsonData = "[{"username":"name01","userId":001},{"username":"name02","userId":002}]"; JsonReader reader = new JsonReader(new StringReader(jsonData)); reader.setLenient(true); // 在宽松模式下解析 try { reader.beginArray(); // 开始解析数组（包含一个或多个Json对象） while (reader.hasNext()) { // 如果有下一个数据就继续解析 reader.beginObject(); // 开始解析一个新的对象 while (reader.hasNext()) { String tagName = reader.nextName(); // 得到下一个属性名 if (tagName.equals("username")) { System.out.println(reader.nextString()); } else if (tagName.equals("userId")) { System.out.println(reader.nextString()); } } reader.endObject(); // 结束对象的解析 } reader.endArray(); // 结束解析当前数组 } catch (IOException e) { // TODO 自动生成的 catch 块 e.printStackTrace(); } }
在JsonReader的构造函数中传入json data，然后开始解析，判断是否还有下一个对象，如果有就开始解析对象名和对象体，直到解析完毕。
三、通过Gson解析单个Json对象
3.1 数据
assets/Json01
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38" }
3.2 载入数据
因为这个数据是定义在本地的，所以要先加载到内存中。方法是通过getAssets()得到AssetManager对象，再通过open(文件名)来获得文件流。这里因为我能确保本地的文件小于1m，所以就没做循环读取，实际中请务必用循环读取的方式。最终得到的数据存放在strData中。
/** * @description 通过assets文件获取json数据，这里写的十分简单，没做循环判断。 * * @return Json数据（String） */ private String getStrFromAssets(String name) { String strData = null; try { InputStream inputStream = getAssets().open(name); byte buf[] = new byte[1024]; inputStream.read(buf); strData = new String(buf); strData = strData.trim(); } catch (IOException e) { // TODO 自动生成的 catch 块 e.printStackTrace(); } System.out.println("strData = " + strData); return strData; }
3.3 建立类
首先，我们要根据数据的格式定义一个类
public class Foo01 { public int id; public String body; public float number; public String created_at; }
这个类的定义方式有讲究：
1>类里面的成员变量名必须跟Json字段里面的name是一模一样的：
"id": 100, ---- public int id;
2>如果Json数据是嵌套定义的，那么这个类中就的成员变量肯定有个类对象，一般这个类包含内部类
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38", "childFoo": { "id": 200, "name": "jack" } }
public class Foo02 { private int id; private String body; private float number; @SerializedName("created_at") private Date createdAt; // 通过注释的方式更换名字，同时保证使用方式不变。 }
3.4 开始解析
/** * @description 将json数据解析为类对象 */ private void GsonTest01() { Foo01 foo = new Gson().fromJson(getStrFromAssets("Json01"), Foo01.class); System.out.println("id = " + foo.id); }
3.5 结果
四、通过Gson将数据转换为Date对象，并且重命名
4.1 数据
本例的数据和上面完全一样，是单个的Json数据
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38" }
我们可以明显的发现，最后的建立日期是一个date对象，但通过一般的解析方式，我们只能把日期数据赋值给string，但以后的操作就很麻烦了。因此，我们用到了gsonBuilder。gsonBuilder可以通过检查json数据的格式，讲符合用户设置格式的数据变为相应的对象，下面就来演示一下。
4.2 解析
解析还是两步，首先定义一个类：
public class Foo02 { private int id; private String body; private float number; @SerializedName("created_at") private Date createdAt; // 通过注释的方式更换名字，同时保证使用方式不变。 public String get_my_date() { return createdAt.toString(); } }
然后，通过gson解析：
/** * @description 当json中有日期对象时，通过定义构建格式生成需要的date对象 * 当json数据命名和java命名产生不一致时，可以通过注释的方式实现更换名字，更方便进行代码处理 */ private void GsonTest02() { GsonBuilder gsonBuilder = new GsonBuilder(); gsonBuilder.setDateFormat("yyyy-MM-dd HH:mm:ss"); // 设置日期的格式，遇到这个格式的数据转为Date对象 Gson gson = gsonBuilder.create(); Foo02 foo = gson.fromJson(getStrFromAssets("Json01"), Foo02.class); System.out.println("date = " + foo.get_my_date()); }
分析：初始化GsonBuilder后，通过setDateFormat来设置什么样的数据会变为date对象，因为原始数据中created_at的日期格式是yyyy-mm-dd HH:mm:ss所以就写了如下的代码：
gsonBuilder.setDateFormat("yyyy-MM-dd HH:mm:ss"); // 设置日期的格式，遇到这个格式的数据转为Date对象
之后再通过gsonBuilder的create来建立gson对象，然后解析即可。
4.3 重命名
有时候json的对象名不符合java命名规则，比如这个created_at就没采用驼峰命名法，但java代码中推荐用驼峰命名，这样就产生了矛盾，虽然可以用别的方式来解决，但我们还希望用代码在不影响解析的情况下，产生符合java命名规则的成员变量。实现也相当简单，用注释。
public class Foo02 { private int id; private String body; private float number; @SerializedName("created_at") private Date createdAt; // 通过注释的方式更换名字，同时保证使用方式不变。 public String get_my_date() { // 可以通过simpleDateFormat指定data对象的输出格式，注意：如果要添加自定义字符串，比如下面的custom，必须在字符串两边加单引号。 SimpleDateFormat dateFormat = new SimpleDateFormat("'custom'_yyyyMMdd_HHmmss"); //return dateFormat.format(created_at); return createdAt.toString(); } }
在建立Date对象时，我们在上面加上了换名设定，这样gson解析时会根据created_at来初始化这个date对象，而我们使用的时候用craetedAt就可以了。这里顺便提一下，如果你要输出date，可以通过simpleDtaeFormat来设置输出的格式，这点在设置照片名或文件名时很有用。当然，如果你没这个需求，你完全可以用toString()方法。
4.4 结果
可以看见，这里的date对象是按照标准的格式进行显示的，说明解析成功！
五、解析嵌套的Json数据
5.1数据
{ "id": 100, "body": "It is my post", "number": 0.13, "created_at": "2014-05-22 19:12:38", "childFoo": { "id": 200, "name": "jack" } }
先来分析下数据，这是一个单个数据，里面嵌套了一个childFoo。那么构建类的时候就需要有两个类，一个类包含id，body,number,created_at,childFoo.另一个类中包含id，name。
5.2 构建类
这里为了简单，把两个类合二为一了。注意下这个内部类其实可以不叫ChildFoo的，只要这个类产生的对象的名字叫做childFoo就行（区分大小写）。
package com.kale.gsontest; /** * @author:Jack Tony * @description : 针对有嵌套的json数据 * @date :2015年1月24日 */ public class Foo03 { public int id; public String body; public float number; public String created_at; public ChildFoo childFoo; public class ChildFoo { public int id; public String name; } }
5.3 解析
/** * @description 解析嵌套是Json数据 * */ private void GsonTest03() { Foo03 foo = new Gson().fromJson(getStrFromAssets("Json02"), Foo03.class); System.out.println("name = " + foo.childFoo.name); }
为了看是否解析成功，这里直接输出类中内部类的成员变量：name
5.4 结果
可以看见，输出了childFoo中的name值：jack
六、将Json序列解析为数组
6.1 数据
[{ "id": 100, "body": "It is my post1", "number": 0.13, "created_at": "2014-05-20 19:12:38" }, { "id": 101, "body": "It is my post2", "number": 0.14, "created_at": "2014-05-22 19:12:38" }]
通常情况下Json数据包含多个对象，如果不包含多个对象的情况比较少见。举个例子：
http://m.weather.com.cn/data/101010100.html
{"weatherinfo":{"city":"北京","city_en":"beijing","date_y":"2014年3月4日","date":"","week":"星期二","fchh":"11","cityid":"101010100","temp1":"8℃~-3℃","temp2":"8℃~-3℃","temp3":"7℃~-3℃","temp4":"8℃~-1℃","temp5":"10℃~1℃","temp6":"10℃~2℃","tempF1":"46.4℉~26.6℉","tempF2":"46.4℉~26.6℉","tempF3":"44.6℉~26.6℉","tempF4":"46.4℉~30.2℉","tempF5":"50℉~33.8℉","tempF6":"50℉~35.6℉","weather1":"晴","weather2":"晴","weather3":"晴","weather4":"晴转多云","weather5":"多云","weather6":"多云","img1":"0","img2":"99","img3":"0","img4":"99","img5":"0","img6":"99","img7":"0","img8":"1","img9":"1","img10":"99","img11":"1","img12":"99","img_single":"0","img_title1":"晴","img_title2":"晴","img_title3":"晴","img_title4":"晴","img_title5":"晴","img_title6":"晴","img_title7":"晴","img_title8":"多云","img_title9":"多云","img_title10":"多云","img_title11":"多云","img_title12":"多云","img_title_single":"晴","wind1":"北风4-5级转微风","wind2":"微风","wind3":"微风","wind4":"微风","wind5":"微风","wind6":"微风","fx1":"北风","fx2":"微风","fl1":"4-5级转小于3级","fl2":"小于3级","fl3":"小于3级","fl4":"小于3级","fl5":"小于3级","fl6":"小于3级","index":"寒冷","index_d":"天气寒冷，建议着厚羽绒服、毛皮大衣加厚毛衣等隆冬服装。年老体弱者尤其要注意保暖防冻。","index48":"冷","index48_d":"天气冷，建议着棉服、羽绒服、皮夹克加羊毛衫等冬季服装。年老体弱者宜着厚棉衣、冬大衣或厚羽绒服。","index_uv":"中等","index48_uv":"中等","index_xc":"较适宜","index_tr":"一般","index_co":"较舒适","st1":"7","st2":"-3","st3":"8","st4":"0","st5":"7","st6":"-1","index_cl":"较不宜","index_ls":"基本适宜","index_ag":"易发"}}
现在我们想把这多个对象解析为一个数组对象，应该怎么做呢？
6.2 建立类
十分简单，包含一个对象中的信息即可。顺便一提，如果你不需要解析那么多结果，你可以仅仅列出你想要解析的变量。
public class Foo01 { public int id; public String body; public float number; public String created_at; }
6.3 解析
/** * @description 解析为数组 * */ private void GsonTest04() { Foo01[] foos = new Gson().fromJson(getStrFromAssets("Json03"), Foo01[].class); System.out.println("name01 = " + foos[0].id); System.out.println("name02 = " + foos[1].id); // 这时候想转成List的话调用如下方法 // List<Foo> foosList = Arrays.asList(foos); }
gson的构造函数提供了解析成数组对象的方法，所以直接像解析单个对象一样使用就行。
6.4 结果
七、将数据解析为list
7.1 数据
这个数据和上面完全一样
[{ "id": 100, "body": "It is my post1", "number": 0.13, "created_at": "2014-05-20 19:12:38" }, { "id": 101, "body": "It is my post2", "number": 0.14, "created_at": "2014-05-22 19:12:38" }]
7.2 建立类
类也和上面的一样，没任何变化
package com.kale.gsontest; public class Foo01 { public int id; public String body; public float number; public String created_at; }
7.3 解析
/** * @description 将json序列变为list对象 * */ private void GsonTest05() { Type listType = new TypeToken<ArrayList<Foo01>>(){}.getType();
ArrayList<Foo01> foos = new Gson().fromJson(getStrFromAssets("Json03"), listType); for (int i = 0; i < foos.size(); i++) { System.out.println("name ["+ i +"] = " + foos.get(i).id); } }
这里不同的一点就是要定义list的类型，其余的没什么可说的。一般我们都会用这种方式将数据放到list中，很少会用到解析成数组。
7.4 结果
源码下载：http://download.csdn.net/detail/shark0017/8393351
参考自：
http://stormzhang.com/android/2014/05/22/android-gson/
http://www.cnblogs.com/jxgxy/p/3677256.html
http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22gson%22