JSON(JavaScript Object Notation)是一種輕量級的數據交換格式,采用完全獨立於語言的文本格式,為Web應用開發提供了一種理想的數據交換格式。
本文將主要介紹在Android開發中,如何在服務器端創建JSON數據,以及如何在Android客戶端對JSON數據進行解析。
1.JSON數據結構
在JSON中有兩種數據結構:對象和數組。
1.1對象
在JSON中,一個對象以“{”(左括號)開始,“}”(右括號)結束。每個“名稱”后跟一個“:”(冒號),冒號后是該名稱的值,多個“名稱:值”之間使用 “,”(逗號)分隔開來。名稱需要使用雙引號括起來,值如果是字符串則必須用雙引號括起來,如果是數值型則不需要。其結構示意圖如圖1所示。
圖1 JSON對象結構示意圖
如下的代碼是一個簡單的JSON對象示例:
1 { 2 "id":001, 3 "name":"jack", 4 "age":25 5 }
1.2數組
在JSON中,數組是值(value)的有序集合。一個數組以“[”(左中括號)開始,“]”(右中括號)結束。值之間使用 “,”(逗號)分隔開來。其結構示意圖如圖2所示。
圖2 JSON數組結構示意圖
如下的代碼是一個簡單的JSON數組示例:
["北京","上海","廣州"]
1.3值的類型
在JSON的對象和數組結構中,value值不僅可以是數字、字符串等簡單數據類型,還可以是對象、數組等,如圖3所示。
圖3 JSON中值的類型
因此,我們可以使用對象和數組的組合構成復雜的數據結構。如下的代碼使用對象結構定義了一個“students”對象,在“students”對象中包含了一個學生數組,而學生數組中的值又是JSON對象。
1 { 2 "students": 3 [ 4 {"name":"jack","age":23}, 5 {"name":"rose","age":24} 6 ] 7 }
2.在服務器端生成JSON數據
通常,客戶端在請求服務器數據時,服務器可以使用XML文檔、JSON數據或HTML的形式將數據發送給客戶端。
那么如何在服務器端生成JSON數據呢?首先需要完成以下兩個准備工作。
(1)我們需要使用MyEclipse創建了一個Web Project,這里我將該工程命名為了“JsonDemoProject”,用來模擬服務器端的Web服務。
(2)我們還需要在該工程中導入JSON的API數據包json-lib-2.2.2-jdk15.jar。
在JSON的API中,提供了JSONObject類,通過調用JSONObject類的put(Object key, Object value)方法,可以將一個Object對象以鍵值對的形式存入JSONObject對象。通過調用JSONObject類的toString()方法,則可以將JSONObject對象轉化為JSON數據。
如下的代碼創建了一個JsonTools類,並實現了靜態方法createJsonString(),用來生成JSON數據。
1 public class JsonTools { 2 3 /* 4 * Function : 生成JSON數據 5 * Param : key Json數據的鍵值 6 * object 要生成Json數據的內容 7 * Retuen : JSON數據 8 * Author : 博客園-依舊淡然 9 */ 10 public static String createJsonString(String key, Object value) { 11 JSONObject jsonObject = new JSONObject(); //創建一個JSONObject對象 12 jsonObject.put(key, value); //往JSONObject對象中填入內容 13 return jsonObject.toString(); //生成JSON數據並返回 14 } 15 16 }
通過使用該方法,我們可以很方便的將各種數據傳遞進來,並將其轉化成JSON數據。比如,我們可以在JsonService類中,實現一個簡單的獲取Person對象列表的方法,具體如下:
1 /* 2 * Function : 獲取Person對象列表 3 * Author : 博客園-依舊淡然 4 */ 5 public List<Person> getListPerson() { 6 List<Person> list = new ArrayList<Person>(); 7 Person person1 = new Person(001, "jack", 25); 8 Person person2 = new Person(002, "rose", 24); 9 Person person3 = new Person(003, "bob", 26); 10 list.add(person1); 11 list.add(person2); 12 list.add(person3); 13 return list; 14 }
其中,Person對象具有id(int)、name(String)和age(int)三個屬性。
最后,我們可以創建一個繼承自HttpServlet的JsonAction類,並實現其中的doPost()方法,用來響應客戶端對服務器的請求。具體如下:
1 public void doPost(HttpServletRequest request, HttpServletResponse response) 2 throws ServletException, IOException { 3 4 response.setContentType("text/html;charset=utf-8"); 5 request.setCharacterEncoding("utf-8"); 6 response.setCharacterEncoding("utf-8"); 7 PrintWriter out = response.getWriter(); 8 9 List<Person> listPerson = jsonService.getListPerson(); 10 11 String str = null; 12 String action_flag = request.getParameter("action_flag"); //獲取URL參數 13 if(action_flag.equals("persons")) { 14 str = JsonTools.createJsonString("persons", listPerson); 15 } 16 out.println(str); 17 out.flush(); 18 out.close(); 19 }
可以看到,在doPost()方法中,我們通過調用getListPerson()方法獲得了Person對象列表listPerson,並將其傳入JsonTools.createJsonString()方法中,從而獲得了一串JSON數據。
將該工程發布到Tomcat上,使用瀏覽器訪問該Web工程,可以看到如圖4所示的界面,Person對象列表被成功的轉化成了JSON數據。
圖4 生成的JSON數據
3.在客戶端解析JSON數據
通過上面的步驟,我們已經在服務器上生成了JSON數據。要在我們的Android工程中獲取該JSON數據是很容易的,只需要利用Android為我們提供的HttpURLConnection接口訪問圖4所示的URL即可。
那么,獲取到服務器上的JSON數據以后,如何在Android工程中完成對該JSON數據的解析呢?
觀察圖4所示的JSON數據可以看出:
(1)該JSON數據的最外層是JSONObject,JSONObject的鍵是“persons”,值是一個JSONArray。
(2)在JSONArray中又包含了3個JSONObject對象。
(3)而在內嵌的每一個JSONObject對象中,都有3個鍵值對的組合。
分析清楚了JSON數據的構成形式之后,就可以開始着手對其進行解析了。在Android工程中,我們可以創建一個JsonTools類,並實現getListPerson()類方法,用來完成把從服務器獲得的Json數據解析出來,還原成Person對象列表。具體代碼如下所示:
1 /* 2 * Function : 解析JSON數據,還原成Person對象列表 3 * Param : key Json數據的鍵值 4 * jsonString 從服務器獲得的Json數據 5 * Retuen : Person對象列表 6 * Author : 博客園-依舊淡然 7 */ 8 public static List<Person> getListPerson(String key, String jsonString) { 9 List<Person> list = new ArrayList<Person>(); 10 try { 11 JSONObject jsonObject = new JSONObject(jsonString); //創建JSONObject對象 12 JSONArray personArray = jsonObject.getJSONArray(key); //獲取JSONObject對象的值,該值是一個JSON數組 13 for(int i = 0; i < personArray.length(); i++) { 14 JSONObject personObject = personArray.getJSONObject(i); //獲得JSON數組中的每一個JSONObject對象 15 Person person = new Person(); 16 int id = personObject.getInt("id"); //獲得每一個JSONObject對象中的鍵所對應的值 17 String name = personObject.getString("name"); 18 int age = personObject.getInt("age"); 19 person.setId(id); //將解析出來的屬性值存入Person對象 20 person.setName(name); 21 person.setAge(age); 22 list.add(person); //將解析出來的每一個Person對象添加到List中 23 } 24 } catch (JSONException e) { 25 e.printStackTrace(); 26 } 27 return list; 28 }
在本實例中,點擊Button按鈕向服務器發送獲取JSON數據的請求,從服務器獲得JSON數據后,可以使用以上的代碼完成對JSON數據的解析,最后將解析得到的Person對象依次顯示在TextView控件中。程序運行的結果如圖5所示。
圖5 運行結果