Android网络之数据解析----使用Google Gson解析Json数据

【声明】

欢迎转载，但请保留文章原始出处→_→

生命壹号：http://www.cnblogs.com/smyhvae/

文章来源：http://www.cnblogs.com/smyhvae/p/4063452.html

【正文】

文章回顾： Android网络之数据解析----SAX方式解析XML数据

一、Json数据的介绍                                                                                                                

Json(JavaScript Object Notation) 是一种轻量级的数据交换格式。它基于JS的一个子集。 Json采用完全独立于语言的文本格式，这使得Json成为理想的数据交换语言。易于人阅读和编写，同时也易于机器解析和生成。

Json简单来说就是JS中的对象和数组，所以Json也存在两种结构：对象、数组。

1、Json对象：

含义：是“‘键/值’对”的无序集合

格式：Json对象定义在花括号“{}”内，以Key:value键值对的形式存放数据，多个键值对之间使用逗号“,”隔开，多个数据使用分号“;”隔开。

举例：

{
    “name”:”jackson”,
    “age”:100
}

注：不同的语言中，它被理解为对象（object）、纪录（record）、结构（struct）、字典（dictionary）、哈希表（hash table）、有键列表（keyed list）、或者关联数组 （associative array）。

2、Json数组：

含义：数组是值（value）的有序集合

格式：Json数组定义在方括号“[]”内，以字符串的形式存放数据，值之间使用逗号“,”隔开，多个数据使用分号“；”隔开。

举例：

 {
     “students”:
     [
         {“name”:”jackson”,“age”:100},
         {“name”:”michael”,”age”:51}
     ]
 }

一般情况下，我们用jsp+servlet作服务器端，生成Json的数据；然后在客户端解析Json的数据。

解析JSON数据, 首先需要明确待解析的是JSON Object还是JSON array, 然后需要确定采用哪种解析技术。android平台上一般有以下几种解析技术可供选择:android内置的org.json包（Json），google的开源库GSON，还有一些第三方的开源库如Jackson、FastJson等。我们今天来学习一下使用开源库GSON来解析Json数据。

二、Gson解析Json的基本思路                                                                                                     

首先在服务器端，将服务器端的Person对象通过Gson解析成json的字符串；然后在客户端，通过Gson类将json的字符串还原为Person对象。Gson支持任意复杂Java对象包括没有源代码的对象。

如果我们将Person对象看成一个泛型，那么不管服务器端的Person对象是什么类型，都可以解析出来。

Gson库神奇在哪里呢？如果解析的是Json对象，它主要就是可以将一段Json格式的字符串自动映射成一个对象，从而不需要我们再手动去编写代码进行解析了。比如一段Json格式的数据如下：

{"name":"tom","age":20} 

那我们就可以写一个Person类，并加入name和age这两个字段，只需要简单地调用如下代码就可以将Json数据自动解析成一个Person对象了：

Gson gson = new Gson();

Person person = gson.fromJson(jsonData,Person.class); 

如果解析的是Json对象数组，就要麻烦一点，需要借助Typetoken（官方提供的一种反射机制）将期望解析成的数据类型传入到fromJson()方法中，如下所示：

List<Person> people = gson.fromJson(jsonData, new TypeToken<List<Person>>().getType()); 

基本用法就是这样，我们现在来看一下具体的实现步骤吧。

三、Gson解析Json的步骤（代码实现）                                                                                           

现在通过一个示例程序来讲解一下SAX是怎么解析XML文件的，这个示例程序是运行在Android平台上的，为了模拟真实情况，在tomcat服务器上放置了一个两个静态的XML文件：person.json和perons.json，前者代表对象，后者代表对象数组。即在D:\apache-tomcat-8.0.14\webapps\ROOT目录中新建文件person.json和perons.json.

person.json的内容如下：

{
"id": 1,
"name": "smyhvae",
"address":"成都"
} 

需要特别注意的是，要注意json文件的格式。例如第4行的后面不要有逗号（我就是因为这个低级错误，导致后来调试程序，调了半个多小时才发觉）

persons.json的内容如下：

[{
    "id": 1,
    "name": "smyhvae",
    "address":"成都"
},
{
    "id": 2,
    "name": "许嵩",
    "address":"合肥"
}] 

注：关于tomcat服务器的配置，如果不清楚的话，请参照本人另外一篇博客的第三段：JavaWeb学习（一）----JSP简介及入门（含Tomcat的使用）

因为我电脑的IP地址是192.168.1.112。现在我们在浏览器输入http://192.168.1.112:8080/person.json和http://192.168.1.112:8080/persons.json，显示效果如下：

上方的中文出现了乱码，不过没关系，在稍后解析的时候是不会出现这种情况的。

现在我们需要做的是：通过Android程序去获取并解析这段Json数据。因为是Android程序，所以别忘了赋予其访问网络的权限。

整个工程文件的目录结构如下：

（1）下载并添加Gson的jar包：

下载地址：https://code.google.com/p/google-gson/  网页界面如下：

点击上图中的红框部分，出现如下界面：

上图中的红框部分gson-2.3.jar就是我们需要下载的内容，如果需要帮助文档的话，也可以把箭头处的文件下载下来。然后把gson-2.3.jar拷贝到工程文件的libs目录下，Gson库就自动添加到项目中去了。

（2）【新建工具类HttpUtils】通过URLHttpConnection获取服务器上的XML流：返回的是字符串

 package com.example.android_gson_json.http;

 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.io.InputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;

 //通过HttpURLCnnection获取链接里的数据，放到流里，然后把流里面的数据转换为字符串（借鉴于：老罗老版本1-04）
 public class HttpUtils {

     public HttpUtils() {
         // TODO Auto-generated constructor stub
     }

     public static String getJsonContent(String url_path) {
         try {
             URL url = new URL(url_path);
             HttpURLConnection connection = (HttpURLConnection) url
                     .openConnection();
             connection.setConnectTimeout(3000);
             connection.setRequestMethod("GET");
             connection.setDoInput(true);
             int code = connection.getResponseCode();
             if (code == 200) {
                 return changeInputStream(connection.getInputStream());
             }
         } catch (Exception e) {
             // TODO: handle exception
         }
         return "";
     }

     private static String changeInputStream(InputStream inputStream) {
         // TODO Auto-generated method stub
         String jsonString = "";
         ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
         int len = 0;
         byte[] data = new byte[1024];
         try {
             while ((len = inputStream.read(data)) != -1) {
                 outputStream.write(data, 0, len);
             }
             jsonString = new String(outputStream.toByteArray());
         } catch (IOException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
         }
         return jsonString;
     }
 }

（3）【新建类Person】新建实体类Person，用于存放解析完成后的对象数据

 package com.example.android_gson_json.domain;

 public class Person {
     private int id;
     private String name;
     private String address;
     public Person() {
         super();
     }
     public Person(int id, String name, String address) {
         super();
         this.id = id;
         this.name = name;
         this.address = address;
     }
     public int getId() {
         return id;
     }
     public void setId(int id) {
         this.id = id;
     }
     public String getName() {
         return name;
     }
     public void setName(String name) {
         this.name = name;
     }
     public String getAddress() {
         return address;
     }
     public void setAddress(String address) {
         this.address = address;
     }
     @Override
     public String toString() {
         return "Person [id=" + id + ", name=" + name + ", address=" + address
                 + "]";
     }    

 }

（4）【新建类GsonTools】真正用于解析Json数据

 package com.example.android_gson_json.gson;

 import java.util.ArrayList;
 import java.util.List;

 import com.google.gson.Gson;
 import com.google.gson.reflect.TypeToken;

 public class GsonTools {

     public GsonTools() {
         // TODO Auto-generated constructor stub
     }

     //使用Gson进行解析Person
     public static <T> T getPerson(String jsonString, Class<T> cls) {
         T t = null;
         try {
             Gson gson = new Gson();
             t = gson.fromJson(jsonString, cls);
         } catch (Exception e) {
             // TODO: handle exception
         }
         return t;
     }

     // 使用Gson进行解析 List<Person>
     public static <T> List<T> getPersons(String jsonString, Class<T> cls) {
         List<T> list = new ArrayList<T>();
         try {
             Gson gson = new Gson();
             list = gson.fromJson(jsonString, new TypeToken<List<T>>() {
             }.getType());
         } catch (Exception e) {
         }
         return list;
     }

 }

上面有两个方法，分别用于解析Person对象、List嵌套的Person。如果还有更复杂的数据类型，以后再说吧~O(∩_∩)O~这里只需要注意关键的思路就行。

核心代码：19至20行、32至34行

（5）在MainActicity中实例化：即实例化需要访问的链接path并解析它

布局界面很简单，只有两个按钮控件，这里就不展示布局代码了。点击按钮后，触发点击事件，因为是Android4.0+，所以不能在主线程中访问网络，需要另起一个线程，这里使用Thread类。代码如下：　

 package com.example.android_gson_json;

 import java.util.List;

 import android.app.Activity;
 import android.os.Bundle;
 import android.util.Log;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.widget.Button;

 import com.example.android_gson_json.domain.Person;
 import com.example.android_gson_json.gson.GsonTools;
 import com.example.android_gson_json.http.HttpUtils;

 public class MainActivity extends Activity implements OnClickListener {

     private Button button1, button2;
     private static final String TAG = "MainActivity";

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);

         button1 = (Button) this.findViewById(R.id.button1);
         button2 = (Button) this.findViewById(R.id.button2);
         button1.setOnClickListener(this);
         button2.setOnClickListener(this);
     }

     //点击按钮，开始使用Gson解析Json数据：Person对象、List嵌套的Person对象的集合
     @Override
     public void onClick(final View v) {
         Thread thread = new Thread(new Runnable() {

             @Override
             public void run() {
                 switch (v.getId()) {
                 case R.id.button1:
                     String path = "http://192.168.1.112:8080/person.json";
                     String jsonString = HttpUtils.getJsonContent(path);//从网络获取数据
                     Person person = GsonTools.getPerson(jsonString, Person.class);//解析json数据
                     Log.i(TAG, person.toString());
                     break;
                 case R.id.button2:
                     String path2 = "http://192.168.1.112:8080/persons.json";
                     String jsonString2 = HttpUtils.getJsonContent(path2);//从网络获取数据
                     List<Person> list = GsonTools.getPersons(jsonString2, Person.class);//解析json数据
                     Log.i(TAG, list.toString());
                     break;
                 }

             }
         });
         thread.start();

     }

 }

核心代码：43行、49行

（6）添加网络权限：（这个千万不要忘记了）

<uses-sdk
android:minSdkVersion="14"
android:targetSdkVersion="21" />
<uses-permission android:name="android.permission.INTERNET"/> 

程序运行在模拟器上运行后，界面如下：

分别点击这两个按钮，后台打印的日志如下：

在真机上运行的效果如下：

说明Json数据解析成功，大功告成。

最后声明：

其实，如果是在模拟器上运行，即使不添加网络权限，也是没有关系的；但是，如果在真机上运行（前提是真机和电脑在同一个局域网），不添加网络权限，程序是绝对运行不了的，点击按钮，程序就会死掉，这个地方又耽误了我半个小时，罪过。

【工程文件】

链接：http://pan.baidu.com/s/1mgj0FY4

密码：61u3