前面我們有提到google的Gson技術的介紹[GSON 資料格式詳解],這一講我們來詳細學習一下Android客戶端與服務端之間使用GSON進行JSON資料的解析,關於GSON的技術我們已經在前面兩講中提到過,對GSON不瞭解的讀者可以先去看前面兩講的博文,這一講我們主要學習一下使用GSON方式來完成Android客戶端與服務端之間的JSON資料的互動,具體的實現Demo我們會在上面一講[Android客戶端與服務端之間使用JSON互動資料]的Demo架構上進行修改,讀者在看這一部分的內容的時候可以從上面一講中看起。

    這一講我們主要來實現一下使用Gson完成JSON字串與Java物件之間的轉換,如下圖所示

一. 服務端：作用是使用GSON將服務端的物件轉換成JSON資料格式

我們服務端主要是基於上一講的解析JSON的服務端架構進行修改，讀者可以先看完上一講內容再參考此文。

1. 新增gson的jar庫到lib目錄下
2. 檢視GSON API com.google.gson.Gson類,這個是最經常使用的類

This is the main class for using Gson. Gson is typically used by first constructing a Gson instance and then invoking toJson(Object) or fromJson(String, Class) methods on it. 

3. 程式碼如下

1). JSONTools.java 上進行修改,修改如下所示

    /**
     * @param value ：JSON 名值對中的值,值可以有多種型別
     * @return
     */
    // 使用Gson方式接受物件轉換為JSON資料格式並且作為字串輸出.
    public static String createJsonString(Object value){
        Gson gson = new Gson();
        String str = gson.toJson(value);
        return str;
    } 
 

   這邊做這個修改主要是因為在GSON中將Java物件轉換成JSON字串的時候是不帶key的值,這一點與上一講中講JSON字串的形式是不一樣的

2). 在JsonAction.java 上做對應的呼叫修改

        // 根據不同的引數輸出不同的JSON資料
        String jsonString = "";
        String action_flag = request.getParameter("action_flag");
        if(action_flag.equals("person")) {
            jsonString = JsonTools.createJsonString(service.getPerson());
        } else if(action_flag.equals("persons")){
            jsonString = JsonTools.createJsonString(service.getListPerson());
        } else if(action_flag.equals("listString")) {
            jsonString = JsonTools.createJsonString(service.getListString());
        } else if(action_flag.equals("listMap")){
            jsonString = JsonTools.createJsonString(service.getListMaps());
        }

3). 在瀏覽器位址列中訪問檢視是否返回JSON資料,下面就貼出一個例子，另外幾個讀者可以自己參考根據引數的不同去嘗試。

位址列輸入：http://192.168.0.112:8080/JsonProject/servlet/JsonAction?action_flag=listMap
返回：[{"id":1,"color":"red","name":"Polu"},{"id":7,"color":"green","name":"Zark"}]

說明服務端的使用GSON將物件轉換成JSON資料格式成功了

二. 客戶端：工作是利用GSON將服務端轉換好的JSON字串轉換成指定的物件。

1. 匯入gson庫

這裡有一個簡單的方法構建jar庫，在專案工程上右擊 --> new --> Folder --> 取名libs，然後將gson的jar包複製進去(如果已經存在libs資料夾則直接複製進去)然後選中所有匯入的jar包右擊 --> Build Path --> Add to Build Path 即可。

2. 程式Demo

1). GsonTools.java

package com.android.gsonproject.gson;

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

import com.google.gson.Gson;
import com.google.gson.reflect.*;
public class GsonTools {

    public GsonTools() {
    
    }

    /*
     * 檢視Gson api其中的fromJson(String json, Class<T> classOfT)方法
     * public <T> T fromJson(String json, Class<T> classOfT)
     * 用來描述一個特殊的Json物件,使用反射機制可以將JSON字串中包含的內容賦值給指定的類。這邊的T表示的是通過泛型,也就是可以表示任意的型別。
     * 引數說明：
     * json : 指定物件解析過的JSON字串源,用來轉換回Java物件。
     * classOfT ： 泛型   T 的Class物件。
     */
    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;
    }
    
    /*
     * List 我們使用的Gson中的
     * public <T> T fromJson(String json, Type typeOfT)
     * 這邊我們需要取到List<T>中不同的物件，普通的實現方式就如上一講中org.Json庫來解析JSON的方式一樣(讀者閱讀上一講內容)，
     * 這裡我們通過 Gson中的 TypeToken類是簡便操作：這邊typeOfT的用法是通過反射機制把T裡面的物件的屬性的值映射出來，然後通過將json字串取得的值賦值上去就可以了。
     * getType()的意思就是表示將jsonString的字串解析出來之後封裝到List集合中，然後分別從T裡面取出型別將其複製。
     */
    
    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) {
            // TODO: handle exception
        }
        return list;
    }
    
    public static List<String> getList(String jsonString){
        List<String> list = new ArrayList<String>();
        try {
            Gson gson = new Gson();
            list = gson.fromJson(jsonString, 
                    new TypeToken<List<String>>(){}.getType());
        } catch (Exception e) {
            // TODO: handle exception
        }
        return list;
    }
    
    public static List<Map<String, Object>> getListMaps(String jsonString){
        List<Map<String, Object>> list = new ArrayList<Map<String,Object>>();
        try {
            Gson gson = new Gson();
            list = gson.fromJson(jsonString, 
                    new TypeToken<List<Map<String, Object>>>(){}.getType());
        } catch (Exception e) {
            // TODO: handle exception
        }
        return list;
    }
}

2). MainActivity.java

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.person:
                String path = "http://192.168.0.112:8080/JsonProject/servlet/JsonAction?action_flag=person";
                String jsonString = HttpUtils.getJsonContent(path);
                Log.i(TAG, "The jsonString:" + jsonString);
                Person person = GsonTools.getPerson(jsonString, Person.class);
                Log.i(TAG, "The person:" + person.toString());
                break;

            case R.id.persons:
                String path2 = "http://192.168.0.112:8080/JsonProject/servlet/JsonAction?action_flag=persons";
                String jsonStr2 = HttpUtils.getJsonContent(path2);
                Log.i(TAG, "The jsonString:" + jsonStr2);
                List<Person> list = GsonTools.getPersons(jsonStr2, Person.class);
                Log.i(TAG, "The person:" + list.toString());
                break;
                
            case R.id.liststring:
                String path3 = "http://192.168.0.112:8080/JsonProject/servlet/JsonAction?action_flag=listString";
                String jsonStr3 = HttpUtils.getJsonContent(path3);
                Log.i(TAG, "The jsonString:" + jsonStr3);
                List<String> list3 = GsonTools.getList(jsonStr3);
                Log.i(TAG, "The person:" + list3.toString());
                break;
                
            case R.id.listmap:
                String path4 = "http://192.168.0.112:8080/JsonProject/servlet/JsonAction?action_flag=listMap";
                String jsonStr4 = HttpUtils.getJsonContent(path4);
                Log.i(TAG, "The jsonString:" + jsonStr4);
                List<Map<String, Object>> list4 = GsonTools.getListMaps(jsonStr4);
                Log.i(TAG, "The person:" + list4.toString());
                break;
        }
    }

3. [備註知識]

我們這裡使用的Class<T>是一個什麼概念？

  老羅的說法：由於服務端和客戶端所解析的物件雖然是一致的，但是必須要滿足不管服務端傳遞什麼物件，客戶端只要知道服務端傳遞的物件型別，就可以解析出來的。(他的表述我聽的很混)

  我自己的理解：Android客戶端需要解析服務端的不同型別的物件，所以這邊使用泛型來表示，而無論一個類new出多少個物件，它們對應的class物件是一致的(這點是Java的反射機制決定的)，而Gson也運用了Java的反射機制，所以這邊的 classOfT引數的意思是 T型別的class物件。

四. 編譯執行結果

1. 介面如下所示

2. 第一個按鈕

3. 第二個按鈕

4. 第三個按鈕

5. 第四個按鈕

   由於整個工程都是基於上一講Json資料解析來修改和串講的，讀者在單獨看這一部分的內容會有迷糊，建議讀者可以閱讀上一篇博文，然後在看Gson的資料解析這樣效果會好很多。

在這裡貼出本文的原始碼：

客戶端：http://download.csdn.net/my

服務端：http://download.csdn.net/my