Android學習筆記45：JSON數據解析（GSON方式）

　　JSON（JavaScript Object Notation）是一種輕量級的數據交換格式，采用完全獨立於語言的文本格式，為Web應用開發提供了一種理想的數據交換格式。 

　　在上一篇博文《Android學習筆記44：JSON數據解析》中，我們使用基本的JSON API完成了在服務器端創建JSON數據，以及在Android客戶端對JSON數據進行解析。 

　　其實，要創建和解析JSON數據，也可以使用GSON來完成。GSON是Google提供的用來在Java對象和JSON數據之間進行映射的Java類庫。使用GSON，可以很容易的將一串JSON數據轉換為一個Java對象，或是將一個Java對象轉換為相應的JSON數據。 

 

1.GSON的兩個重要方法

　　在GSON的API中，提供了兩個重要的方法：toJson()和fromJson()方法。其中，toJson()方法用來實現將Java對象轉換為相應的JSON數據，fromJson()方法則用來實現將JSON數據轉換為相應的Java對象。

1.1 toJson()方法

　　toJson()方法用於將Java對象轉換為相應的JSON數據，主要有以下幾種形式：

　　（1）String toJson(JsonElement jsonElement);

　　（2）String toJson(Object src);

　　（3）String toJson(Object src, Type typeOfSrc);

　　其中，方法（1）用於將JsonElement對象（可以是JsonObject、JsonArray等）轉換成JSON數據；方法（2）用於將指定的Object對象序列化成相應的JSON數據；方法（3）用於將指定的Object對象（可以包括泛型類型）序列化成相應的JSON數據。

1.2 fromJson()方法

　　fromJson()方法用於將JSON數據轉換為相應的Java對象，主要有以下幾種形式：

　　（1）<T> T fromJson(JsonElement json, Class<T> classOfT);

　　（2）<T> T fromJson(JsonElement json, Type typeOfT);

　　（3）<T> T fromJson(JsonReader reader, Type typeOfT);

　　（4）<T> T fromJson(Reader reader, Class<T> classOfT);

　　（5）<T> T fromJson(Reader reader, Type typeOfT);

　　（6）<T> T fromJson(String json, Class<T> classOfT);

　　（7）<T> T fromJson(String json, Type typeOfT);

　　以上的方法用於將不同形式的JSON數據解析成Java對象。

 

2.在服務器端生成JSON數據

　　要使用GSON技術在服務器端生成JSON數據，首先需要完成以下兩個准備工作。

　　（1）使用MyEclipse創建了一個Web Project，這里我將該工程命名為了“GsonDemoProject”，用來模擬服務器端的Web服務。 

　　（2）往該工程中導入GSON的API數據包gson-2.2.1.jar。 

　　然后，我們便可以在該工程中創建一個JsonTools工具類，並實現靜態方法createJsonString()，在該方法中通過使用GSON技術來生成JSON數據。該方法的具體實現如下。

　　public class JsonTools {
　　    
　　    /*
　　     * Function　:   生成JSON字符串
　　     * Param 　　:　  value     想要轉換成JSON字符串的Object對象
　　     * Retuen　　:   JSON字符串
　　     * Author　　:   博客園-依舊淡然
　　     */
　　    public static String createJsonString(Object value) {
　　        Gson gson = new Gson();
　　        String string = gson.toJson(value);
　　        return string;
　　    }
　　    
　　}

　　可以看到，這個方法的具體實現非常簡單，首先創建一個Gson對象，然后通過調用Gson對象的toJson()方法，將傳進來的value（任意的Java對象）轉換成JSON字符串即可。

　　通過使用該方法，我們可以很方便的將任意Java對象傳遞進來，並將其轉化成JSON數據。和上一篇博文中一樣，我們可以在JsonService類中，實現一個簡單的獲取Person對象列表的方法，具體如下：

    /*
     * Function :　　獲取Person對象列表
     * Author　　:　　博客園-依舊淡然
     */
    public List<Person> getListPerson() {
        List<Person> list = new ArrayList<Person>();
        Person person1 = new Person(001, "jack", 25);
        Person person2 = new Person(002, "rose", 24);
        Person person3 = new Person(003, "bob", 26);
        list.add(person1);
        list.add(person2);
        list.add(person3);
        return list;
    }

　　在該方法中，我們向List列表中加入了3個Person對象，每個Person對象具有id（int）、name（String）和age（int）三個屬性。

　　最后，我們還需要創建一個繼承自HttpServlet的JsonAction類，並實現其中的doPost()方法，用來響應客戶端對服務器的請求。具體如下：

　　public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        response.setContentType("text/html;charset=utf-8");
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("utf-8");
        PrintWriter out = response.getWriter();
        
        List<Person> listPerson = jsonService.getListPerson();
        
        String str = null;
        String action_flag = request.getParameter("action_flag");
        if(action_flag.equals("persons") {
            str = JsonTools.createJsonString(listPerson);
        }
        out.println(str);
        out.flush();
        out.close();
    }

　　在該方法中，我們通過調用JsonService類中的getListPerson()方法獲得了Person對象列表listPerson，並將其傳入JsonTools.createJsonString()方法中，生成了Person對象列表的JSON數據。將該工程發布到Tomcat上，使用瀏覽器訪問該Web工程，可以看到如圖1所示的界面，Person對象列表被成功的轉化成了JSON數據。

圖1 生成的JSON數據

 

3.在客戶端解析JSON數據

　　在Android工程中，我們可以通過HttpURLConnection接口訪問圖1所示的URL來獲得服務器上的JSON數據。

　　得到JSON數據之后，便可以通過使用前面提到的fromJson()方法，將圖1 所示的JSON數據還原成對應的Person對象列表了。當然了，因為這里使用到了GSON，同樣需要向Android工程中導入gson-2.2.1.jar包。具體的實現方法如下。

    /*
     * Function  :   解析JSON數據，還原成Person對象列表
     * Param     :   jsonString         從服務器獲得的Json數據
     * Retuen　  :   Person對象列表
     * Author    :   博客園-依舊淡然
     */
    public static List<Person> getListPerson(String jsonString) {
        List<Person> list = new ArrayList<Person>();
        Gson gson = new Gson();
        list = gson.fromJson(jsonString, new TypeToken<List<Person>>(){}.getType());
        return list;
    }

　　可以看到，使用GSON解析JSON數據的代碼實現也非常簡單。其中，TypeToken是GSON提供的數據類型轉換器，支持多種數據集合類型轉換，其反射機制可以實現將解析出來的Java對象映射到對應的數據集合中。

　　在本實例中，同樣點擊Button按鈕向服務器發送獲取JSON數據的請求，從服務器獲得JSON數據后，使用以上的代碼完成對JSON數據的解析，最后將解析得到的Person對象依次顯示在TextView控件中。程序運行的結果如圖2所示。

圖2 運行結果