JSON(JavaScript Object Notation) 是一種輕量級的數據交換格式。 易於人閱讀和編寫。同時也易於機器解析和生成。
一.JSON結構:
1.無序的(對象):
Name:Value 格式:
代表一個object。
一個object可以由一個或多個無序的這種組合 組成:vcD4KPHA+eyBuYW1lOnZhbHVlICwgbmFtZTp2YWx1ZSAsIG5hbWU6dmFsdWUgLi4uLiB9PC9wPgo8cD7A/cjn0ru49sjLzu+21M/zo7o8L3A+CjxwPns=”name”:”jscese”,”age”:”24″,”position”:”software engineer”}
2.有序的(array):
array 是 值(value) 的有序集合,格式:
array的值(alue) 可以是是雙引號括起來的字符串(string)、數值(number)、true
、false
、 null
、對象(object)或者數組(array)。這些結構可以嵌套。
例如一個包含string.number.true.object的array:
[“jscese”,24,true,{“position”:”engineer”}]
3.組合:
object中的值(value)可以是array:
{“id”:[“jscese”,9132,”root”]}
array中的的value可以是object:
[“record”,{“jscese”:”host”},{“someone”:”customer1″},{“someone”:”customer2″}]
可以隨意層次的嵌套!
二.Android中使用:
在Android中包含四個與JSON相關的類和一個Exceptions:
JSONArray
JSONObject
JSONStringer
JSONTokener
JSONException
(1)JSONObject:
它對外部(External:應用toString()方法輸出的數值)調用的響應體現為一個標準的字符串(例如:{“JSON”: “Hello, World”},最外被大括號包裹,其中的Key和Value被冒號”:”分隔)。其對於內部(Internal)行為的操作格式略微,例如:初始化一個JSONObject實例,引用內部的put()方法添加數值:new JSONObject().put(“JSON”,
“Hello, World!”),在Key和Value之間是以逗號”,”分隔。
Value的類型包括:Boolean、JSONArray、JSONObject、Number、String或者默認值JSONObject.NULL object。
有兩個不同的取值方法:
get(): 在確定數值存在的條件下使用,否則當無法檢索到相關Key時,將會拋出一個Exception信息。
opt(): 這個方法相對比較靈活,當無法獲取所指定數值時,將會返回一個默認數值,並不會拋出異常。
(2)JSONArray:
它代表一組有序的數值。將其轉換為String輸出(toString)所表現的形式是用方括號包裹,數值以逗號”,”分隔(例如:[value1,value2,value3],大傢可以親自利用簡短的代碼更加直觀的瞭解其格式)。
這個類的內部同樣具有查詢行為,get()和opt()兩種方法都可以通過index索引返回指定的數值,put()方法用來添加或者替換數值。
同樣這個類的value類型可以包括:Boolean、JSONArray、JSONObject、Number、String或者默認值JSONObject.NULL object。
(3)JSONStringer:
根據官方的解釋,這個類可以幫助快速和便捷的創建JSONtext。其最大的優點在於可以減少由於格式的錯誤導致程序異常,引用這個類可以自動嚴格按照JSON語法規則(syntaxrules)創建JSON text。每個JSONStringer實體隻能對應創建一個JSON text。
String myString = new JSONStringer().object() .key("name") .value("jscese") .endObject() .toString();
這樣就創建瞭一個結果是一組標準格式的JSON text:{“name” : “jscese”}。
其中的.object()和.endObject()必須同時使用,是為瞭按照Object標準給數值添加邊界。同樣,針對數組也有一組標準的方法來生成邊界.array()和.endArray()。
(4)JSONTokener:
這個是系統為JSONObject和JSONArray構造器解析JSON source string的類,它可以從source string中提取數值信息。
(5)JSONException:
是JSON.org類拋出的異常信息。
三.代碼樣例:
import java.io.ByteArrayOutputStream; import java.io.InputStream; import java.net.*; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import org.json.JSONArray; import org.json.JSONObject; import android.util.Log; public class JSON { /** * 獲取"數組形式"的JSON數據, * 數據形式:[{"id":1,"name":"小豬"},{"id":2,"name":"小貓"}] * @param path 網頁路徑 * @return 返回List * @throws Exception */ public static List<Map> getJSONArray(String path) throws Exception { String json = null; List<Map> list = new ArrayList<Map>(); Map map = null; URL url = new URL(path); HttpURLConnection conn = (HttpURLConnection) url.openConnection();// 利用HttpURLConnection對象,我們可以從網絡中獲取網頁數據. conn.setConnectTimeout(5 * 1000); // 單位是毫秒,設置超時時間為5秒 conn.setRequestMethod("GET"); // HttpURLConnection是通過HTTP協議請求path路徑的,所以需要設置請求方式,可以不設置,因為默認為GET if (conn.getResponseCode() == 200) {// 判斷請求碼是否是200碼,否則失敗 InputStream is = conn.getInputStream(); // 獲取輸入流 byte[] data = readStream(is); // 把輸入流轉換成字符數組 json = new String(data); // 把字符數組轉換成字符串 //數據形式:[{"id":1,"name":"小豬","age":22},{"id":2,"name":"小貓","age":23}] JSONArray jsonArray = new JSONArray(json); //數據直接為一個數組形式,所以可以直接 用android提供的框架JSONArray讀取JSON數據,轉換成Array for (int i = 0; i < jsonArray.length(); i++) { JSONObject item = jsonArray.getJSONObject(i); //每條記錄又由幾個Object對象組成 int id = item.getInt("id"); // 獲取對象對應的值 String name = item.getString("name"); map = new HashMap(); // 存放到MAP裡面 map.put("id", id + ""); map.put("name", name); list.add(map); } } // ***********測試數據****************** for (Map list2 : list) { String id = list2.get("id"); String name = list2.get("name"); Log.i("abc", "id:" + id + " | name:" + name); } return list; } /** * 獲取"對象形式"的JSON數據, * 數據形式:{"total":2,"success":true,"arrayData":[{"id":1,"name":"小豬"},{"id":2,"name":"小貓"}]} * @param path 網頁路徑 * @return 返回List * @throws Exception */ public static List<Map> getJSONObject(String path) throws Exception { List<Map> list = new ArrayList<Map>(); Map map = null; URL url = new URL(path); HttpURLConnection conn = (HttpURLConnection) url.openConnection();// 利用HttpURLConnection對象,我們可以從網絡中獲取網頁數據. conn.setConnectTimeout(5 * 1000); // 單位是毫秒,設置超時時間為5秒 conn.setRequestMethod("GET"); // HttpURLConnection是通過HTTP協議請求path路徑的,所以需要設置請求方式,可以不設置,因為默認為GET if (conn.getResponseCode() == 200) {// 判斷請求碼是否是200碼,否則失敗 InputStream is = conn.getInputStream(); // 獲取輸入流 byte[] data = readStream(is); // 把輸入流轉換成字符數組 String json = new String(data); // 把字符數組轉換成字符串 //數據形式:{"total":2,"success":true,"arrayData":[{"id":1,"name":"小豬"},{"id":2,"name":"小貓"}]} JSONObject jsonObject=new JSONObject(json); //返回的數據形式是一個Object類型,所以可以直接轉換成一個Object int total=jsonObject.getInt("total"); Boolean success=jsonObject.getBoolean("success"); Log.i("abc", "total:" + total + " | success:" + success); //測試數據 JSONArray jsonArray = jsonObject.getJSONArray("arrayData");//裡面有一個數組數據,可以用getJSONArray獲取數組 for (int i = 0; i < jsonArray.length(); i++) { JSONObject item = jsonArray.getJSONObject(i); // 得到每個對象 int id = item.getInt("id"); // 獲取對象對應的值 String name = item.getString("name"); map = new HashMap(); // 存放到MAP裡面 map.put("id", id + ""); map.put("name", name); list.add(map); } } // ***********測試數據****************** for (Map list2 : list) { String id = list2.get("id"); String name = list2.get("name"); Log.i("abc", "id:" + id + " | name:" + name); } return list; } /** * 獲取類型復雜的JSON數據 *數據形式: {"name":"小豬", "age":23, "content":{"questionsTotal":2, "questions": [ { "question": "what's your name?", "answer": "小豬"},{"question": "what's your age", "answer": "23"}] } } * @param path 網頁路徑 * @return 返回List * @throws Exception */ public static List<Map> getJSON(String path) throws Exception { List<Map> list = new ArrayList<Map>(); Map map = null; URL url = new URL(path); HttpURLConnection conn = (HttpURLConnection) url.openConnection();// 利用HttpURLConnection對象,我們可以從網絡中獲取網頁數據. conn.setConnectTimeout(5 * 1000); // 單位是毫秒,設置超時時間為5秒 conn.setRequestMethod("GET"); // HttpURLConnection是通過HTTP協議請求path路徑的,所以需要設置請求方式,可以不設置,因為默認為GET if (conn.getResponseCode() == 200) {// 判斷請求碼是否是200碼,否則失敗 InputStream is = conn.getInputStream(); // 獲取輸入流 byte[] data = readStream(is); // 把輸入流轉換成字符數組 String json = new String(data); // 把字符數組轉換成字符串 /*數據形式: {"name":"小豬", "age":23, "content":{"questionsTotal":2, "questions": [ { "question": "what's your name?", "answer": "小豬"},{"question": "what's your age", "answer": "23"}] } } */ JSONObject jsonObject=new JSONObject(json); //返回的數據形式是一個Object類型,所以可以直接轉換成一個Object String name=jsonObject.getString("name"); int age=jsonObject.getInt("age"); Log.i("abc", "name:" + name + " | age:" + age); //測試數據 JSONObject contentObject=jsonObject.getJSONObject("content"); //獲取對象中的對象 String questionsTotal=contentObject.getString("questionsTotal"); //獲取對象中的一個值 Log.i("abc", "questionsTotal:" + questionsTotal); //測試數據 JSONArray contentArray=contentObject.getJSONArray("questions"); //獲取對象中的數組 for (int i = 0; i < contentArray.length(); i++) { JSONObject item = contentArray.getJSONObject(i); // 得到每個對象 String question = item.getString("question"); // 獲取對象對應的值 String answer = item.getString("answer"); map = new HashMap(); // 存放到MAP裡面 map.put("question", question); map.put("answer", answer); list.add(map); } } // ***********測試數據****************** for (Map list2 : list) { String question = list2.get("question"); String answer = list2.get("answer"); Log.i("abc", "question:" + question + " | answer:" + answer); } return list; } /** * 把輸入流轉換成字符數組 * @param inputStream 輸入流 * @return 字符數組 * @throws Exception */ public static byte[] readStream(InputStream inputStream) throws Exception { ByteArrayOutputStream bout = new ByteArrayOutputStream(); byte[] buffer = new byte[1024]; int len = 0; while ((len = inputStream.read(buffer)) != -1) { bout.write(buffer, 0, len); } bout.close(); inputStream.close(); return bout.toByteArray(); } }