json詳細介紹（for Java）

南夏發表於2015-12-12
JSONJava

一、JSON介紹


JSON（JavaScript Object Notation），類似於XML，是一種資料交換格式，比如JAVA產生了一個資料想要給JavaScript，則除了利用XML外，還可以利用JSON;

JSON相比XML的優勢是表達起來很簡單；

官網：http://www.json.org/

JSON是AJAX中的X（就是可以取代XML）;          ------出自JSON創始人;


注意：JSON並不是一個文件格式，沒有*.json的文件，一般JSON格式的文件存在txt中，而XML可以是一個標準；


線上校驗JSON結構的網站：http://www.bejson.com/go.html?u=http://www.bejson.com/jsonview2/


二、JSON資料結構


JSON有兩種資料結構：

(1)Map，也稱為物件；｛....｝

(2)Array；[......]

也就是說所有的JSON物件都是要以這些形式表示；


1.Map


簡單的說就是Java中的Map，名稱-值對的形式給出，名稱和值之間用“：”隔開，兩個Map之間用“，”隔開，一般表示形式如下：

{'key1':'value1','key2':'value2'}

以下為官網的圖：



2.Array


就是普通意義上的陣列，一般形式如下：

['arr1','arr2','arr3'];

以下為官網的圖：



圖中的value可以是：





總結：

(1)JSON的資料結構只有兩種；

(2)可以巢狀表示，比如Array中可以巢狀Object等；

(3)記住：Object是以｛｝表示，Array是以[  ]表示；

 

三、JSON與XML互轉示例


前面提到任何的XML都能夠轉換成JSON包；


1.簡單XML


XML格式：

[html] view plaincopy
  1. <person>  
  2.     <name>xiazdong</name>  
  3.     <age>20</age>  
  4. </person>  

JSON格式：

[html] view plaincopy
  1. {  
  2.     "name":"xiazdong",  
  3.     "age":20  
  4. }  



2.複雜XML


XML格式：

[html] view plaincopy
  1. <section>  
  2.     <title>BOOK</title>  
  3.     <signing>  
  4.         <author name="author-1"/>  
  5.         <book title="book1" price="$11"/>  
  6.     </signing>  
  7.     <signing>  
  8.         <author name="author-2"/>  
  9.         <book title="book2" price="$22"/>  
  10.     </signing>  
  11. </section>  

JSON格式：

[html] view plaincopy
  1. "section":{  
  2.         "title":"BOOK",  
  3.         "signing":[  
  4.         {  
  5.     <span style="white-space:pre">  </span> "author":  
  6.             {  
  7.                 "name":"author-1"  
  8.             },  
  9.             "book":  
  10.             {  
  11.                 "title":"book1",  
  12.                 "price":"$11"  
  13.             }  
  14.         },  
  15.         {  
  16.             "author":  
  17.             {  
  18.                 "name":"author-2"  
  19.             },  
  20.             "book":  
  21.             {  
  22.                 "title":"book2",  
  23.                 "price":"$22"  
  24.             }  
  25.         }     
  26. <span style="white-space:pre">  </span> ]}  
  27.     }  

注意：XML中的屬性也是通過JSON的Map表示；



在JAVA中構造和解析JSON我用的是org.json，附件為相應的org.json.jar.

下面是兩個函式，一個是建立JSON，一個是從文字構造JSON並解析之。

建立json

Java程式碼  收藏程式碼
  1. //construct json and output it    
  2. public String jsonTest() throws JSONException{  
  3.     JSONObject json=new JSONObject();  
  4.     JSONArray jsonMembers = new JSONArray();  
  5.     JSONObject member1 = new JSONObject();  
  6.     member1.put("loginname", "zhangfan");  
  7.     member1.put("password", "userpass");  
  8.     member1.put("email","10371443@qq.com");  
  9.     member1.put("sign_date", "2007-06-12");  
  10.     jsonMembers.put(member1);  
  11.   
  12.     JSONObject member2 = new JSONObject();  
  13.     member2.put("loginname", "zf");  
  14.     member2.put("password", "userpass");  
  15.     member2.put("email","8223939@qq.com");  
  16.     member2.put("sign_date", "2008-07-16");  
  17.     jsonMembers.put(member2);  
  18.     json.put("users", jsonMembers);  
  19.   
  20.     return json.toString();  
  21. }  

 解析json 



Java程式碼  收藏程式碼
  1. //construct json from String and resolve it.  
  2. public String jsonTest2() throws JSONException{  
  3.     String jsonString="{\"users\":[{\"loginname\":\"zhangfan\",\"password\":\"userpass\",\"email\":\"10371443@qq.com\"},{\"loginname\":\"zf\",\"password\":\"userpass\",\"email\":\"822393@qq.com\"}]}";  
  4.     JSONObject json= new JSONObject(jsonString);  
  5.     JSONArray jsonArray=json.getJSONArray("users");  
  6.     String loginNames="loginname list:";  
  7.     for(int i=0;i<jsonArray.length();i++){  
  8.         JSONObject user=(JSONObject) jsonArray.get(i);  
  9.         String userName=(String) user.get("loginname");  
  10.         if(i==jsonArray.length()-1){  
  11.             loginNames+=userName;  
  12.         }else{  
  13.             loginNames+=userName+",";  
  14.         }  
  15.     }  
  16.     return loginNames;  
  17. }  

 JAVA中處理JSON還是相當方便的。



四、JSON包


如果我們想要使用JSON包，則可以下載JSON包的原始碼，並將這些程式碼新增進Eclipse工程中，即可呼叫；

如果想要看API文件，可以參見：http://www.JSON.org/java/index.html

JSON包中最常用的兩個類就是JSONObject和JSONArray，分別表示兩種資料結構；


1.JSONObject程式碼例項


[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import weibo4j.org.json.JSONArray;  
  4. import weibo4j.org.json.JSONObject;  
  5.   
  6. public class Test {  
  7.   
  8.     public static void main(String[] args) throws Exception{  
  9.         JSONObject jsonobj = new JSONObject("{'name':'xiazdong','age':20}");  
  10.         String name = jsonobj.getString("name");  
  11.         int age = jsonobj.getInt("age");  
  12.         System.out.println(name+":"+age);     
  13.           
  14.     }  
  15. }  

2.JSONArray程式碼例項


JSONArray array = new JSONArray(String str); //將String轉為JSONArray

int length = array.length();//返回Array的長度；

[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import weibo4j.org.json.JSONArray;  
  4. import weibo4j.org.json.JSONObject;  
  5.   
  6. public class Test {  
  7.   
  8.     public static void main(String[] args) throws Exception{  
  9.               
  10.         JSONArray jsonarray = new JSONArray("[{'name':'xiazdong','age':20},{'name':'xzdong','age':15}]");  
  11.         for(int i=0;i<jsonarray.length();i++){  
  12.             String name = jsonarray.getJSONObject(i).getString("name");  
  13.             int age = jsonarray.getJSONObject(i).getInt("age");  
  14.             System.out.println("name="+name);  
  15.             System.out.println("age="+age);  
  16.         }  
  17.           
  18.     }  
  19. }  

3.巢狀JSONObject和JSONArray程式碼例項


[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import weibo4j.org.json.JSONArray;  
  4. import weibo4j.org.json.JSONObject;  
  5.   
  6. public class Test {  
  7.   
  8.     public static void main(String[] args) throws Exception{  
  9.   
  10.         String str = "{'name':'xiazdong','age':20,'book':['book1','book2']";  
  11.         JSONObject obj = new JSONObject(str);  
  12.         System.out.println(obj.getJSONArray("book").getString(0));  
  13.     }  
  14. }  


4.JSONStringer程式碼示例


JSONStringer可以用來快速構建一個JSON格式的文字，並轉換成String，可以寫入檔案；

JSONStringer是JSONWriter的子類;

JSONStringer一般通過object().key().value().key().value().endObject()進行構造;

object()表明開始一個物件，即新增｛  ;

endObject()表明結束一個物件，即新增 ｝ ;

array()表明開始一個陣列,即新增一個 [ ;

endArray()表明結束一個陣列，即新增一個 ] ;

key()表示新增一個key;

value()表示新增一個value;

[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import weibo4j.org.json.JSONStringer;  
  4.   
  5. public class JsonStringerDemo {  
  6.   
  7.     public static void main(String[] args) throws Exception{  
  8.         JSONStringer stringer = new JSONStringer();  
  9.         String str = stringer.object().key("name").value("xiazdong").key("age").value(20).endObject().toString();  
  10.         System.out.println(str);  
  11.     }  
  12.   
  13. }  

複雜JSON格式寫入

[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import java.io.File;  
  4. import java.io.FileReader;  
  5.   
  6. import weibo4j.org.json.JSONArray;  
  7. import weibo4j.org.json.JSONObject;  
  8. import weibo4j.org.json.JSONStringer;  
  9. import weibo4j.org.json.JSONTokener;  
  10.   
  11. public class JsonStringerDemo {  
  12.   
  13.     public static void main(String[] args) throws Exception{  
  14.           
  15.         JSONStringer js = new JSONStringer();  
  16.         JSONObject obj2 = new JSONObject();  
  17.         JSONObject obj3 = new JSONObject();  
  18.         JSONObject obj4 = new JSONObject();  
  19.         obj4.put("title", "book1").put("price", "$11");  
  20.         obj3.put("book", obj4);  
  21.         obj3.put("author", new JSONObject().put("name", "author-1"));  
  22.           
  23.         JSONObject obj5 = new JSONObject();  
  24.         JSONObject obj6 = new JSONObject();  
  25.         obj6.put("title", "book2").put("price", "$22");  
  26.         obj5.put("book", obj6);  
  27.         obj5.put("author", new JSONObject().put("name", "author-2"));  
  28.           
  29.         JSONArray obj7 = new JSONArray();  
  30.         obj7.put(obj3).put(obj5);  
  31.           
  32.           
  33.           
  34.         obj2.put("title","BOOK");  
  35.         obj2.put("signing", obj7);  
  36.           
  37.         js.object().key("session").value(obj2).endObject();  
  38.           
  39.         System.out.println(js.toString());  
  40.           
  41.         PrintWriter out = new PrintWriter(new FileOutputStream(1.txt));  
  42.         out.println(js.toString());  
  43.           
  44.       
  45.     }  
  46.   
  47. }  


以上程式碼生成了如下JSON格式：

[java] view plaincopy
  1. {"section":{  
  2.         "title":"BOOK",  
  3.         "signing":[  
  4.         {  
  5.             "author":  
  6.             {  
  7.                 "name":"author-1"  
  8.             },  
  9.             "book":  
  10.             {  
  11.                 "title":"book1",  
  12.                 "price":"$11"  
  13.             }  
  14.         },  
  15.         {  
  16.             "author":  
  17.             {  
  18.                 "name":"author-2"  
  19.             },  
  20.             "book":  
  21.             {  
  22.                 "title":"book2",  
  23.                 "price":"$22"  
  24.             }  
  25.         }     
  26.         ]}  
  27.     }  
  28. }  


5.JSONTokener程式碼示例


JSONTokener是用來讀取JSON格式的檔案;

JSONObject obj = new JSONObject( new JSONTokener(java.io.Reader));可以從檔案中讀取一個JSONObject;

JSONArray obj = new JSONArray( new JSONTokener(java.io.Reader)); 可以從檔案中讀取一個JSONArray;

1.txt

[java] view plaincopy
  1. {  
  2.     'name':'xiazdong',  
  3.     'book':['book1','book2']  
  4. }  


[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import java.io.File;  
  4. import java.io.FileReader;  
  5.   
  6. import weibo4j.org.json.JSONObject;  
  7. import weibo4j.org.json.JSONTokener;  
  8.   
  9. public class JsonStringerDemo {  
  10.   
  11.     public static void main(String[] args) throws Exception{  
  12.         JSONObject obj = new JSONObject(new JSONTokener(new FileReader(new File("1.txt"))));  
  13.         System.out.println(obj.getJSONArray("book").getString(1)); //可以讀取book2  
  14.     }  
  15.   
  16. }  

複雜JSON格式的讀取程式碼：

1.txt

[java] view plaincopy
  1. {"section":{  
  2.         "title":"BOOK",  
  3.         "signing":[  
  4.         {  
  5.             "author":  
  6.             {  
  7.                 "name":"author-1"  
  8.             },  
  9.             "book":  
  10.             {  
  11.                 "title":"book1",  
  12.                 "price":"$11"  
  13.             }  
  14.         },  
  15.         {  
  16.             "author":  
  17.             {  
  18.                 "name":"author-2"  
  19.             },  
  20.             "book":  
  21.             {  
  22.                 "title":"book2",  
  23.                 "price":"$22"  
  24.             }  
  25.         }     
  26.         ]}  
  27.     }  
  28. }  

[java] view plaincopy
  1. package com.xiazdong.json;  
  2.   
  3. import java.io.File;  
  4. import java.io.FileReader;  
  5.   
  6. import weibo4j.org.json.JSONObject;  
  7. import weibo4j.org.json.JSONTokener;  
  8.   
  9. public class JsonStringerDemo {  
  10.   
  11.     public static void main(String[] args) throws Exception{  
  12.         JSONObject obj = new JSONObject(new JSONTokener(new FileReader(new File("1.txt"))));  
  13.         System.out.println(obj.getJSONObject("section").getJSONArray("signing").getJSONObject(0).getJSONObject("author").getString("name")); <span style="white-space:pre">     </span>//獲取author-1  
  14.     }  
  15.   
  16. }  


總結：


1在Java中JSON格式的String最好用單引號表示;

2.利用JSONObject+JSONTokener能夠讀取JSON格式檔案物件;

3.利用PrintWriter+JSONStringer可以寫入JSON檔案;

注：由於原本想要試圖用JSONWriter寫入，但是沒有成功；所以只能利用JSONStringer+PrintWriter寫入;







json（1）-使用json所要用到的jar包下載

json是個非常重要的資料結構，在web開發中應用十分廣泛。我覺得每個人都應該好好的去研究一下json的底層實現，基於這樣的認識，金絲燕網推出了一個關於json的系列教程，分析一下json的相關內容，希望大家能有所收穫。首先給大家說一下使用json前的準備工作，需要準備下面的六個jar包：
commons-lang-1.0.4.jar 
commons-collections-2.1.jar 
commons-beanutils-1.8.0.jar 
json-lib-2.4.jar 
ezmorph-1.0.6.jar 
commons-logging-1.1.jar
需要說明幾點：
（1）json-lib最新版本可以從這個地方下載：http://sourceforge.net/projects/json-lib/files/json-lib/
（2）ezmorph是一個簡單的java類庫，用於將一種bean轉換成另外一種bean。其動態bean的實現依賴於commons-beanutils包。ezmorph可以在這個地方下載原始碼：http://sourceforge.net/projects/ezmorph/files/ezmorph/
（3）commons-beanutils是操作Java Bean的類庫，依賴於commons-collections。
（4）commons-collections類庫是各種集合類和集合工具類的封裝。







json（2）-生成JSONObject的方法

生成JSONObject一般有兩種方式，通過javabean或者map型別來生成。如下面的例子：

下面從原始碼層次分析一下JSONObject.fromObject()方法：

此函式可以接受的引數型別為：JSON formatted strings，Maps，DynaBeans and JavaBeans。
【注意】DynaBeans是commons-beanutils定義的動態bean。DynaBean並不是Java中所定義的Bean，而是一種"假"的Bean。因為它並不是通過getXXX和setXXX方法，對XXX屬性進行取值和設值的。
如果object是其他型別的引數呢？比如說數字，邏輯值，非json格式的字串，那麼將生產空的JSONObject物件。

JSONObject的建構函式有兩個：

不過，說實話，第二個建構函式使用情況很少。




json（3）-JSONObject的過濾設定


我們通常對一個json串和java物件進行互轉時，經常會有選擇性的過濾掉一些屬性值。例如下面的類：

如果我想過濾address屬性怎麼辦？

方法一：實現JSONString介面

方法二：設定jsonconfig例項，對包含和需要排除的屬性進行新增或刪除。

方法三：使用propertyFilter例項過濾屬性。





json（4）-optXXX方法的使用


在JSONObject獲取value有多種方法，如果key不存在的話，這些方法無一例外的都會丟擲異常。如果線上環境丟擲異常，就會使出現error頁面，影響使用者體驗，針對這種情況最好是使用optXXX方法。
getString方法會丟擲異常，如下所示：

getInt方法會丟擲異常，如下所示：

getDouble方法會丟擲異常，如下所示：    

getBoolean方法會丟擲異常，如下所示：   

JSONObject有很多optXXX方法，比如optBoolean，optString，optInt。它們的意思是，如果JsonObject有這個屬性，則返回這個屬性，否則返回一個預設值。下面以optString方法為例說明一下其底層實現過程：



相關文章